|Table of Contents|
SVN Users and Git Authors
Both Subversion and Git keep authors names in commits, but those authors differ.
Pro Git book describes the difference between those names as follows: the author is the person who originally wrote the work, whereas the committer is the person who last applied the work. So, if you send in a patch to a project and one of the core members applies the patch, both of you get credit – you as the author, and the core member as the committer.
SubGit translates Git Up to the version 3.3.4 SubGit only used Git author name, so committer name doesn't mean much for the SVN-to-Git translation processso committer name did not mean much.
Since v.3.3.4 SubGit uses committer name for the author mapping by default. Since v.3.3.6 there's also an option to switch back to using author name for the mapping with the core.mapGitCommitter setting:
[core] mapGitCommitter = true|false
When it’s set to true (default), SubGit uses committer's name. Set it to false to make SubGit use author's name.
Note, that SubGit uses authors names to count licensed users, see Licensing manual for details.
All the configuration options reside in SubGit configuration file, that is situated in subgit subdirectory inside a newly created Git repository:
Automatic Authors Mapping
Anchor AutoMapping AutoMapping
When SubGit starts translation between SVN and Git, it looks for authors mapping files or authors helper programs. If none of them present, it generates the mapping automatically, following these rules for the translation:
Similarly, Git commits that made by John Doe <email@example.com> Git user appears in SVN with John Doe author name.
Anchor AuthorsFile AuthorsFile
The authors mapping file is a text file filled with SVN username - Git author pairs. Each pair maps SVN username to Git author like:
Changes made to authors files are being applied immediately, there is no need to restart mirroring or reinstall SubGit.
Scriptable Authors Mapping
In addition to the authors files, there is another way to establish SVN to Git authors mapping using authors helper program. The authors helper is an executable – script or binary – that is able to read data from standard input and send its work result to the standard output. Input and output data must fulfil the following formats: