docs(diff): name every cause of an unavailable file in the API
- commit
- d00be2e549abd3439c981577a52cf22b3a08d582
- author
- brice · · 2026-10-20 08:27 UTC
- committer
- brice · · 2026-10-20 09:16 UTC
- parent
- 88a1a56
- signature
- GPG Verified
CD88F9E564E0102646FB6077A1A07C7C7C3E349D· arch-gpg Verified for the committer email
1 file · +1 -1
M docs/merge-requests.md +1 -1
| @@ -69,7 +69,7 @@ The merge request, commit and compare pages list every changed file. Generated f | |||
| 69 | 69 | ||
| 70 | 70 | A commit page reads the hunks of its first 300 files with the page; the other files are listed collapsed and load one at a time. A file that cannot be shown in the browser, over 8 MiB of text or over 50,000 changed lines when loaded alone, has no "load diff": the page links to its raw blob instead, and its lines take no comment. | |
| 71 | 71 | ||
| 72 | - | The API and `mr show --diff --json` keep their limits (300 files, 2,000 changed lines per file, 20,000 in total, 8 MiB). A file read without its hunks has `truncated` set and `omitted` giving the reason: `large`, `budget` (the earlier files used the limits) or `unavailable` (too large to read even alone). | |
| 72 | + | The API and `mr show --diff --json` keep their limits (300 files, 2,000 changed lines per file, 20,000 in total, 8 MiB). A file read without its hunks has `truncated` set and `omitted` giving the reason: `large`, `budget` (the earlier files used the limits) or `unavailable` (over 8 MiB of text, or a line over 64 KiB, even alone). Files past the 300th are not listed and `diff_truncated` is set. | |
| 73 | 73 | ||
| 74 | 74 | ## Notes | |
| 75 | 75 | ||
| @@ -69,7 +69,7 @@ The merge request, commit and compare pages list every changed file. Generated f | |||||
| 69 | 69 | ||||
| 70 | A commit page reads the hunks of its first 300 files with the page; the other files are listed collapsed and load one at a time. A file that cannot be shown in the browser, over 8 MiB of text or over 50,000 changed lines when loaded alone, has no "load diff": the page links to its raw blob instead, and its lines take no comment. | 70 | A commit page reads the hunks of its first 300 files with the page; the other files are listed collapsed and load one at a time. A file that cannot be shown in the browser, over 8 MiB of text or over 50,000 changed lines when loaded alone, has no "load diff": the page links to its raw blob instead, and its lines take no comment. | ||
| 71 | 71 | ||||
| 72 | - | The API and `mr show --diff --json` keep their limits (300 files, 2,000 changed lines per file, 20,000 in total, 8 MiB). A file read without its hunks has `truncated` set and `omitted` giving the reason: `large`, `budget` (the earlier files used the limits) or `unavailable` (too large to read even alone). | 72 | + | The API and `mr show --diff --json` keep their limits (300 files, 2,000 changed lines per file, 20,000 in total, 8 MiB). A file read without its hunks has `truncated` set and `omitted` giving the reason: `large`, `budget` (the earlier files used the limits) or `unavailable` (over 8 MiB of text, or a line over 64 KiB, even alone). Files past the 300th are not listed and `diff_truncated` is set. |
| 73 | 73 | ||||
| 74 | ## Notes | 74 | ## Notes | ||
| 75 | 75 | ||||