format-patch: clean up tests and documentation
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v2 Latest13 patches 3 repliesIn review
- v10 of 13 patches 2 repliesSuperseded
Changes in v2 from the cover letter
* Squash Junio's patch into the correct patch ;)
* Remove weak justification (better error messages) in 8/13
Patches in v2 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/13 | t4014: drop unnecessary blank lines from test casest/ | +0 | 0 replies | |
| 2/13 | t4014: s/expected/expect/t/ | +53 | 0 replies | |
| 3/13 | t4014: move closing sq onto its own linet/ | +4 | 0 replies | |
| 4/13 | t4014: use sq for test case namest/ | +5 | 0 replies | |
| 5/13 | t4014: remove spaces after redirect operatorst/ | +31 | 0 replies | |
| 6/13 | t4014: use indentable here-docst/ | +184 | 0 replies | |
| 7/13 | t4014: drop redirections to /dev/nullt/ | +6 | 0 replies | |
| 8/13 | t4014: let sed open its own filest/ | +14 | 0 replies | |
| 9/13 | t4014: use test_line_count() where possiblet/ | +19 | 0 replies | |
| 10/13 | t4014: remove confusing pipe in check_threading()t/ | +2 | 0 replies | |
| 11/13 | t4014: stop losing return codes of git commandst/ | +120 | 0 replies | |
| 12/13 | Doc: add more detail for git-format-patchDocumentation/ | +13 | 0 replies | |
| 13/13 | config/format.txt: specify default value of format.coverLetterDocumentation/ | +1 | 0 replies |
Reviews trailers per patch
No Reviewed-by, Acked-by or Tested-by trailers for v2 yet.
Cover letter [PATCH v2 00/13] format-patch: clean up tests and documentation
In this reroll, I squashed Junio's suggestion into the correct patch. Also, I took Eric's suggestion and removed the weak justification (i.e. better error messages) from the sed patch since it doesn't really contribute.
As one of the older parts of the Git, the tests and documentation for format-patch have been needing cleanup for a while. Let's do that in this patchset!
This patchset is based on v3 of "format-patch: learn --infer-cover-subject option (also t4014 cleanup)"[1].
Changes since v1:
* Squash Junio's patch into the correct patch ;)
* Remove weak justification (better error messages) in 8/13
Changes since v3 of "format-patch: learn --infer-cover-subject option (also t4014 cleanup)":
* Squash in Junio's and Hannes' suggestions
* Add 't4014: let sed open its own files'
[1]: https://public-inbox.org/git/[email protected]/T/#m19570aff4828dfbd65d57cacf231c2938af1dc9f
Denton Liu (13):
t4014: drop unnecessary blank lines from test cases
t4014: s/expected/expect/
t4014: move closing sq onto its own line
t4014: use sq for test case names
t4014: remove spaces after redirect operators
t4014: use indentable here-docs
t4014: drop redirections to /dev/null
t4014: let sed open its own files
t4014: use test_line_count() where possible
t4014: remove confusing pipe in check_threading()
t4014: stop losing return codes of git commands
Doc: add more detail for git-format-patch config/format.txt: specify default value of format.coverLetter
Documentation/config/format.txt | 1 + Documentation/git-format-patch.txt | 23 +- t/t4014-format-patch.sh | 814 ++++++++++++++--------------- 3 files changed, 421 insertions(+), 417 deletions(-)
Range-diff against v1:
1: fb000bfca2 = 1: fb000bfca2 t4014: drop unnecessary blank lines from test cases 2: 0a5ce9b95f = 2: 0a5ce9b95f t4014: s/expected/expect/ 3: 5c49703aa4 = 3: 5c49703aa4 t4014: move closing sq onto its own line 4: 02a11147fd = 4: 02a11147fd t4014: use sq for test case names 5: 8d9791c061 = 5: 8d9791c061 t4014: remove spaces after redirect operators 6: 90ad0fcf70 = 6: 90ad0fcf70 t4014: use indentable here-docs 7: 804b3163f8 = 7: 804b3163f8 t4014: drop redirections to /dev/null 8: 7d9a24a979 ! 8: 967e624bb4 t4014: let sed open its own files
@@ Commit message
t4014: let sed open its own files
In some cases, we were using a redirection operator to feed input into
- sed. However, since sed is capable of opening its own files and provides
- better error messages on IO failure, make sed open its own files instead
- of redirecting input into it.
+ sed. However, since sed is capable of opening its own files, make sed
+ open its own files instead of redirecting input into it.
9: d068d42098 = 9: 9a42ec2b7e t4014: use test_line_count() where possible 10: 6a9409cee0 = 10: 8acc90f74d t4014: remove confusing pipe in check_threading() 11: c580ce447b = 11: bc7355485f t4014: stop losing return codes of git commands 12: a97f861e6a ! 12: fd343b99c5 Doc: add more detail for git-format-patch
@@ Commit message
In git-format-patch.txt, we were missing some key user information. First of all, document the special value of --base=auto.
- Next, while we're at it, surround option arguments with <>.
+ Next, while we're at it, surround option arguments with <> and change
+ existing names such as "Message-Id" to "message id", which conforms with
+ how existing documentation is written.
Finally, document the format.outputDirectory config and change format.coverletter to use camel case.
@@ Documentation/git-format-patch.txt: SYNOPSIS
[-n | --numbered | -N | --no-numbered]
[--start-number <n>] [--numbered-files]
- [--in-reply-to=Message-Id] [--suffix=.<sfx>]
-+ [--in-reply-to=<Message-Id>] [--suffix=.<sfx>]
++ [--in-reply-to=<message id>] [--suffix=.<sfx>]
[--ignore-if-in-upstream]
- [--rfc] [--subject-prefix=Subject-Prefix]
-+ [--rfc] [--subject-prefix=<Subject-Prefix>]
++ [--rfc] [--subject-prefix=<subject prefix>]
[(--reroll-count|-v) <n>]
[--to=<email>] [--cc=<email>]
[--[no-]cover-letter] [--quiet]
@@ Documentation/git-format-patch.txt: Beware that the default for 'git send-email'
will want to ensure that threading is disabled for git send-email.
---in-reply-to=Message-Id::
-+--in-reply-to=<Message-Id>::
++--in-reply-to=<message id>::
Make the first mail (or all the mails with --no-thread) appear as a
- reply to the given Message-Id, which avoids breaking threads to
+- reply to the given Message-Id, which avoids breaking threads to
++ reply to the given <message id>, which avoids breaking threads to
provide a new patch series.
+
+ --ignore-if-in-upstream::
+@@ Documentation/git-format-patch.txt: will want to ensure that threading is disabled for git send-email.
+ patches being generated, and any patch that matches is
+ ignored.
+
+---subject-prefix=<Subject-Prefix>::
++--subject-prefix=<subject prefix>::
+ Instead of the standard '[PATCH]' prefix in the subject
+- line, instead use '[<Subject-Prefix>]'. This
++ line, instead use '[<subject prefix>]'. This
+ allows for useful naming of a patch series, and can be
+ combined with the --numbered option.
+
@@ Documentation/git-format-patch.txt: you can use --suffix=-patch to get 0001-description-of-my-change-patch.
--base=<commit>::
Record the base tree information to identify the state the
13: 7c8522abf2 < -: ---------- config/format.txt: specify default value of format.coverLetter -: ---------- > 13: 4e429e1989 config/format.txt: specify default value of format.coverLetter
Signature · 1 line
2.23.0.248.g3a9dd8fb08