60
the input is changed. They also make it possible to
61
automatically add some trailers.
62
63
-By default, a `<key>=<value>` or `<key>:<value>` argument given
64
-using `--trailer` will be appended after the existing trailers only if
65
-the last trailer has a different (_<key>_, _<value>_) pair (or if there
66
-is no existing trailer). The _<key>_ and _<value>_ parts will be trimmed
63
+Let's consider new trailers added with `--trailer`.
64
+By default, the new trailer will appear at the end of the trailer block.
65
+Also by default, this new trailer will only be added
66
+if the last trailer is different to it.
67
+A trailer block will be created with only that trailer if a trailer
68
+block does not already exist. Recall that a trailer block needs to be
69
+preceded by a blank line, so a blank line will be inserted before the
70
+new trailer block in that case.
71
+
72
+This is how the new trailer is added: a `<key>=<value>` or
73
+`<key>:<value>` argument given using `--trailer` will be appended after
74
+the existing trailers. The _<key>_ and _<value>_ parts will be trimmed
75
to remove starting and trailing whitespace, and the resulting trimmed
76
_<key>_ and _<value>_ will appear in the output like this:
77
82
This means that the trimmed _<key>_ and _<value>_ will be separated by
83
"`:`{nbsp}" (one colon followed by one space).
84
77
-By default the new trailer will appear at the end of the trailer block.
78
-A trailer block will be created with only that trailer if a trailer
79
-block does not already exist. Recall that a trailer block needs to be
80
-preceded by a blank line, so a blank line will be inserted before the
81
-new trailer block in that case.
82
-
85
Existing trailers are extracted from the input by looking for the
86
trailer block. A trailer block is a group of one or more lines that (i)
87
is all trailers, or (ii) contains at least one Git-generated or