add: make warn_pathless_add() a no-op after first call
[gitweb.git] / Documentation / git-rev-parse.txt
index 4cc3e9586fcfd79ddeb7f636141e1a878285b0b5..10a116faf8f681c9984c9b52949e84c227fdc26e 100644 (file)
@@ -14,7 +14,7 @@ SYNOPSIS
 DESCRIPTION
 -----------
 
-Many git porcelainish commands take mixture of flags
+Many Git porcelainish commands take mixture of flags
 (i.e. parameters that begin with a dash '-') and parameters
 meant for the underlying 'git rev-list' command they use internally
 and flags and parameters for the other commands they use
@@ -101,6 +101,12 @@ OPTIONS
        The option core.warnAmbiguousRefs is used to select the strict
        abbreviation mode.
 
+--disambiguate=<prefix>::
+       Show every object whose name begins with the given prefix.
+       The <prefix> must be at least 4 hexadecimal digits long to
+       avoid listing each and every object in the repository by
+       mistake.
+
 --all::
        Show all refs found in `refs/`.
 
@@ -141,7 +147,7 @@ shown.  If the pattern does not contain a globbing character (`?`,
        relative to the current working directory.
 +
 If `$GIT_DIR` is not defined and the current directory
-is not detected to lie in a git repository or work tree
+is not detected to lie in a Git repository or work tree
 print a message to stderr and exit with nonzero status.
 
 --is-inside-git-dir::
@@ -181,9 +187,11 @@ print a message to stderr and exit with nonzero status.
        Flags and parameters to be parsed.
 
 --resolve-git-dir <path>::
-       Check if <path> is a valid git-dir or a git-file pointing to a valid
-       git-dir. If <path> is a valid git-dir the resolved path to git-dir will
-       be printed.
+       Check if <path> is a valid repository or a gitfile that
+       points at a valid repository, and print the location of the
+       repository.  If <path> is a gitfile then the resolved path
+       to the real repository is printed.
+
 
 include::revisions.txt[]