fast-export: standardize usage string and SYNOPSIS

The output of `git fast-export -h` currently starts with: usage: git fast-export [<rev-list-opts>] while the SYNOPSIS section in this command's documentation shows: 'git fast-export' [<options>] | 'git fast-import' Let's make both of these consistent with each other and with other Git commands by describing the arguments with: [<options>] [<revision-range>] [[--] <path>...] This takes into account the following: - `git fast-export` accepts both rev-list arguments and a number of genuine options of its own (--[no-]progress, --[no-]signed-tags, --[no-]signed-commits, etc). - `git fast-export` was the only command using `[<rev-list-opts>]` while many other commands describe their revision arguments as `[<revision-range>] [[--] <path>...]`. - In the DESCRIPTION section of the documentation, it's already mentioned several times that the output should eventually be fed to `git fast-import`. This also enables us to remove fast-export from "t/t0450/adoc-help-mismatches". Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Christian Couder committed Jul 13, 2026 at 14:41 UTC b9a7080755d54e9fc2397201cde7a6f5028e09ca
3 files changed +2 -3
Documentation/git-fast-export.adoc
+1 -1
@@ -9,7 +9,7 @@ git-fast-export - Git data exporter
9 SYNOPSIS
10 --------
11 [verse]
12 -'git fast-export' [<options>] | 'git fast-import'
12 +'git fast-export' [<options>] [<revision-range>] [[--] <path>...]
13
14 DESCRIPTION
15 -----------
builtin/fast-export.c
+1 -1
@@ -33,7 +33,7 @@
33 #include "gpg-interface.h"
34
35 static const char *const fast_export_usage[] = {
36 - N_("git fast-export [<rev-list-opts>]"),
36 + N_("git fast-export [<options>] [<revision-range>] [[--] <path>...]"),
37 NULL
38 };
39
t/t0450/adoc-help-mismatches
-1
@@ -12,7 +12,6 @@ column
12 credential
13 credential-cache
14 credential-store
15 -fast-export
15 fast-import
16 fetch-pack
17 fmt-merge-msg