Skip to content

Commit 7f7e6a4

Browse files
committed
Autogenerated HTML docs for v2.47.1-397-g23692e
1 parent 8a42471 commit 7f7e6a4

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

59 files changed

+2206
-2113
lines changed

DecisionMaking.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>Decision-Making Process in the Git Project</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

MyFirstContribution.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>My First Contribution to the Git Project</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

MyFirstObjectWalk.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>My First Object Walk</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

RelNotes/2.48.0.txt

Lines changed: 22 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,13 @@ UI, Workflows & Features
1919
* Documentation for "git bundle" saw improvements to more prominently
2020
call out the use of '--all' when creating bundles.
2121

22+
* Drop support for older libcURL and Perl.
23+
2224

2325
Performance, Internal Implementation, Development Support etc.
2426
--------------------------------------------------------------
2527

2628
* Document "amlog" notes.
27-
(merge ddfb5bcfc6 tb/notes-amlog-doc later to maint).
2829

2930
* The way AsciiDoc is used for SYNOPSIS part of the manual pages has
3031
been revamped. The sources, at least for the simple cases, got
@@ -94,13 +95,24 @@ Performance, Internal Implementation, Development Support etc.
9495
* We now ensure "index-pack" is used with the "--promisor" option
9596
only during a "git fetch".
9697

98+
* The migration procedure between two ref backends has been optimized.
99+
100+
* "git fsck" learned to issue warnings on "curiously formatted" ref
101+
contents that have always been taken valid but something Git
102+
wouldn't have written itself (e.g., missing terminating end-of-line
103+
after the full object name).
104+
105+
* Work around Coverity warning that would not trigger in practice.
106+
107+
* Built-in Git subcommands are supplied the repository object to work
108+
with; they learned to do the same when they invoke sub-subcommands.
109+
97110

98111
Fixes since v2.47
99112
-----------------
100113

101114
* Doc update to clarify how periodical maintenance are scheduled,
102115
spread across time to avoid thundering hurds.
103-
(merge 3d6ab4177d sk/doc-maintenance-schedule later to maint).
104116

105117
* Use after free and double freeing at the end in "git log -L... -p"
106118
had been identified and fixed.
@@ -179,17 +191,15 @@ Fixes since v2.47
179191
been corrected.
180192
(merge b886db48c6 kn/ref-transaction-hook-with-reflog later to maint).
181193

194+
* Give a bit of advice/hint message when "git maintenance" stops finding a
195+
lock file left by another instance that still is potentially running.
196+
(merge ba874d1dac ps/gc-stale-lock-warning later to maint).
197+
198+
* Use the right helper program to measure file size in performance tests.
199+
(merge 3f97f1bce6 tb/use-test-file-size-more later to maint).
200+
182201
* Other code cleanup, docfix, build fix, etc.
183-
(merge 1164e270b5 jk/output-prefix-cleanup later to maint).
184-
(merge f36b8cbaef jh/config-unset-doc-fix later to maint).
185-
(merge 4154ed4108 js/doc-platform-support-link-fix later to maint).
186202
(merge 77af53f56f aa/t7300-modernize later to maint).
187-
(merge 8ead1bba3e jc/doc-refspec-syntax later to maint).
188-
(merge 432f666aa6 kn/loose-object-layer-wo-global-hash later to maint).
189-
(merge c4b8fb6ef2 kh/merge-tree-doc later to maint).
190-
(merge b8139c8f4e kh/checkout-ignore-other-docfix later to maint).
191-
(merge 6dab49b9fb tc/bundle-uri-leakfix later to maint).
192-
(merge f1ed39987b xx/protocol-v2-doc-markup-fix later to maint).
193-
(merge 41869f7447 ak/typofixes later to maint).
194203
(merge dcd590a39d bf/t-readme-mention-reftable later to maint).
195204
(merge 68e3c69efa kh/trailer-in-glossary later to maint).
205+
(merge 91f88f76e6 tb/boundary-traversal-fix later to maint).

ReviewingGuidelines.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>Reviewing Patches in the Git Project</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

SubmittingPatches.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>Submitting Patches</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

ToolsForGit.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,7 @@
442442
<div id="header">
443443
<h1>Tools for developing Git</h1>
444444
<div class="details">
445-
<span id="revdate">2024-11-27</span>
445+
<span id="revdate">2024-12-04</span>
446446
</div>
447447
</div>
448448
<div id="content">

diff-format.txt

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,25 @@
11
Raw output format
22
-----------------
33

4-
The raw output format from "git-diff-index", "git-diff-tree",
5-
"git-diff-files" and "git diff --raw" are very similar.
4+
The raw output format from `git-diff-index`, `git-diff-tree`,
5+
`git-diff-files` and `git diff --raw` are very similar.
66

77
These commands all compare two sets of things; what is
88
compared differs:
99

10-
git-diff-index <tree-ish>::
11-
compares the <tree-ish> and the files on the filesystem.
10+
`git-diff-index <tree-ish>`::
11+
compares the _<tree-ish>_ and the files on the filesystem.
1212

13-
git-diff-index --cached <tree-ish>::
14-
compares the <tree-ish> and the index.
13+
`git-diff-index --cached <tree-ish>`::
14+
compares the _<tree-ish>_ and the index.
1515

16-
git-diff-tree [-r] <tree-ish-1> <tree-ish-2> [<pattern>...]::
16+
`git-diff-tree [-r] <tree-ish-1> <tree-ish-2> [<pattern>...]`::
1717
compares the trees named by the two arguments.
1818

19-
git-diff-files [<pattern>...]::
19+
`git-diff-files [<pattern>...]`::
2020
compares the index and the files on the filesystem.
2121

22-
The "git-diff-tree" command begins its output by printing the hash of
22+
The `git-diff-tree` command begins its output by printing the hash of
2323
what is being compared. After that, all the commands print one output
2424
line per changed file.
2525

@@ -54,19 +54,19 @@ That is, from the left to the right:
5454

5555
Possible status letters are:
5656

57-
- A: addition of a file
58-
- C: copy of a file into a new one
59-
- D: deletion of a file
60-
- M: modification of the contents or mode of a file
61-
- R: renaming of a file
62-
- T: change in the type of the file (regular file, symbolic link or submodule)
63-
- U: file is unmerged (you must complete the merge before it can
57+
- `A`: addition of a file
58+
- `C`: copy of a file into a new one
59+
- `D`: deletion of a file
60+
- `M`: modification of the contents or mode of a file
61+
- `R`: renaming of a file
62+
- `T`: change in the type of the file (regular file, symbolic link or submodule)
63+
- `U`: file is unmerged (you must complete the merge before it can
6464
be committed)
65-
- X: "unknown" change type (most probably a bug, please report it)
65+
- `X`: "unknown" change type (most probably a bug, please report it)
6666

67-
Status letters C and R are always followed by a score (denoting the
67+
Status letters `C` and `R` are always followed by a score (denoting the
6868
percentage of similarity between the source and target of the move or
69-
copy). Status letter M may be followed by a score (denoting the
69+
copy). Status letter `M` may be followed by a score (denoting the
7070
percentage of dissimilarity) for file rewrites.
7171

7272
The sha1 for "dst" is shown as all 0's if a file on the filesystem
@@ -86,7 +86,7 @@ verbatim and the line is terminated by a NUL byte.
8686
diff format for merges
8787
----------------------
8888

89-
"git-diff-tree", "git-diff-files" and "git-diff --raw"
89+
`git-diff-tree`, `git-diff-files` and `git-diff --raw`
9090
can take `-c` or `--cc` option
9191
to generate diff output also for merge commits. The output differs
9292
from the format described above in the following way:
@@ -128,7 +128,7 @@ other diff formats
128128
------------------
129129

130130
The `--summary` option describes newly added, deleted, renamed and
131-
copied files. The `--stat` option adds diffstat(1) graph to the
131+
copied files. The `--stat` option adds `diffstat`(1) graph to the
132132
output. These options can be combined with other options, such as
133133
`-p`, and are meant for human consumption.
134134

diff-generate-patch.txt

Lines changed: 23 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ You can customize the creation of patch text via the
1414
`GIT_EXTERNAL_DIFF` and the `GIT_DIFF_OPTS` environment variables
1515
(see linkgit:git[1]), and the `diff` attribute (see linkgit:gitattributes[5]).
1616

17-
What the -p option produces is slightly different from the traditional
17+
What the `-p` option produces is slightly different from the traditional
1818
diff format:
1919

2020
1. It is preceded by a "git diff" header that looks like this:
@@ -30,20 +30,21 @@ name of the source file of the rename/copy and the name of
3030
the file that the rename/copy produces, respectively.
3131

3232
2. It is followed by one or more extended header lines:
33-
34-
old mode <mode>
35-
new mode <mode>
36-
deleted file mode <mode>
37-
new file mode <mode>
38-
copy from <path>
39-
copy to <path>
40-
rename from <path>
41-
rename to <path>
42-
similarity index <number>
43-
dissimilarity index <number>
44-
index <hash>..<hash> <mode>
4533
+
46-
File modes are printed as 6-digit octal numbers including the file type
34+
[synopsis]
35+
old mode <mode>
36+
new mode <mode>
37+
deleted file mode <mode>
38+
new file mode <mode>
39+
copy from <path>
40+
copy to <path>
41+
rename from <path>
42+
rename to <path>
43+
similarity index <number>
44+
dissimilarity index <number>
45+
index <hash>..<hash> <mode>
46+
+
47+
File modes _<mode>_ are printed as 6-digit octal numbers including the file type
4748
and file permission bits.
4849
+
4950
Path names in extended headers do not include the `a/` and `b/` prefixes.
@@ -56,7 +57,7 @@ files, while 100% dissimilarity means that no line from the old
5657
file made it into the new one.
5758
+
5859
The index line includes the blob object names before and after the change.
59-
The <mode> is included if the file mode does not change; otherwise,
60+
The _<mode>_ is included if the file mode does not change; otherwise,
6061
separate lines indicate the old and the new mode.
6162

6263
3. Pathnames with "unusual" characters are quoted as explained for
@@ -134,17 +135,18 @@ or like this (when the `--cc` option is used):
134135

135136
2. It is followed by one or more extended header lines
136137
(this example shows a merge with two parents):
137-
138-
index <hash>,<hash>..<hash>
139-
mode <mode>,<mode>..<mode>
140-
new file mode <mode>
141-
deleted file mode <mode>,<mode>
138+
+
139+
[synopsis]
140+
index <hash>,<hash>..<hash>
141+
mode <mode>,<mode>`..`<mode>
142+
new file mode <mode>
143+
deleted file mode <mode>,<mode>
142144
+
143145
The `mode <mode>,<mode>..<mode>` line appears only if at least one of
144146
the <mode> is different from the rest. Extended headers with
145147
information about detected content movement (renames and
146148
copying detection) are designed to work with the diff of two
147-
<tree-ish> and are not used by combined diff format.
149+
_<tree-ish>_ and are not used by combined diff format.
148150

149151
3. It is followed by a two-line from-file/to-file header:
150152

0 commit comments

Comments
 (0)