You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by rf...@apache.org on 2018/02/25 13:53:30 UTC

[maven-release] 01/04: Copy javadoc

This is an automated email from the ASF dual-hosted git repository.

rfscholte pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-release.git

commit 2a49b7fa2e85cfbdb46e869a9a0cd0ad82689e8b
Author: rfscholte <rf...@apache.org>
AuthorDate: Mon Feb 12 20:39:37 2018 +0100

    Copy javadoc
---
 .../shared/release/config/ReleaseDescriptor.java   | 263 ++++++++++++++++++++-
 1 file changed, 262 insertions(+), 1 deletion(-)

diff --git a/maven-release-api/src/main/java/org/apache/maven/shared/release/config/ReleaseDescriptor.java b/maven-release-api/src/main/java/org/apache/maven/shared/release/config/ReleaseDescriptor.java
index d9aa16a..042a347 100644
--- a/maven-release-api/src/main/java/org/apache/maven/shared/release/config/ReleaseDescriptor.java
+++ b/maven-release-api/src/main/java/org/apache/maven/shared/release/config/ReleaseDescriptor.java
@@ -29,110 +29,371 @@ import org.apache.maven.model.Scm;
  */
 public interface ReleaseDescriptor
 {
+    /**
+     * Get if updateDependencies is false, dependencies version won't be updated to the next development version.
+     * 
+     * @return boolean
+     */
     boolean isUpdateDependencies();
 
+    /**
+     * Get whether to use the release profile that adds sources and javadocs to the released artifact, if appropriate.
+     * If set to true, this will set the property "performRelease" to true.
+     * 
+     * @return boolean
+     */
     boolean isUseReleaseProfile();
 
+    /**
+     * Get whether to use the parent pom version for submodule versions.
+     * 
+     * @return boolean
+     */
     boolean isAutoVersionSubmodules();
 
+    /**
+     * Get whether a SNAPSHOT of the release plugin is allowed.
+     * 
+     * @return boolean
+     */
     boolean isSnapshotReleasePluginAllowed();
 
+    /**
+     * Get the commits must be done by modules or not. Set it to true in case of flat directory structure.
+     * 
+     * @return boolean
+     */
     boolean isCommitByProject();
 
+    /**
+     * Get whether to create a branch instead of do a release.
+     * 
+     * @return boolean
+     */
     boolean isBranchCreation();
 
+    /**
+     * Get whether to update branch POM versions.
+     * 
+     * @return boolean
+     */
     boolean isUpdateBranchVersions();
 
+    /**
+     * Get whether to update working copy POM versions.
+     * 
+     * @return boolean
+     */
     boolean isUpdateWorkingCopyVersions();
 
+    /**
+     * Get whether to suppress a commit of changes to the working copy before a tag or branch is created.
+     * 
+     * @return boolean
+     */
     boolean isSuppressCommitBeforeTagOrBranch();
 
+    /**
+     * Get should timestamped SNAPSHOT dependencies be allowed? Default is to fail when any SNAPSHOT dependency is
+     * found.
+     * 
+     * @return boolean
+     */
     boolean isAllowTimestampedSnapshots();
 
+    /**
+     * Get whether to update branch versions to SNAPSHOT.
+     * 
+     * @return boolean
+     */
     boolean isUpdateVersionsToSnapshot();
 
+    /**
+     * Get nOTE : currently only implemented with svn scm. Enable a workaround to prevent issue due to svn client >
+     * 1.5.0 (http://jira.codehaus.org/browse/SCM-406).
+     * 
+     * @return boolean
+     */
     boolean isRemoteTagging();
 
+    /**
+     * Get if the scm provider should use local checkouts via file://${basedir} instead of doing a clean checkout over
+     * the network. This is very helpful for releasing large projects!
+     * 
+     * @return boolean
+     */
     boolean isLocalCheckout();
 
+    /**
+     * Get 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.
+     * 
+     * @return boolean
+     */
     boolean isPushChanges();
 
+    /**
+     * Get default version to use for new working copy.
+     * 
+     * @return String
+     */
     String getDefaultDevelopmentVersion();
 
+    /**
+     * Get relative path of the project returned by the checkout command.
+     * 
+     * @return String
+     */
     String getScmRelativePathProjectDirectory();
 
+    /**
+     * Get the directory where the tag will be checked out.
+     * 
+     * @return String
+     */
     String getCheckoutDirectory();
 
+    /**
+     * Get the goals to execute in perform phase for the release.
+     * 
+     * @return String
+     */
     String getPerformGoals();
 
+    /**
+     * Get default version to use for the tagged release or the new branch.
+     * 
+     * @return String
+     */
     String getDefaultReleaseVersion();
 
+    /**
+     * Get nOTE : currently only implemented with svn scm. It contains the revision of the committed released pom to
+     * remotely tag the source code with this revision.
+     * 
+     * @return String
+     */
     String getScmReleasedPomRevision();
 
+    /**
+     * Get whether to add the model schema to the top of the rewritten POM if it wasn't there already. If
+     * <code>false</code> then the root element will remain untouched.
+     * 
+     * @return boolean
+     */
     boolean isAddSchema();
 
+    /**
+     * Get whether to generate release POMs.
+     * 
+     * @return boolean
+     */
     boolean isGenerateReleasePoms();
 
+    /**
+     * Get whether the release process is interactive and the release manager should be prompted to confirm values, or
+     * whether the defaults are used regardless.
+     * 
+     * @return boolean
+     */
     boolean isInteractive();
 
+    /**
+     * Get whether to use edit mode when making SCM modifications. This setting is disregarded if the SCM does not
+     * support edit mode, or if edit mode is compulsory for the given SCM.
+     * 
+     * @return boolean
+     */
     boolean isScmUseEditMode();
 
+    /**
+     * Get the last completed phase.
+     * 
+     * @return String
+     */
     String getCompletedPhase();
 
+    /**
+     * Method getCheckModificationExcludes.
+     * 
+     * @return List
+     */
     List<String> getCheckModificationExcludes();
 
+    /**
+     * Get additional arguments to pass to any executed Maven process.
+     * 
+     * @return String
+     */
     String getAdditionalArguments();
 
+    /**
+     * Get the goals to execute in preparation for the release.
+     * 
+     * @return String
+     */
     String getPreparationGoals();
 
+    /**
+     * Get the goals to execute in on completion of preparation for the release.
+     * 
+     * @return String
+     */
     String getCompletionGoals();
 
+    /**
+     * Get the file name of the POM to pass to any executed Maven process.
+     * 
+     * @return String
+     */
     String getPomFileName();
 
+    /**
+     * Get the prefix of SCM modification messages.
+     * 
+     * @return String
+     */
     String getScmCommentPrefix();
 
+    /**
+     * Get pass phrase for the private key.
+     * 
+     * @return String
+     */
     String getScmPrivateKeyPassPhrase();
 
+    /**
+     * Get the password for the user interacting with the scm.
+     * 
+     * @return String
+     */
     String getScmPassword();
 
+    /**
+     * Get private key for an SSH based SCM repository.
+     * 
+     * @return String
+     */
     String getScmPrivateKey();
 
+    /**
+     * Get tag or branch name: the identifier for the tag/branch. Example: maven-release-plugin-2.0.
+     * 
+     * @return String
+     */
     String getScmReleaseLabel();
 
+    /**
+     * Get where you are going to put your tagged sources Example https://svn.apache.org/repos/asf/maven/plugins/tags.
+     * 
+     * @return String
+     */
     String getScmTagBase();
 
+    /**
+     * Get where you are going to put your branched sources Example
+     * https://svn.apache.org/repos/asf/maven/plugins/branches.
+     * 
+     * @return String
+     */
     String getScmBranchBase();
 
+    /**
+     * Get the id can be used to get the credentials by the server-id from the settings.xml.
+     * 
+     * @return String
+     */
     String getScmId();
 
+    /**
+     * Get this is a MavenSCM of where you're going to get the sources to make the release with. Example:
+     * scm:svn:https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-release-plugin.
+     * 
+     * @return String
+     */
     String getScmSourceUrl();
 
+    /**
+     * Get the user name to interact with the scm.
+     * 
+     * @return String
+     */
     String getScmUsername();
 
+    /**
+     * Get wait the specified number of seconds before creating a tag.
+     * 
+     * @return int
+     */
     int getWaitBeforeTagging();
 
+    /**
+     * Get the directory where the release is performed.
+     * 
+     * @return String
+     */
     String getWorkingDirectory();
 
+    /**
+     * Get specifies the format for generating a tag name. Property expansion is used with the optional prefix of
+     * project, where properties are delimited with @{ and }.
+     * 
+     * @return String
+     */
     String getScmTagNameFormat();
 
+    /**
+     * Get the role-hint for the NamingPolicy implementation used to calculate the project branch and tag names.
+     * 
+     * @return String
+     */
     String getProjectNamingPolicyId();
 
+    /**
+     * Get the role-hint for the VersionPolicy implementation used to calculate the project versions.
+     * 
+     * @return String
+     */
     String getProjectVersionPolicyId(); 
 
+    /**
+     * Get the role-hint for the release Strategy implementation.
+     * 
+     * @return String
+     */
     String getReleaseStrategyId();
 
+    /**
+     * Retrieve the original version for the resolved snapshot dependency.
+     *
+     */
     String getDependencyOriginalVersion( String artifactKey );
     
+    /**
+     * Retrieve the release version for the resolved snapshot dependency.
+     *
+     */
     String getDependencyReleaseVersion( String artifactKey ); 
-    
+
+    /**
+     * Retrieve the release version for the resolved snapshot dependency.
+     *
+     */
     String getDependencyDevelopmentVersion( String artifactKey ); 
 
+    
     String getProjectOriginalVersion( String projectKey );
 
     String getProjectDevelopmentVersion( String projectKey );
 
     String getProjectReleaseVersion( String key );
 
+    /**
+     * Method getOriginalScmInfo.
+     * 
+     * @return Map
+     */
     Scm getOriginalScmInfo( String projectKey );
 
     // Modifiable

-- 
To stop receiving notification emails like this one, please contact
rfscholte@apache.org.