diff options
author | Junio C Hamano <gitster@pobox.com> | 2012-07-25 16:25:21 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2012-07-25 16:25:21 -0700 |
commit | f5933728fc7c43adc2b7f3af7609920f7ba46719 (patch) | |
tree | 9f178470ced25df1865a589007fbe25b7115ffe6 /git-rev-parse.html | |
parent | 28a85beb3e536460e7d67f5ddb67c1096cb7cba1 (diff) | |
download | git-htmldocs-f5933728fc7c43adc2b7f3af7609920f7ba46719.tar.gz |
Autogenerated HTML docs for v1.7.12-rc0-22-gcdd15
Diffstat (limited to 'git-rev-parse.html')
-rw-r--r-- | git-rev-parse.html | 74 |
1 files changed, 68 insertions, 6 deletions
diff --git a/git-rev-parse.html b/git-rev-parse.html index 2e70f6461..411e2abd4 100644 --- a/git-rev-parse.html +++ b/git-rev-parse.html @@ -982,20 +982,20 @@ blobs contained in a commit.</p></div> object referenced by <em>refs/heads/master</em>. If you
happen to have both <em>heads/master</em> and <em>tags/master</em>, you can
explicitly say <em>heads/master</em> to tell git which one you mean.
- When ambiguous, a <em><name></em> is disambiguated by taking the
+ When ambiguous, a <em><refname></em> is disambiguated by taking the
first match in the following rules:
</p>
<div class="olist arabic"><ol class="arabic">
<li>
<p>
-If <em>$GIT_DIR/<name></em> exists, that is what you mean (this is usually
+If <em>$GIT_DIR/<refname></em> exists, that is what you mean (this is usually
useful only for <em>HEAD</em>, <em>FETCH_HEAD</em>, <em>ORIG_HEAD</em>, <em>MERGE_HEAD</em>
and <em>CHERRY_PICK_HEAD</em>);
</p>
</li>
<li>
<p>
-otherwise, <em>refs/<name></em> if it exists;
+otherwise, <em>refs/<refname></em> if it exists;
</p>
</li>
<li>
@@ -1005,17 +1005,17 @@ otherwise, <em>refs/tags/<refname></em> if it exists; </li>
<li>
<p>
-otherwise, <em>refs/heads/<name></em> if it exists;
+otherwise, <em>refs/heads/<refname></em> if it exists;
</p>
</li>
<li>
<p>
-otherwise, <em>refs/remotes/<name></em> if it exists;
+otherwise, <em>refs/remotes/<refname></em> if it exists;
</p>
</li>
<li>
<p>
-otherwise, <em>refs/remotes/<name>/HEAD</em> if it exists.
+otherwise, <em>refs/remotes/<refname>/HEAD</em> if it exists.
</p>
<div class="paragraph"><p><em>HEAD</em> names the commit on which you based the changes in the working tree.
<em>FETCH_HEAD</em> records the branch which you fetched from a remote repository
@@ -1256,6 +1256,65 @@ It is the set of commits that are reachable from either one of and its parent commits exist. The <em>r1^@</em> notation means all
parents of <em>r1</em>. <em>r1^!</em> includes commit <em>r1</em> but excludes
all of its parents.</p></div>
+<div class="paragraph"><p>To summarize:</p></div>
+<div class="dlist"><dl>
+<dt class="hdlist1">
+<em><rev></em>
+</dt>
+<dd>
+<p>
+ Include commits that are reachable from (i.e. ancestors of)
+ <rev>.
+</p>
+</dd>
+<dt class="hdlist1">
+<em>^<rev></em>
+</dt>
+<dd>
+<p>
+ Exclude commits that are reachable from (i.e. ancestors of)
+ <rev>.
+</p>
+</dd>
+<dt class="hdlist1">
+<em><rev1>..<rev2></em>
+</dt>
+<dd>
+<p>
+ Include commits that are reachable from <rev2> but exclude
+ those that are reachable from <rev1>.
+</p>
+</dd>
+<dt class="hdlist1">
+<em><rev1>...<rev2></em>
+</dt>
+<dd>
+<p>
+ Include commits that are reachable from either <rev1> or
+ <rev2> but exclude those that are reachable from both.
+</p>
+</dd>
+<dt class="hdlist1">
+<em><rev>^@</em>, e.g. <em>HEAD^@</em>
+</dt>
+<dd>
+<p>
+ A suffix <em>^</em> followed by an at sign is the same as listing
+ all parents of <em><rev></em> (meaning, include anything reachable from
+ its parents, but not the commit itself).
+</p>
+</dd>
+<dt class="hdlist1">
+<em><rev>^!</em>, e.g. <em>HEAD^!</em>
+</dt>
+<dd>
+<p>
+ A suffix <em>^</em> followed by an exclamation mark is the same
+ as giving commit <em><rev></em> and then all its parents prefixed with
+ <em>^</em> to exclude them (and their ancestors).
+</p>
+</dd>
+</dl></div>
<div class="paragraph"><p>Here are a handful of examples:</p></div>
<div class="literalblock">
<div class="content">
@@ -1263,9 +1322,12 @@ all of its parents.</p></div> D F G H I J D F
^G D H D
^D B E I J F B
+B..C C
B...C G H D E B C
^D B C E I J F B C
+C I J F C
C^@ I J F
+C^! C
F^! D G H D F</tt></pre>
</div></div>
</div>
|