summaryrefslogtreecommitdiffstats
path: root/revisions.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2018-05-23 16:07:42 +0900
committerJunio C Hamano <gitster@pobox.com>2018-05-23 16:07:42 +0900
commitb9d9d90d180cf21baeeb16bd89828d25c7901470 (patch)
treea40241052af8d4f5543b66581e3f0235cfae0af3 /revisions.txt
parentccb8252b46bfba5daf0cfcedaf0f9d2e14ba356f (diff)
downloadgit-htmldocs-b9d9d90d180cf21baeeb16bd89828d25c7901470.tar.gz
Autogenerated HTML docs for v2.17.0-775-ge144d
Diffstat (limited to 'revisions.txt')
-rw-r--r--revisions.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/revisions.txt b/revisions.txt
index dfcc49c72..7d1bd4409 100644
--- a/revisions.txt
+++ b/revisions.txt
@@ -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
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'::
The full SHA-1 object name (40-byte hexadecimal string), or
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
literal '!' character, followed by 'foo'. Any other sequence beginning with
':/!' 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'::
A suffix ':' followed by a path names the blob or tree
@@ -345,6 +351,7 @@ Here are a handful of examples using the Loeliger illustration above,
with each step in the notation's expansion and selection carefully
spelt out:
+....
Args Expanded arguments Selected commits
D G H D
D F G H I J D F
@@ -367,3 +374,4 @@ spelt out:
= B ^B^1 ^B^2 ^B^3
= B ^D ^E ^F B
F^! D = F ^I ^J D G H D F
+....