> 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 <ava...@gmail.com> > --- > 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-sze...@ira.uka.de/T/#u