Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • 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
    Anchor
    core.gitPath
    core.gitPath

    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.

up

[SVN]
Anchor
svn
svn

  • url = URL
    Anchor
    svn.url
    svn.url

    SVN project URL to be used for import/mirror. Supported protocols:

...

  • 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
    languagetext
    themeFadeToGrey
    titlegitCommitMessage
    gitCommitMessage = SVN %revision@%branch\\n%message

    Then, some changes have been committed to the SVN repository:


    Code Block
    languagetext
    themeFadeToGrey
    titleSVN 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
    languagetext
    themeFadeToGrey
    titleGit 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.

up

[AUTH]
Anchor
auth
auth