...
pathEncoding = ENCODING Anchor |
---|
| core.pathEncoding |
---|
| core.pathEncoding |
---|
|
encoding to be used to store paths in Git tree objects. The default value is UTF8
.
gitPath = PATH
a path to Git executable. If this option is set, Git executable will be used to stream large files and perform Git garbage collection that can significantly decrease memory and disk space consumption.
streamFileThreshold = SIZE Anchor |
---|
| core.streamFileThreshold |
---|
| core.streamFileThreshold |
---|
|
file size in bytes. SubGit loads the entire file into memory if its size less than this threshold; if the file is larger than the threshold, SubGit sends it as a stream. The option is not set by default, but SubGit sets the threshold to 50MB when the option is not set, so default threshold is 50MB. Note, the bigger the threshold is, the more likely to run into OutOfMemory error.
javaHome = PATH Anchor |
---|
| core.javaHome |
---|
| core.javaHome |
---|
|
a path to Java home directory; this Java RE will be used to run hooks.
...
gitCommitMessage = PATTERN Anchor |
---|
| svn.gitCommitMessage |
---|
| svn.gitCommitMessage |
---|
|
a pattern consisting of placeholders that construct Git commit message when a SVNcommit is being translated to Git. There are several acceptable placeholders:
%author
= Git author%committer
= Git committer%date
= date of revision%message
= original message%svnUser
= Subversion username%revision
= Subversion revision, GRN in your notation%branch.
= Subversion branch\n
= newline feed
For example, if the gitCommitMessage
was set like this:
Code Block |
---|
language | text |
---|
theme | FadeToGrey |
---|
title | gitCommitMessage |
---|
|
gitCommitMessage = SVN %revision@%branch\\n%message |
Then, some changes have been committed to the SVN repository:
Code Block |
---|
language | text |
---|
theme | FadeToGrey |
---|
title | SVN revision 197 |
---|
|
-----------------------------------------------------------------
r197 | johndoe | 2017-06-29 13:38:02 +0500 (Thu, 29 Jun 2017) |
Changed paths:
M /project1/trunk/source.txt
gitCommitMessage example
----------------------------------------------------------------- |
Translated Git commit will look like this:
Code Block |
---|
language | text |
---|
theme | FadeToGrey |
---|
title | Git commit |
---|
|
$ git log -v
commit d5c7c9e2518a5e8942c26d7cda5ace61ddb7c045
Author: John Dow <johndoe@example.com>
Date: Thu Jun 29 08:38:02 2017 +0000
SVN 197@trunk
gitCommitMessage example |
allowBranchReplacement = [true|false] Anchor |
---|
| svn.allowBranchReplacement |
---|
| svn.allowBranchReplacement |
---|
|
When true
, SVN branches replacement is allowed, otherwise it isn't allowed.
allowReplacementBranches = PATH Anchor |
---|
| svn.allowReplacementBranches |
---|
| svn.allowReplacementBranches |
---|
|
a path pattern relative to svn.url
that points to SVN branches which are allowed to be replaced. This option works as an exception when allowBranchReplacement
is set to false:
it allows replacing those SVN branches when new Git changes are being pushed to the SubGit-mirrored Git repository.
allowBranchDeletion = [true|false] Anchor |
---|
| svn.allowBranchDeletion |
---|
| svn.allowBranchDeletion |
---|
|
When true
, SVN branches removing is allowed, otherwise it isn't allowed.
allowDeletionBranches = PATH Anchor |
---|
| svn.allowDeletionBranches |
---|
| svn.allowDeletionBranches |
---|
|
a path pattern relative to url
pointing to SVN branches which are allowed to be deleted. This option works as an exception allowBranchReplacement
is set to false:
It allows removing those SVN branches when new Git changes are being pushed to the SubGit-mirrored Git repository.
allowForcePush = [true|false] Anchor |
---|
| svn.allowForcePush |
---|
| svn.allowForcePush |
---|
|
When set to false
SubGit rejects any attempts to perform non-fast-forward updates for those refs which are synchronized with SVN repository. When true
, such updates are allowed.
cleanStaleRefLocks = [true|false] Anchor |
---|
| svn.cleanStaleRefLocks |
---|
| svn.cleanStaleRefLocks |
---|
|
When set to true
, SubGit automatically deletes any stale Git ref locks – i.e. ref lock files GIT_REPO/refs/**/*.lock
that exist more than a minute. If false
, SubGit won’t delete lock files, that means any stale ref locks has to be resolved manually. The default is true
.