git-show documentation
Just in case someone wants to fix it, man git-log lists a --header option (by including rev-list-options.txt), but it doesn't actually support this option. Perhaps rev-list-options.txt should be copy-and-pasted instead of included so local changes can be made to git-log.txt.
-- Lea
Quoted 4 lines · Lea Wiemann
Just in case someone wants to fix it, man git-log lists a --header option (by including rev-list-options.txt), but it doesn't actually support this option. Perhaps rev-list-options.txt should be copy-and-pasted instead of included so local changes can be made to git-log.txt.
Perhaps asciidoc defines would be better than copy&pasting?
Quoted 5 lines · Lea Wiemann
Just in case someone wants to fix it, man git-log lists a --header option (by including rev-list-options.txt), but it doesn't actually support this option. Perhaps rev-list-options.txt should be copy-and-pasted instead of included so local changes can be made to git-log.txt.
We already do conditional partial inclusion of that file, so reusing that mechanism would be the cleanest.
I've looked at the generated files before and after this patch and the differences looked reasonable.
-- >8 --
Documentation: git-log cannot use rev-list specific options
The log family and git-rev-list share the same set of options that come from revision walking machinery, but they both have options unique to them. Notably, --header, --timestamp, --stdin and --quiet apply only to rev-list. Exclude them from the git-log documentation.
---
Documentation/rev-list-options.txt | 6 ++++++ 1 files changed, 6 insertions(+), 0 deletions(-)
Documentation/rev-list-options.txt +6 -0
@@ -34,17 +34,21 @@ format, often found in E-mail messages. `--date=default` shows timestamps in the original timezone (either committer's or author's). +ifdef::git-rev-list[] --header:: Print the contents of the commit in raw-format; each record is separated with a NUL character. +endif::git-rev-list[] --parents:: Print the parents of the commit. +ifdef::git-rev-list[] --timestamp:: Print the raw commit timestamp. +endif::git-rev-list[] --left-right::
@@ -206,6 +210,7 @@ endif::git-rev-list[] Pretend as if all the refs in `$GIT_DIR/refs/` are listed on the command line as '<commit>'. +ifdef::git-rev-list[] --stdin:: In addition to the '<commit>' listed on the command
@@ -218,6 +223,7 @@ endif::git-rev-list[] test the exit status to see if a range of objects is fully connected (or not). It is faster than redirecting stdout to /dev/null as the output does not have to be formatted. +endif::git-rev-list[] --cherry-pick::