> Amend the section which describes how to get a commit summary to show
> how do to that with "git show", currently the documentation only shows
> how to do that with gitk.
>
> Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@xxxxxxxxx>
> ---
> Documentation/SubmittingPatches | 11 ++++++++++-
> 1 file changed, 10 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/SubmittingPatches b/Documentation/SubmittingPatches
> index 9ef624ce38..d8c88153c1 100644
> --- a/Documentation/SubmittingPatches
> +++ b/Documentation/SubmittingPatches
> @@ -134,8 +134,17 @@ with the subject enclosed in a pair of double-quotes, like this:
> noticed that ...
>
> The "Copy commit summary" command of gitk can be used to obtain this
> -format.
> +format, or this invocation of "git show":
>
> + git show -s --date=short --pretty='format:%h ("%s", %ad)' <commit>
> +
> +To turn that into a handy alias:
> +
> + git config --global alias.git-commit-summary "show -s --date=short --pretty='format:%h (\"%s\", %ad)'"
> +
> +And then to get the commit summary:
> +
> + git git-commit-summary <commit>
- 'tformat:' is a better fit than 'format:' in this case, because it
adds a trailing newline.
- I actually have a pretty format alias exactly for this purpose:
pretty.commitref=tformat:%h (%s, %as)
and a shorter 'git log -1 --pretty=commitref <commit>' does the
trick. Perhaps it would be worth to provide this as a builtin
pretty format.
(Of course this relies on '%as' being interpreted as short author
date to make the format work on its own, without the additional
'--date=short'. Alas, git doesn't support this, see [1].
If only there were a pretty format specifier for suppressing diff
output, then the '-s' could go away as well.)
- I find that the two subsequent 'git's in 'git git-<whatever>' look
strange. However, to make this point moot right away:
- I don't think SubmittingPatches is the right place to show how to
create and use a command alias.
[1] - http://public-inbox.org/git/1444235305-8718-1-git-send-email-szeder@xxxxxxxxxx/T/#u