scm:changelog

Full name:

org.apache.maven.plugins:maven-scm-plugin:2.0.1:changelog

Description:

Dump changelog contents to console. It is mainly used to test maven-scm-api's changelog command.

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator plugin.
  • The goal is not marked as thread-safe and thus does not support parallel builds.

Required Parameters

Name Type Since Description
<basedir> File - The base directory.
User property is: basedir.

Optional Parameters

Name Type Since Description
<connectionType> String - The type of connection to use (connection or developerConnection).
Default value is: connection.
User property is: connectionType.
<connectionUrl> String - The SCM connection URL.
Default value is: ${project.scm.connection}.
User property is: connectionUrl.
<dateFormat> String - Date Format in changelog output of scm tool.
User property is: dateFormat.
<developerConnectionUrl> String - The SCM connection URL for developers.
Default value is: ${project.scm.developerConnection}.
User property is: developerConnectionUrl.
<endDate> String - End Date.
User property is: endDate.
<endScmVersion> String - End Scm Version.
User property is: endScmVersion.
<endScmVersionType> String - End Scm Version Type.
User property is: endScmVersionType.
<excludes> String - Comma separated list of excludes file pattern.
User property is: excludes.
<includes> String - Comma separated list of includes file pattern.
User property is: includes.
<limit> Integer - The number of change log items to return.
User property is: limit.
<numDays> Integer - The number of days to look back for change log items to return.
User property is: numDays.
<passphrase> String - The passphrase.
User property is: passphrase.
<password> String - The user password.
User property is: password.
<privateKey> String - The private key.
User property is: privateKey.
<providerImplementations> Map<String,String> - List of provider implementations.
<pushChanges> boolean 1.4 Should distributed changes be pushed to the central repository? For many distributed SCMs like Git, a change like a commit is only stored in your local copy of the repository. Pushing the change allows your to more easily share it with other users.
Default value is: true.
User property is: pushChanges.
<scmBranch> String - The branch name (TODO find out what this is for).
User property is: scmBranch.
<scmVersion> String - The version (revision number/branch name/tag name).
User property is: scmVersion.
<scmVersionType> String - The version type (branch/tag) of scmVersion.
User property is: scmVersionType.
<startDate> String - Start Date.
User property is: startDate.
<startScmVersion> String - Start Scm Version.
User property is: startScmVersion.
<startScmVersionType> String - Start Scm Version Type.
User property is: startScmVersionType.
<systemProperties> Properties - List of System properties to pass to the JUnit tests.
<tagBase> String - The url of tags base directory (used by svn protocol). It is not necessary to set it if you use the standard svn layout (branches/tags/trunk).
User property is: tagBase.
<userDateFormat> String - Date format to use for the specified startDate and/or endDate.
Default value is: yyyy-MM-dd.
User property is: userDateFormat.
<username> String - The user name.
User property is: username.
<workingDirectory> File - The working directory.
User property is: workingDirectory.
<workItem> String 1.9.5 Deprecated. A workItem for SCMs like RTC, TFS etc, that may require additional information to perform a pushChange operation.
User property is: workItem.

Parameter Details

<basedir>

The base directory.
  • Type: java.io.File
  • Required: Yes
  • User Property: basedir

<connectionType>

The type of connection to use (connection or developerConnection).
  • Type: java.lang.String
  • Required: No
  • User Property: connectionType
  • Default: connection

<connectionUrl>

The SCM connection URL.
  • Type: java.lang.String
  • Required: No
  • User Property: connectionUrl
  • Default: ${project.scm.connection}

<dateFormat>

Date Format in changelog output of scm tool.
  • Type: java.lang.String
  • Required: No
  • User Property: dateFormat

<developerConnectionUrl>

The SCM connection URL for developers.
  • Type: java.lang.String
  • Required: No
  • User Property: developerConnectionUrl
  • Default: ${project.scm.developerConnection}

<endDate>

End Date.
  • Type: java.lang.String
  • Required: No
  • User Property: endDate

<endScmVersion>

End Scm Version.
  • Type: java.lang.String
  • Required: No
  • User Property: endScmVersion

<endScmVersionType>

End Scm Version Type.
  • Type: java.lang.String
  • Required: No
  • User Property: endScmVersionType

<excludes>

Comma separated list of excludes file pattern.
  • Type: java.lang.String
  • Required: No
  • User Property: excludes

<includes>

Comma separated list of includes file pattern.
  • Type: java.lang.String
  • Required: No
  • User Property: includes

<limit>

The number of change log items to return.
  • Type: java.lang.Integer
  • Required: No
  • User Property: limit

<numDays>

The number of days to look back for change log items to return.
  • Type: java.lang.Integer
  • Required: No
  • User Property: numDays

<passphrase>

The passphrase.
  • Type: java.lang.String
  • Required: No
  • User Property: passphrase

<password>

The user password.
  • Type: java.lang.String
  • Required: No
  • User Property: password

<privateKey>

The private key.
  • Type: java.lang.String
  • Required: No
  • User Property: privateKey

<providerImplementations>

List of provider implementations.
  • Type: java.util.Map<java.lang.String, java.lang.String>
  • Required: No

<pushChanges>

Should distributed changes be pushed to the central repository? For many distributed SCMs like Git, a change like a commit is only stored in your local copy of the repository. Pushing the change allows your to more easily share it with other users.
  • Type: boolean
  • Since: 1.4
  • Required: No
  • User Property: pushChanges
  • Default: true

<scmBranch>

The branch name (TODO find out what this is for).
  • Type: java.lang.String
  • Required: No
  • User Property: scmBranch

<scmVersion>

The version (revision number/branch name/tag name).
  • Type: java.lang.String
  • Required: No
  • User Property: scmVersion

<scmVersionType>

The version type (branch/tag) of scmVersion.
  • Type: java.lang.String
  • Required: No
  • User Property: scmVersionType

<startDate>

Start Date.
  • Type: java.lang.String
  • Required: No
  • User Property: startDate

<startScmVersion>

Start Scm Version.
  • Type: java.lang.String
  • Required: No
  • User Property: startScmVersion

<startScmVersionType>

Start Scm Version Type.
  • Type: java.lang.String
  • Required: No
  • User Property: startScmVersionType

<systemProperties>

List of System properties to pass to the JUnit tests.
  • Type: java.util.Properties
  • Required: No

<tagBase>

The url of tags base directory (used by svn protocol). It is not necessary to set it if you use the standard svn layout (branches/tags/trunk).
  • Type: java.lang.String
  • Required: No
  • User Property: tagBase

<userDateFormat>

Date format to use for the specified startDate and/or endDate.
  • Type: java.lang.String
  • Required: No
  • User Property: userDateFormat
  • Default: yyyy-MM-dd

<username>

The user name.
  • Type: java.lang.String
  • Required: No
  • User Property: username

<workingDirectory>

The working directory.
  • Type: java.io.File
  • Required: No
  • User Property: workingDirectory

<workItem>

Deprecated. No reason given
A workItem for SCMs like RTC, TFS etc, that may require additional information to perform a pushChange operation.
  • Type: java.lang.String
  • Since: 1.9.5
  • Required: No
  • User Property: workItem