summaryrefslogtreecommitdiffstats
path: root/git-rev-parse.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2024-05-28 13:40:44 -0700
committerJunio C Hamano <gitster@pobox.com>2024-05-28 13:40:44 -0700
commit1bfbb6c659ae0cb6db3e4bf289cf1f4b872a20d5 (patch)
treec4184c4a3374f32f5303825128f3690130a69b7b /git-rev-parse.html
parentd414f4cb00a2ad73aef33b3df685909afc424c96 (diff)
downloadgit-htmldocs-master.tar.gz
Autogenerated HTML docs for v2.45.1-313-g3a57aHEADmaster
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>