git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 4/7] doc: move synopsis git-mv commands in the synopsis section

From
Jean-Noël Avila via GitGitGadget <gitgitgadget@gmail.com>
Date
Apr 12, 2025, 12:20 UTC
Message-ID
<2a129734e3d6c7714186f48f916a48dc7535f91b.1744460450.git.gitgitgadget@gmail.com>
In-Reply-To
<pull.1896.v2.git.1744460450.gitgitgadget@gmail.com>
From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= <jn.avila@free.fr>

This also entails changing the help output for the command to match the new synopsis.

Signed-off-by: Jean-Noël Avila <jn.avila@free.fr>
---
 Documentation/git-mv.adoc | 6 ++----
 builtin/mv.c              | 3 ++-
 2 files changed, 4 insertions(+), 5 deletions(-)
diff --git a/Documentation/git-mv.adoc b/Documentation/git-mv.adoc
index dc1bf615341..08d660643fc 100644
--- a/Documentation/git-mv.adoc
+++ b/Documentation/git-mv.adoc
@@ -9,15 +9,13 @@ git-mv - Move or rename a file, a directory, or a symlink
 SYNOPSIS
 --------
 [verse]
-'git mv' [<options>] <source>... <destination>
+'git mv' [-v] [-f] [-n] [-k] <source> <destination>
+'git mv' [-v] [-f] [-n] [-k] <source> ... <destination-directory>
 
 DESCRIPTION
 -----------
 Move or rename a file, directory, or symlink.
 
- git mv [-v] [-f] [-n] [-k] <source> <destination>
- git mv [-v] [-f] [-n] [-k] <source> ... <destination-directory>
-
 In the first form, it renames <source>, which must exist and be either
 a file, symlink or directory, to <destination>.
 In the second form, the last argument has to be an existing
diff --git a/builtin/mv.c b/builtin/mv.c
index 55a7d471dca..9e36b616ab6 100644
--- a/builtin/mv.c
+++ b/builtin/mv.c
@@ -28,7 +28,8 @@
 #include "entry.h"
 
 static const char * const builtin_mv_usage[] = {
-	N_("git mv [<options>] <source>... <destination>"),
+	N_("git mv [-v] [-f] [-n] [-k] <source> <destination>"),
+	N_("git mv [-v] [-f] [-n] [-k] <source> ... <destination-directory>"),
 	NULL
 };
 
-- 
gitgitgadget
Previous: Jean-Noël Avila via GitGitGadgetNext: Jean-Noël Avila via GitGitGadget
Message 15 of 19 in “doc: convert git-reset, git-rm and git-mv to new documentation format”
  1. 0/5 doc: convert git-reset, git-rm and git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  2. 1/5 doc: convert git-reset to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  3. Martin ÅgrenApr 4, 2025
  4. 2/5 doc: fix synopsis analysis logicJean-Noël Avila via GitGitGadget, Mar 30, 2025
  5. Martin ÅgrenApr 4, 2025
  6. Jean-Noël AvilaApr 12, 2025
  7. 3/5 doc: convert git-rm to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  8. 4/5 doc: move synopsis git-mv commands in the synopsis sectionJean-Noël Avila via GitGitGadget, Mar 30, 2025
  9. Martin ÅgrenApr 5, 2025
  10. 5/5 doc: convert git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Mar 30, 2025
  11. 0/7 doc: convert git-reset, git-rm and git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  12. 1/7 doc: convert git-reset to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  13. 2/7 doc: fix synopsis analysis logicJean-Noël Avila via GitGitGadget, Apr 12, 2025
  14. 3/7 doc: convert git-rm to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  15. 4/7 doc: move synopsis git-mv commands in the synopsis sectionJean-Noël Avila via GitGitGadget, Apr 12, 2025
  16. 5/7 doc: convert git-mv to new documentation formatJean-Noël Avila via GitGitGadget, Apr 12, 2025
  17. 6/7 doc: fix asciidoctor synopsis processing of triple-dotsJean-Noël Avila via GitGitGadget, Apr 12, 2025
  18. 7/7 doc: add markup for characters in GuidelinesJean-Noël Avila via GitGitGadget, Apr 12, 2025
  19. Junio C HamanoApr 14, 2025

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.