SubmittingPatches: use `--pretty=reference`
Since Git was taught the `--pretty=reference` option, it is no longer necessary to manually specify the format string to get the commit reference. Teach users to use the new option while keeping the old invocation around in case they have an older version of Git. Signed-off-by: Denton Liu <liu.denton@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Denton Liu committed
Nov 19, 2019 at 16:51 UTC
3798149a74f0c2b84b42b108b4fc6ce28c6ab023
1 file changed
+6
Documentation/SubmittingPatches
+6
@@ -153,6 +153,12 @@ The "Copy commit summary" command of gitk can be used to obtain this
153
format (with the subject enclosed in a pair of double-quotes), or this
154
invocation of `git show`:
155
156
+....
157
+ git show -s --pretty=reference <commit>
158
+....
159
+
160
+or, on an older version of Git without support for --pretty=reference:
161
+
162
....
163
git show -s --date=short --pretty='format:%h (%s, %ad)' <commit>
164
....