@@ -10,7 +10,7 @@ SYNOPSIS
[--authors-file=<authors_file> [--require-authors]]
[--branches-file=<branches_file>] [--trunk-is-master]
[--convert-tagger=<email>] [--strip-at-suffix]
- [--expand-renames] [--]
+ [--expand-renames] [--names] [--]
[<input_file>] > <output_file>
@@ -102,6 +102,21 @@ OPTIONS
filerename 'R' are replaced with a filecopy 'C' followed by a
filedelete 'D' instead.
+ --names
+ This option may not be combined with any of the others. Instead of
+ outputting a modified fast-import stream, output only the author,
+ committer and tagger names as they are encountered one per line
+ without any timestamp information. This can be used to help build
+ an initial authors file.
+
+ Do note that the names are output as-is from the input stream
+ whereas this utility expects to match only the email portion when
+ given an authors file with the --authors-file option. This means
+ the name, non-email portion and surrounding < and > characters will
+ have to be removed from the output provided by this option.
+ Additionally, of course, duplicate names need to be removed as
+ well.
+
<input_file>
The fast-export stream to read. If <input_file> is omitted, then
standard input will be read.