]> git.ipfire.org Git - thirdparty/git.git/commitdiff
doc: clean up usage documentation for --no-* opts
authorJames Liu <james@jamesliu.io>
Fri, 3 May 2024 07:17:04 +0000 (17:17 +1000)
committerJunio C Hamano <gitster@pobox.com>
Fri, 3 May 2024 17:32:06 +0000 (10:32 -0700)
We'll be adding another option to the --no-* class of options soon.

Clean up the existing options by grouping them together in the OPTIONS
section, and adding missing ones to the SYNOPSIS.

Signed-off-by: James Liu <james@jamesliu.io>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git.txt
git.c

index 7a1b112a3e70203a8294952333c05845bfcb4da6..7fa75350b2f3c5be6c13affb503aacc5a9e16c3c 100644 (file)
@@ -11,9 +11,9 @@ SYNOPSIS
 [verse]
 'git' [-v | --version] [-h | --help] [-C <path>] [-c <name>=<value>]
     [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
-    [-p|--paginate|-P|--no-pager] [--no-replace-objects] [--bare]
-    [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
-    [--config-env=<name>=<envvar>] <command> [<args>]
+    [-p|--paginate|-P|--no-pager] [--no-replace-objects] [--no-lazy-fetch]
+    [--no-optional-locks] [--bare] [--git-dir=<path>] [--work-tree=<path>]
+    [--namespace=<name>] [--config-env=<name>=<envvar>] <command> [<args>]
 
 DESCRIPTION
 -----------
@@ -186,6 +186,10 @@ If you just want to run git as if it was started in `<path>` then use
        This is equivalent to setting the `GIT_NO_LAZY_FETCH`
        environment variable to `1`.
 
+--no-optional-locks::
+       Do not perform optional operations that require locks. This is
+       equivalent to setting the `GIT_OPTIONAL_LOCKS` to `0`.
+
 --literal-pathspecs::
        Treat pathspecs literally (i.e. no globbing, no pathspec magic).
        This is equivalent to setting the `GIT_LITERAL_PATHSPECS` environment
@@ -207,10 +211,6 @@ If you just want to run git as if it was started in `<path>` then use
        Add "icase" magic to all pathspec. This is equivalent to setting
        the `GIT_ICASE_PATHSPECS` environment variable to `1`.
 
---no-optional-locks::
-       Do not perform optional operations that require locks. This is
-       equivalent to setting the `GIT_OPTIONAL_LOCKS` to `0`.
-
 --list-cmds=<group>[,<group>...]::
        List commands by group. This is an internal/experimental
        option and may change or be removed in the future. Supported
diff --git a/git.c b/git.c
index 654d615a18845185e2ece17a7ca6229cea431a07..7654571b758157a5a7f424b3ffcdb00a8724f2c1 100644 (file)
--- a/git.c
+++ b/git.c
@@ -36,9 +36,9 @@ struct cmd_struct {
 const char git_usage_string[] =
        N_("git [-v | --version] [-h | --help] [-C <path>] [-c <name>=<value>]\n"
           "           [--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]\n"
-          "           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--bare]\n"
-          "           [--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]\n"
-          "           [--config-env=<name>=<envvar>] <command> [<args>]");
+          "           [-p | --paginate | -P | --no-pager] [--no-replace-objects] [--no-lazy-fetch]\n"
+          "           [--no-optional-locks] [--bare] [--git-dir=<path>] [--work-tree=<path>]\n"
+          "           [--namespace=<name>] [--config-env=<name>=<envvar>] <command> [<args>]");
 
 const char git_more_info_string[] =
        N_("'git help -a' and 'git help -g' list available subcommands and some\n"