{"thread":{"id":"13788","subject":"git-show documentation","startedAt":"2008-06-04T00:50:13Z","lastAt":"2008-06-04T06:42:26Z","messageCount":3,"participants":["Lea Wiemann","Miklos Vajna","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"78579","messageId":"4845E6C5.8010000@gmail.com","threadId":"13788","inReplyTo":null,"subject":"git-show documentation","fromName":"Lea Wiemann","fromEmail":"lewiemann@gmail.com","sentAt":"2008-06-04T00:50:13Z","receivedAt":"2008-06-04T00:50:13Z","isPatch":false,"sender":{"key":"lewiemann@gmail.com","avatar":null},"body":"Just in case someone wants to fix it, man git-log lists a --header \noption (by including rev-list-options.txt), but it doesn't actually \nsupport this option.  Perhaps rev-list-options.txt should be \ncopy-and-pasted instead of included so local changes can be made to \ngit-log.txt.\n\n-- Lea\n"},{"id":"78582","messageId":"20080604011826.GT29404@genesis.frugalware.org","threadId":"13788","inReplyTo":"4845E6C5.8010000@gmail.com","subject":"Re: git-show documentation","fromName":"Miklos Vajna","fromEmail":"vmiklos@frugalware.org","sentAt":"2008-06-04T01:18:26Z","receivedAt":"2008-06-04T01:18:26Z","isPatch":false,"sender":{"key":"vmiklos@frugalware.org","avatar":"https://gravatar.com/avatar/401c1cbbb3a5d13e650c691a2c71d6fd0b80df1a01bc74d9f1972675dd58f2bd?d=mp&s=160"},"body":"On Wed, Jun 04, 2008 at 02:50:13AM +0200, Lea Wiemann <lewiemann@gmail.com> wrote:\n> Just in case someone wants to fix it, man git-log lists a --header option \n> (by including rev-list-options.txt), but it doesn't actually support this \n> option.  Perhaps rev-list-options.txt should be copy-and-pasted instead of \n> included so local changes can be made to git-log.txt.\n\nPerhaps asciidoc defines would be better than copy&pasting?\n"},{"id":"78588","messageId":"7vr6bdzood.fsf@gitster.siamese.dyndns.org","threadId":"13788","inReplyTo":"4845E6C5.8010000@gmail.com","subject":"Re: git-show documentation","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2008-06-04T06:42:26Z","receivedAt":"2008-06-04T06:42:26Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Lea Wiemann <lewiemann@gmail.com> writes:\n\n> Just in case someone wants to fix it, man git-log lists a --header\n> option (by including rev-list-options.txt), but it doesn't actually\n> support this option.  Perhaps rev-list-options.txt should be\n> copy-and-pasted instead of included so local changes can be made to\n> git-log.txt.\n\nWe already do conditional partial inclusion of that file, so reusing that\nmechanism would be the cleanest.\n\nI've looked at the generated files before and after this patch and the\ndifferences looked reasonable.\n\n-- >8 --\nDocumentation: git-log cannot use rev-list specific options\n\nThe log family and git-rev-list share the same set of options that come\nfrom revision walking machinery, but they both have options unique to\nthem.  Notably, --header, --timestamp, --stdin and --quiet apply only to\nrev-list.  Exclude them from the git-log documentation.\n\nSigned-off-by: Junio C Hamano <gitster@pobox.com>\n---\n\n Documentation/rev-list-options.txt |    6 ++++++\n 1 files changed, 6 insertions(+), 0 deletions(-)\n\ndiff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt\nindex dfcef79..05d5abe 100644\n--- a/Documentation/rev-list-options.txt\n+++ b/Documentation/rev-list-options.txt\n@@ -34,17 +34,21 @@ format, often found in E-mail messages.\n `--date=default` shows timestamps in the original timezone\n (either committer's or author's).\n \n+ifdef::git-rev-list[]\n --header::\n \n \tPrint the contents of the commit in raw-format; each record is\n \tseparated with a NUL character.\n+endif::git-rev-list[]\n \n --parents::\n \n \tPrint the parents of the commit.\n \n+ifdef::git-rev-list[]\n --timestamp::\n \tPrint the raw commit timestamp.\n+endif::git-rev-list[]\n \n --left-right::\n \n@@ -206,6 +210,7 @@ endif::git-rev-list[]\n \tPretend as if all the refs in `$GIT_DIR/refs/` are listed on the\n \tcommand line as '<commit>'.\n \n+ifdef::git-rev-list[]\n --stdin::\n \n \tIn addition to the '<commit>' listed on the command\n@@ -218,6 +223,7 @@ endif::git-rev-list[]\n \ttest the exit status to see if a range of objects is fully\n \tconnected (or not).  It is faster than redirecting stdout\n \tto /dev/null as the output does not have to be formatted.\n+endif::git-rev-list[]\n \n --cherry-pick::\n \n"}]}