1svn-fe(1) 2========= 3 4NAME 5---- 6svn-fe - convert an SVN "dumpfile" to a fast-import stream 7 8SYNOPSIS 9-------- 10svnadmin dump --incremental REPO | svn-fe [url] | git fast-import 11 12DESCRIPTION 13----------- 14 15Converts a Subversion dumpfile (version: 2) into input suitable for 16git-fast-import(1) and similar importers. REPO is a path to a 17Subversion repository mirrored on the local disk. Remote Subversion 18repositories can be mirrored on local disk using the `svnsync` 19command. 20 21INPUT FORMAT 22------------ 23Subversion's repository dump format is documented in full in 24`notes/dump-load-format.txt` from the Subversion source tree. 25Files in this format can be generated using the 'svnadmin dump' or 26'svk admin dump' command. 27 28OUTPUT FORMAT 29------------- 30The fast-import format is documented by the git-fast-import(1) 31manual page. 32 33NOTES 34----- 35Subversion dumps do not record a separate author and committer for 36each revision, nor a separate display name and email address for 37each author. Like git-svn(1), 'svn-fe' will use the name 38 39--------- 40user <user@UUID> 41--------- 42 43as committer, where 'user' is the value of the `svn:author` property 44and 'UUID' the repository's identifier. 45 46To support incremental imports, 'svn-fe' will put a `git-svn-id` 47line at the end of each commit log message if passed an url on the 48command line. This line has the form `git-svn-id: URL@REVNO UUID`. 49 50Empty directories and unknown properties are silently discarded. 51 52The resulting repository will generally require further processing 53to put each project in its own repository and to separate the history 54of each branch. The 'git filter-branch --subdirectory-filter' command 55may be useful for this purpose. 56 57BUGS 58---- 59Litters the current working directory with .bin files for 60persistence. Will be fixed when the svn-fe infrastructure is aware of 61a Git working directory. 62 63SEE ALSO 64-------- 65git-svn(1), svn2git(1), svk(1), git-filter-branch(1), git-fast-import(1), 66https://svn.apache.org/repos/asf/subversion/trunk/notes/dump-load-format.txt