SVN-ALL-FAST-EXPORT(1)

💖 SVN-ALL-FAST-EXPORT 💖

okay so bestie, welcome to svn-all-fast-export, section 1 of the General Commands Manual, and no cap this thing is literally a tool to convert svn repositories into git. she's iconic, she's vintage (April 2010 vintage, we'll get there), and she's gonna hold your hand through the whole glow-up. 🦋

✨ NAME ✨

svn-all-fast-export — the girlies' fav tool to convert svn repositories into git. that's it, that's the name, periodt. 💅

🌸 SYNOPSIS 🌸

svn-all-fast-export [options] [Path to subversion repository]

🎀 DESCRIPTION 🎀

so. svn-all-fast-export is a tool to convert your svn repositories to git. main character energy fr fr. 👑

here's the tea though — you're gonna need two things before she'll even look at you:

1. a copy of your svn repository (a literal copy, we'll explain)
2. some rules written out to specify how the conversion will be done

the rules are lowkey the whole personality of this operation. for instance, you can manage how the tags and branches will be managed by writing the appropriate rules. it's giving very much "you control the vibe". there are examples waiting for you at /usr/share/doc/svn-all-fast-export/examples if you're stuck — go look, bestie, they ate. ✨

and about that "Path to subversion repository" — that is a backup copy of the subversion repository. not a url. not a url. > ⚠️ note that an svn url will not work due to the undistributed nature of svn. sorry babe, she said what she said. 😭

💅 OPTIONS 💅

• --identity-map — provide a map between svn username and email. you can hand her a file mapping the old svn accounts to the authors' names. this file must have a line per each svn account, and you can use either the svn-all-fast-export native format:

janesvnaccountname Jane Doe <jane.doe@example.com>

or the git-svn format:

janesvnaccountname = Jane Doe <jane.doe@example.com>

• --revisions-file — provide a file with revision numbers that should be processed. this file should have one revision number per line. one. per. line. 🍓
• --rules — the rules file that determines what goes where. see /usr/share/doc/svn-all-fast-export/examples for further details. yes queen, the rules file is the blueprint. 🧚
• --add-metadata — if passed, each git commit will have svn commit info. little receipts, cute. 🎀
• --resume-from — start importing at svn revision number. pick up where you left off, no shame. 💜
• --max-rev — stop importing at svn revision number. know when to say when. 🛑
• --dry-run — don't actually write anything. it's the rehearsal, not the performance. 🙈
• --debug-rules — print what rule is being used for each file. detective mode activated. 🔍
• --commit-interval number — if passed the cache will be flushed to git every number of commits. so like, take the number argument, girl, don't leave her hanging. ✨
• --stats — after a run, print some statistics. we love numbers, we love receipts, we love a post-game recap. 📊
• --svn-branches — use the content of SVN when creating branches. > note: SVN tags are branches as well. so yeah, keep that in mind. 🌈
• -h, --help — show summary of options. your emergency contact. 🫶
• -v, --version — show version of program. 💫

🔥 RETURN VALUES 🔥

this program returns 0 on success, and on error something else (numbers in base 10):

• 10 — unrecognized option or missing argument
• 11 — no rules file specified

like, she's telling you exactly what went wrong. respect. 💀

💀 BUGS 💀

⚠️ all matching rules need to end with a /, else the tool will crash at some point. the only exception are the rules using the recurse-action.

that's it. that's the warning. do not test her. 😭

🌐 HOMEPAGE 🌐

http://gitorious.org/svn2git

👀 SEE ALSO 👀

http://techbase.kde.org/Projects/MoveToGit/UsingSvn2Git

👑 AUTHORS 👑

svn-all-fast-export was written by Thiago Macieira and Thomas Zander. absolute legends, we stan. 💖

okay bestie, that's the whole page!! this came straight out of the General Commands Manual, dated April 25, 2010 — like I said, vintage, but she still slays. go forth, convert your repos, and remember: slash at the end of your rules. mwah. 💅✨🦋🎀