From: Junio C Hamano <gitster@pobox.com>
Date: Sat, 12 Jan 2013 02:35:07 +0000 (-0800)
Subject: Merge branch 'jk/maint-fast-import-doc-reorder'
X-Git-Tag: v1.8.2-rc0~131
X-Git-Url: https://repo.or.cz/w/git.git/commitdiff_plain/a96e8078a9135f54052ceb93c26adf4b863780ae

Merge branch 'jk/maint-fast-import-doc-reorder'

* jk/maint-fast-import-doc-reorder:
  git-fast-import(1): reorganise options
  git-fast-import(1): combine documentation of --[no-]relative-marks
---

a96e8078a9135f54052ceb93c26adf4b863780ae
diff --cc Documentation/git-fast-import.txt
index 3da5cc272a,73fec276e5..bf1a02a80d
--- a/Documentation/git-fast-import.txt
+++ b/Documentation/git-fast-import.txt
@@@ -44,23 -38,39 +39,40 @@@ OPTION
  	so would cause commits to be lost (as the new commit does
  	not contain the old commit).
  
- --max-pack-size=<n>::
- 	Maximum size of each output packfile.
- 	The default is unlimited.
+ --quiet::
+ 	Disable all non-fatal output, making fast-import silent when it
+ 	is successful.  This option disables the output shown by
+ 	\--stats.
  
- --big-file-threshold=<n>::
- 	Maximum size of a blob that fast-import will attempt to
- 	create a delta for, expressed in bytes.  The default is 512m
- 	(512 MiB).  Some importers may wish to lower this on systems
- 	with constrained memory.
+ --stats::
+ 	Display some basic statistics about the objects fast-import has
+ 	created, the packfiles they were stored into, and the
+ 	memory used by fast-import during this run.  Showing this output
+ 	is currently the default, but can be disabled with \--quiet.
  
- --depth=<n>::
- 	Maximum delta depth, for blob and tree deltification.
- 	Default is 10.
+ Options for Frontends
+ ~~~~~~~~~~~~~~~~~~~~~
  
- --active-branches=<n>::
- 	Maximum number of branches to maintain active at once.
- 	See ``Memory Utilization'' below for details.  Default is 5.
+ --cat-blob-fd=<fd>::
 -	Specify the file descriptor that will be written to
 -	when the `cat-blob` command is encountered in the stream.
 -	The default behaviour is to write to `stdout`.
++	Write responses to `cat-blob` and `ls` queries to the
++	file descriptor <fd> instead of `stdout`.  Allows `progress`
++	output intended for the end-user to be separated from other
++	output.
+ 
+ --date-format=<fmt>::
+ 	Specify the type of dates the frontend will supply to
+ 	fast-import within `author`, `committer` and `tagger` commands.
+ 	See ``Date Formats'' below for details about which formats
+ 	are supported, and their syntax.
+ 
+ --done::
+ 	Terminate with error if there is no `done` command at the end of
+ 	the stream.  This option might be useful for detecting errors
+ 	that cause the frontend to terminate before it has started to
+ 	write a stream.
+ 
+ Locations of Marks Files
+ ~~~~~~~~~~~~~~~~~~~~~~~~
  
  --export-marks=<file>::
  	Dumps the internal marks table to <file> when complete.