From: Eric S. Raymond <esr@thyrsus.com>
Date: Sun, 16 Nov 2014 07:23:58 +0000 (-0500)
Subject: Document fast-import.
X-Git-Tag: 0.9~9
X-Git-Url: http://thyrsus.com/gitweb/?a=commitdiff_plain;h=566cd8581e6b0d2cc8ae120a5eec057bb264773b;p=src.git

Document fast-import.
---

diff --git a/src b/src
index 27ba5f9..83ced1b 100755
--- a/src
+++ b/src
@@ -272,6 +272,7 @@ log         -- the log command: dump commit log information to standard output.
 list        -- the list command: dump commit summaries to standard output.
 diff        -- the diff command: dump revision differences to standard output.
 fast-export -- the fast-export command: export history to other systems.
+fast-import -- the fast-import command: import history from other systems.
 ignores     -- .srcignore files and their uses.
 """,
     "intro": """
@@ -405,7 +406,7 @@ src fast-export ['revision-range'] ['file'...]
 
 src fast-import [-p] ['file'...]
    Parse a git-fast-import stream from standard input. The modifications for
-   each individual file become a SRC history.  Mark, committer and
+   each individual file become separate SRC histories.  Mark, committer and
    author data, and mark cross-references to parent commits, are preserved
    in RFC-822-style headers on log comments unless the -p (plain) option
    is given, in which case this metadata is discarded. Give arguments to
@@ -593,6 +594,24 @@ history.
 The committer identification is copied from your Git configuration.
 
 The default range is all commits.
+""",   
+   "fast-import" : """
+src fast-import [-p] ['file'...]
+
+Parse a git-fast-import stream from standard input. The modifications
+for each individual file become separate SRC histories. Give arguments
+to restrict the files imported.
+
+The import is actually done with the rcs-fast-import(1) tool, which
+must be on your $PATH for this command to work.
+
+Some gitspace metadata cannot be represented in the SRC/RCS model of
+version control. Mark, committer and author data, and mark
+cross-references to parent commits. These are preserved in
+RFC-822-style headers on log comments unless the -p (plain) option is
+given, in which case this metadata is discarded.
+
+This command is not expected to be very useful.  
 """,   
    "ignores" : """
 You can have a file named .srcignore containing the names of files that
diff --git a/src.asc b/src.asc
index a2da056..2650f32 100644
--- a/src.asc
+++ b/src.asc
@@ -117,7 +117,7 @@ src fast-export ['revision-range'] ['file'...]::
 
 src fast-import [-p] ['files'...]::
    Parse a git-fast-import stream from standard input. The modifications for
-   each individual file become a SRC history.  Mark, committer and
+   each individual file become separate SRC histories.  Mark, committer and
    author data, and mark cross-references to parent commits, are preserved
    in RFC-822-style headers on log comments unless the -p (plain) option
    is given, in which case this metadata is discarded. Give arguments