summaryrefslogtreecommitdiffstats
path: root/git-rev-parse.html
diff options
context:
space:
mode:
Diffstat (limited to 'git-rev-parse.html')
-rw-r--r--git-rev-parse.html16
1 files changed, 13 insertions, 3 deletions
diff --git a/git-rev-parse.html b/git-rev-parse.html
index d50d9174f..e9874e24b 100644
--- a/git-rev-parse.html
+++ b/git-rev-parse.html
@@ -761,8 +761,14 @@ git-rev-parse(1) Manual Page
(i.e. parameters that begin with a dash <em>-</em>) and parameters
meant for the underlying <em>git rev-list</em> command they use internally
and flags and parameters for the other commands they use
-downstream of <em>git rev-list</em>. This command is used to
-distinguish between them.</p></div>
+downstream of <em>git rev-list</em>. The primary purpose of this command
+is to allow calling programs to distinguish between them. There are
+a few other operation modes that have nothing to do with the above
+"help parse command line options".</p></div>
+<div class="paragraph"><p>Unless otherwise specified, most of the options and operation modes
+require you to run this command inside a git repository or a working
+tree that is under the control of a git repository, and will give you
+a fatal error otherwise.</p></div>
</div>
</div>
<div class="sect1">
@@ -778,6 +784,8 @@ distinguish between them.</p></div>
<dd>
<p>
Use <em>git rev-parse</em> in option parsing mode (see PARSEOPT section below).
+ The command in this mode can be used outside a repository or
+ a working tree controlled by a repository.
</p>
</dd>
<dt class="hdlist1">
@@ -788,6 +796,8 @@ distinguish between them.</p></div>
Use <em>git rev-parse</em> in shell quoting mode (see SQ-QUOTE
section below). In contrast to the <code>--sq</code> option below, this
mode only does quoting. Nothing else is done to command input.
+ The command in this mode can be used outside a repository or
+ a working tree controlled by a repository.
</p>
</dd>
</dl></div>
@@ -2181,7 +2191,7 @@ Similar to above:
<div id="footer">
<div id="footer-text">
Last updated
- 2024-03-28 14:36:08 PDT
+ 2024-05-28 13:39:08 PDT
</div>
</div>
</body>