doc: add note about shell quoting to revision.txt
Signed-off-by: Andreas Heiduk <asheiduk@gmail.com> Reviewed-by: Junio C Hamano <gitster@pobox.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Andreas Heiduk committed
May 3, 2018 at 20:48 UTC
88184c1fc241461f6bcc2017e4aaa7f7ffd2f8d3
1 file changed
+6
Documentation/revisions.txt
+6
@@ -7,6 +7,10 @@ syntax. Here are various ways to spell object names. The
7
ones listed near the end of this list name trees and
8
blobs contained in a commit.
9
10
+NOTE: This document shows the "raw" syntax as seen by git. The shell
11
+and other UIs might require additional quoting to protect special
12
+characters and to avoid word splitting.
13
+
14
'<sha1>', e.g. 'dae86e1950b1277e545cee180551750029cfe735', 'dae86e'::
15
The full SHA-1 object name (40-byte hexadecimal string), or
16
a leading substring that is unique within the repository.
@@ -186,6 +190,8 @@ existing tag object.
190
is matched. ':/!-foo' performs a negative match, while ':/!!foo' matches a
191
literal '!' character, followed by 'foo'. Any other sequence beginning with
192
':/!' is reserved for now.
193
+ Depending on the given text, the shell's word splitting rules might
194
+ require additional quoting.
195
196
'<rev>:<path>', e.g. 'HEAD:README', ':README', 'master:./README'::
197
A suffix ':' followed by a path names the blob or tree