{"thread":{"id":"47708","subject":"[PATCH] doc: mention 'git show' defaults to HEAD","startedAt":"2018-01-28T19:16:21Z","lastAt":"2018-01-30T21:11:43Z","messageCount":2,"participants":["Todd Zullinger","Junio C Hamano"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"337630","messageId":"20180128191607.31199-1-tmz@pobox.com","threadId":"47708","inReplyTo":null,"subject":"[PATCH] doc: mention 'git show' defaults to HEAD","fromName":"Todd Zullinger","fromEmail":"tmz@pobox.com","sentAt":"2018-01-28T19:16:07Z","receivedAt":"2018-01-28T19:16:21Z","isPatch":true,"sender":{"key":"tmz@pobox.com","avatar":"https://avatars.githubusercontent.com/u/806319?v=4"},"body":"When 'git show' is called without any object it defaults to HEAD.  This\nhas been true since d4ed9793fd (\"Simplify common default options setup\nfor built-in log family.\", 2006-04-16).\n\nThe SYNOPSIS suggests that the object argument is required.  Clarify\nthat it is not required and note the default.\n\nSigned-off-by: Todd Zullinger <tmz@pobox.com>\n---\nThis was mentioned in #git today by qaz.  It seems reasonable to document the\ndefault.\n\n Documentation/git-show.txt | 4 ++--\n 1 file changed, 2 insertions(+), 2 deletions(-)\n\ndiff --git a/Documentation/git-show.txt b/Documentation/git-show.txt\nindex 82a4125a2d..e73ef54017 100644\n--- a/Documentation/git-show.txt\n+++ b/Documentation/git-show.txt\n@@ -9,7 +9,7 @@ git-show - Show various types of objects\n SYNOPSIS\n --------\n [verse]\n-'git show' [options] <object>...\n+'git show' [options] [<object>...]\n \n DESCRIPTION\n -----------\n@@ -35,7 +35,7 @@ This manual page describes only the most frequently used options.\n OPTIONS\n -------\n <object>...::\n-\tThe names of objects to show.\n+\tThe names of objects to show (defaults to 'HEAD').\n \tFor a more complete list of ways to spell object names, see\n \t\"SPECIFYING REVISIONS\" section in linkgit:gitrevisions[7].\n \n-- \n2.16.1\n\n"},{"id":"337814","messageId":"xmqqzi4vrr09.fsf@gitster-ct.c.googlers.com","threadId":"47708","inReplyTo":"20180128191607.31199-1-tmz@pobox.com","subject":"Re: [PATCH] doc: mention 'git show' defaults to HEAD","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2018-01-30T21:11:34Z","receivedAt":"2018-01-30T21:11:43Z","isPatch":true,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"Todd Zullinger <tmz@pobox.com> writes:\n\n> When 'git show' is called without any object it defaults to HEAD.  This\n> has been true since d4ed9793fd (\"Simplify common default options setup\n> for built-in log family.\", 2006-04-16).\n>\n> The SYNOPSIS suggests that the object argument is required.  Clarify\n> that it is not required and note the default.\n>\n> Signed-off-by: Todd Zullinger <tmz@pobox.com>\n> ---\n> This was mentioned in #git today by qaz.  It seems reasonable to document the\n> default.\n\nSounds sensible.\n\n>\n>  Documentation/git-show.txt | 4 ++--\n>  1 file changed, 2 insertions(+), 2 deletions(-)\n>\n> diff --git a/Documentation/git-show.txt b/Documentation/git-show.txt\n> index 82a4125a2d..e73ef54017 100644\n> --- a/Documentation/git-show.txt\n> +++ b/Documentation/git-show.txt\n> @@ -9,7 +9,7 @@ git-show - Show various types of objects\n>  SYNOPSIS\n>  --------\n>  [verse]\n> -'git show' [options] <object>...\n> +'git show' [options] [<object>...]\n>  \n>  DESCRIPTION\n>  -----------\n> @@ -35,7 +35,7 @@ This manual page describes only the most frequently used options.\n>  OPTIONS\n>  -------\n>  <object>...::\n> -\tThe names of objects to show.\n> +\tThe names of objects to show (defaults to 'HEAD').\n>  \tFor a more complete list of ways to spell object names, see\n>  \t\"SPECIFYING REVISIONS\" section in linkgit:gitrevisions[7].\n"}]}