]> git.ipfire.org Git - thirdparty/git.git/commit
fast-export: standardize usage string and SYNOPSIS
authorChristian Couder <christian.couder@gmail.com>
Mon, 13 Jul 2026 12:41:53 +0000 (14:41 +0200)
committerJunio C Hamano <gitster@pobox.com>
Mon, 13 Jul 2026 15:54:29 +0000 (08:54 -0700)
commitb9a7080755d54e9fc2397201cde7a6f5028e09ca
treedd85c0f5b29c87abb96c223833fedd0252a18de5
parente9019fcafe0040228b8631c30f97ae1adb61bcdc
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>
Documentation/git-fast-export.adoc
builtin/fast-export.c
t/t0450/adoc-help-mismatches