From 93cef9e2ac0269a9b36419e73d2d7d97c43ef221 Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Sun, 16 Nov 2014 01:10:21 -0500 Subject: [PATCH] Embedded help for fast-export. --- src | 41 ++++++++++++++++++++++++++++++----------- 1 file changed, 30 insertions(+), 11 deletions(-) diff --git a/src b/src index f28120b..529933e 100755 --- 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 -- 2.43.0