anchor.diff:  RELEASE_1.0.0-JIRA-4711-dev.1   Tag of a development milestone release of a feature branch version 1.0.0-JIRA-4711
   ----
   
  -==== Version calculation on Git
  +==== Version Calculation on Git
   * Default Branch (master) +
  -The plugin is looking for a tag on the branch. If there is no tag the default value is used and extended with SNAPSHOT.
  +The plugin is looking for a tag on the branch. If there is no tag the default value is used and extended with `SNAPSHOT`.
  +
  +* Branch/Feature Branch +
  +The plugin is looking for a tag on the branch. If there is no valid tag on the branch, the version is taken from the name of the branch. The version will be always extended with `SNAPSHOT` on the CI server.
  +
  +* Tags +
  +Without local changes the plugin tries to calculate the name from the tag name.
  +
  +==== Version Calculation on Subversion
  +* Trunk +
  +The plugin is looking for a tag that matches the specified criteria. In the most cases, the version is calculated from branches and will be extended with `SNAPSHOT`. This behavior can be configured.
   
   * Branch / Feature Branch +
  -The plugin is looking for a tag on the branch. If there is no valid tag on the branch, the version is taken from the name of the branch.
  -The version will be always extended with SNAPSHOT on the CI server.
  +The plugin is looking for a tag that matches the branch name. If there is no valid tag on the branch, the version is taken from the name of the branch. The version will be always extended with `SNAPSHOT` on the CI server.
   
   * Tags +
  -With out local changes the plugin tries to calculate the name from the tag name.
  -
  -==== Version calculation on Subversion
  -* Trunk +
  -The plugin is looking for a tag witch matches to specified criteria. In the most cases the version is calculated from
  -branches and will be extended with SNAPSHOT. This behavior can be configured.
  -
  -* Branch / Feature Branch +
  -The plugin is looking for a tag witch matches to branch name. If there is no valid tag on the branch, the version is taken
  -from the name of the branch.  The version will be always extended with SNAPSHOT on the CI server.
  -
  -* Tags +
  -With out local changes the plugin tries to calculate the name from the tag name.
  +Without local changes the plugin tries to calculate the name from the tag name.
   
   == Usage
  -To use the Gradle scm version plugin provided by Intershop, include the following in your build script of your *root* project:
  +To use the Gradle SCM Version plugin provided by Intershop, include the following in your build script of your *root* project:
   
   [source,groovy]
   [subs=+attributes]
  
positive.code: = SCM Version Plugin
  :latestRevision: 1.0.0
  :toc:
  
  == Summary
  This plugin provides project configuration and tasks for version handling based on the used SCM of the project.
  The information of the used SCM is identified by special directories in the project directory ('`.git`', '`.svn`').
  The following types of SCM are supported:
  
  * git
  * svn
  * file (limited functionality)
  
  For the calculation of the project version branches and tags are used. The basic functionality is for Git and Subversion equal.
  A file-based project does not support the calculation of the version based on previous versions. It is also possible to
  identify the changes between the current working copy and the previous version. This functionality can also used on a
  CI server during the creation of a new tag. In this case the changes between two versions are written to a file.
  
  == Version Information from the SCM
  This plugin add the possibility to calculate version information of a project from the used SCM structure. It initialize a
  project property `useSCMVersionConfig`. The value of this property is `true`, if the plugin was applied and can be used
  by the own build logic and other plugins.
  
  === Subversion
  This implementation depends on SVNKit 1.8, therefore it is necessary to have an installed SVN client 1.8 for
  the access to the stored Subversion credentials. For a correct calculation of the version, the access to the SVN
  repository must be available
  
  [[svn_offlineaccess]]
  [CAUTION]
  ========
  . This plugin assumes the standard Subversion structure:
  
    <project>
  
negative.code: |tag        |CreateTag        |This task creates a tag based on the current working copy. +
  It makes changes to the SCM.
  |branch     |CreateBranch     |This task creates a branch based on the current working copy. +
  It makes changes to the SCM.  +
  For creating a feature branch it is necessary to specify a short name for the feature in a project property `*feature*`.
  |toVersion  |ToVersion        |This task moves the working copy to a target version.
  This version must be specified in a project property `*targetVersion*`. It is also possible to specify the short name of a
  feature in a property `*feature*`. +
  It changes the working copy.
  |release    |PrepareRelease   |This task creates a tag, if necessary, and move the the working copy to the version. +
  It changes the working copy.
  |createChangelog |CreateChangeLog   | This task creates a change log with all changes between the latest commit of the current working copy and the tag of the previous version. It is possible to specify another 'previous' version. +
  The tag for this version is mandatory.
  |===
  
  All task are part of the package `'com.intershop.gradle.scm.task'`
  
  == Project Extension 'scm'
  
  This plugin adds an extension *`scm`* to the root project. This extension contains all plugin configurations.
  
  