]> thyrsus.com Git - src.git/commitdiff
Embedded help for fast-export.
authorEric S. Raymond <esr@thyrsus.com>
Sun, 16 Nov 2014 06:10:21 +0000 (01:10 -0500)
committerEric S. Raymond <esr@thyrsus.com>
Sun, 16 Nov 2014 06:10:21 +0000 (01:10 -0500)
src

diff --git a/src b/src
index f28120b8eab47f9858049f86663471c0ff08686e..529933e79c0f0eeb77e6df2d2c8af917ad2c38ff 100755 (executable)
--- a/src
+++ b/src
@@ -260,17 +260,18 @@ help_topics = {
     "topics": """
 The following help topics are available:
 
-intro     -- Basic concepts: commits, tags, branches. The form of commands.
-revisions -- How to specify ranges of commits to operate on.
-commands  -- a summary of the commands.
-commit    -- the commit comand: how to commit changes to a file.
-amend     -- the amend command: editing stored change comments.
-checkout  -- the checkout command: retrieving historical versions of files.
-cat       -- the cat command: dumping revisions to standard output
-status    -- the status command: more details and unusual status codes
-log       -- the log command: dump commit log information to standard output
-list      -- the list command: dump commit summaries to standard output
-ignores   -- .srcignore files and their uses.
+intro       -- Basic concepts: commits, tags, branches. The form of commands.
+revisions   -- How to specify ranges of commits to operate on.
+commands    -- a summary of the commands.
+commit      -- the commit comand: how to commit changes to a file.
+amend       -- the amend command: editing stored change comments.
+checkout    -- the checkout command: retrieving historical versions of files.
+cat         -- the cat command: dumping revisions to standard output.
+status      -- the status command: more details and unusual status codes.
+log         -- the log command: dump commit log information to standard output.
+list        -- the list command: dump commit summaries to standard output.
+fast-export -- the fast-export command: export history to other systems.
+ignores     -- .srcignore files and their uses.
 """,
     "intro": """
 SRC (or src) is designed for version control on single-file projects.
@@ -562,6 +563,24 @@ of beginning each commit with a self-contained summary line.
 With no revision, dumps a log of the entire current branch.
 
 'li' is a synonym for 'list'.
+""",   
+   "fast-export" : """
+src fast-export ['revision-range'] ['file'...]
+
+Export one or more projects to standard output as a git fast-import stream.
+This can beconsumed by 'git fast-import' to create a Git reppository
+containing the project history.  
+
+It is posssible (though probably not very useful) to fast-export a limited
+range of commits, producing an incremental dump.  In this case branch
+joins are done with the magic ^0 suffix.
+
+Fast-exporting multiple files profuces a single stream with a joint
+history.
+
+The committer identification is copied from your Git configuration.
+
+The default range is all commits.
 """,   
    "ignores" : """
 You can have a file named .srcignore containing the names of files that