kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

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>
maint
Andreas Heiduk 2018-05-03 20:48:29 +02:00 committed by Junio C Hamano
parent 43d7f2d65a
commit 88184c1fc2
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
Documentation/revisions.txt
View File

@ -7,6 +7,10 @@ syntax. Here are various ways to spell object names. The
ones listed near the end of this list name trees and ones listed near the end of this list name trees and
blobs contained in a commit. blobs contained in a commit.


NOTE: This document shows the "raw" syntax as seen by git. The shell
and other UIs might require additional quoting to protect special
characters and to avoid word splitting.

'<sha1>', e.g. 'dae86e1950b1277e545cee180551750029cfe735', 'dae86e':: '<sha1>', e.g. 'dae86e1950b1277e545cee180551750029cfe735', 'dae86e'::
The full SHA-1 object name (40-byte hexadecimal string), or The full SHA-1 object name (40-byte hexadecimal string), or
a leading substring that is unique within the repository. a leading substring that is unique within the repository.
@ -186,6 +190,8 @@ existing tag object.
is matched. ':/!-foo' performs a negative match, while ':/!!foo' matches a is matched. ':/!-foo' performs a negative match, while ':/!!foo' matches a
literal '!' character, followed by 'foo'. Any other sequence beginning with literal '!' character, followed by 'foo'. Any other sequence beginning with
':/!' is reserved for now. ':/!' is reserved for now.
Depending on the given text, the shell's word splitting rules might
require additional quoting.


'<rev>:<path>', e.g. 'HEAD:README', ':README', 'master:./README':: '<rev>:<path>', e.g. 'HEAD:README', ':README', 'master:./README'::
A suffix ':' followed by a path names the blob or tree A suffix ':' followed by a path names the blob or tree