{"thread":{"id":"23938","subject":"[PATCH svn-dump-fast-export] Reference documentation","startedAt":"2010-05-29T06:16:21Z","lastAt":"2010-05-29T06:59:18Z","messageCount":2,"participants":["Jonathan Nieder","David Michael Barr"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"142524","messageId":"20100529061621.GA6513@progeny.tock","threadId":"23938","inReplyTo":null,"subject":"[PATCH svn-dump-fast-export] Reference documentation","fromName":"Jonathan Nieder","fromEmail":"jrnieder@gmail.com","sentAt":"2010-05-29T06:16:21Z","receivedAt":"2010-05-29T06:16:21Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"Add a simple manual page (in asciidoc format) to document\nthe svn-fe command.\n\nSigned-off-by: Jonathan Nieder <jrnieder@gmail.com>\n---\nPatch is against git://github.com/barrbrain/svn-dump-fast-export.git master\n\nThoughts?\n\n svn-fe.txt |   56 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++\n 1 files changed, 56 insertions(+), 0 deletions(-)\n create mode 100644 svn-fe.txt\n\ndiff --git a/svn-fe.txt b/svn-fe.txt\nnew file mode 100644\nindex 0000000..bfd3a68\n--- /dev/null\n+++ b/svn-fe.txt\n@@ -0,0 +1,56 @@\n+svn-fe(1)\n+=========\n+\n+NAME\n+----\n+svn-fe - convert an SVN \"dumpfile\" to a fast-import stream\n+\n+SYNOPSIS\n+--------\n+svnadmin dump --incremental REPO | svn-fe [url] | git fast-import\n+\n+DESCRIPTION\n+-----------\n+Converts a textual representation of a Subversion repository into\n+input suitable for git-fast-import(1) and similar importers.\n+\n+INPUT FORMAT\n+------------\n+Subversion's repository dump format is documented in full in\n+`notes/dump-load-format.txt` from the Subversion source tree.\n+Files in this format can be generated using the 'svnadmin dump' or\n+'svk admin dump' command.\n+\n+OUTPUT FORMAT\n+-------------\n+The fast-import format is documented by the git-fast-import(1)\n+manual page.\n+\n+NOTES\n+-----\n+Subversion dumps do not record a separate author and committer for\n+each revision, nor a separate display name and email address for\n+each author.  Like git-svn(1), 'svn-fe' will use the name\n+\n+---------\n+user <user@UUID>\n+---------\n+\n+as committer, where 'user' is the value of the `svn:author` property\n+and 'UUID' the repository's identifier.\n+\n+To support incremental imports, 'svn-fe' will put a `git-svn-id`\n+line at the end of each commit log message if passed an url on the\n+command line.  This line has the form `git-svn-id: URL@REVNO UUID`.\n+\n+Empty directories and unknown properties are silently discarded.\n+\n+The resulting repository will generally require further processing\n+to put each project in its own repository and to separate the history\n+of each branch.  The 'git filter-branch --subdirectory-filter' command\n+may be useful for this purpose.\n+\n+SEE ALSO\n+--------\n+git-svn(1), svn2git(1), svk(1), git-filter-branch(1), git-fast-import(1),\n+https://svn.apache.org/repos/asf/subversion/trunk/notes/dump-load-format.txt\n-- \n1.7.1\n"},{"id":"142525","messageId":"9DEABC23-A416-4099-BF01-B9ACFC3284F7@cordelta.com","threadId":"23938","inReplyTo":"20100529061621.GA6513@progeny.tock","subject":"Re: [PATCH svn-dump-fast-export] Reference documentation","fromName":"David Michael Barr","fromEmail":"david.barr@cordelta.com","sentAt":"2010-05-29T06:59:18Z","receivedAt":"2010-05-29T06:59:18Z","isPatch":true,"sender":{"key":"david.barr@cordelta.com","avatar":"https://avatars.githubusercontent.com/u/220594?v=4"},"body":"Hi,\n\n> Add a simple manual page (in asciidoc format) to document\n> the svn-fe command.\n> \n> Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>\n> ---\n> Patch is against git://github.com/barrbrain/svn-dump-fast-export.git master\n\nThis patch has now been accepted into that repository.\n\n> Thoughts?\n\nCouldn't have done it better myself.\n\nIncremental dump support is still a TODO.\n\n--\nDavid Barr\n"}]}