From: Shawn O. Pearce Date: Wed, 7 Feb 2007 07:19:31 +0000 (-0500) Subject: Teach fast-import how to sit quietly in the corner. X-Git-Tag: v1.5.0-rc4~8^2~3 X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=c499d76849b09194434708376138952e2cac2e68;p=git.git Teach fast-import how to sit quietly in the corner. Often users will be running fast-import from within a larger frontend process, and this may be a frequent periodic tool such as a future edition of `git-svn fetch`. We don't want to bombard users with our large stats output if they won't be interested in it, so `--quiet` is now an option to make gfi be more silent. Signed-off-by: Shawn O. Pearce --- diff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt index 8bb5a0b36..beab7f0a5 100644 --- a/Documentation/git-fast-import.txt +++ b/Documentation/git-fast-import.txt @@ -64,6 +64,18 @@ OPTIONS Frontends can use this file to validate imports after they have been completed. +--quiet:: + Disable all non-fatal output, making gfi silent when it + is successful. This option disables the output shown by + \--stats. + +--stats:: + Display some basic statistics about the objects gfi has + created, the packfiles they were stored into, and the + memory used by gfi during this run. Showing this output + is currently the default, but can be disabled with \--quiet. + + Performance ----------- The design of gfi allows it to import large projects in a minimum @@ -106,8 +118,8 @@ fast-forward update, gfi will skip updating that ref and instead prints a warning message. gfi will always attempt to update all branch refs, and does not stop on the first failure. -Branch updates can be forced with `--force`, but its recommended that -this only be used on an otherwise quiet repository. Using `--force` +Branch updates can be forced with \--force, but its recommended that +this only be used on an otherwise quiet repository. Using \--force is not necessary for an initial import into an empty repository. @@ -148,11 +160,11 @@ Date Formats ~~~~~~~~~~~~ The following date formats are supported. A frontend should select the format it will use for this import by passing the format name -in the `--date-format=` command line option. +in the \--date-format= command line option. `raw`:: This is the Git native format and is `