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 2013/09/18 21:39:44 UTC
svn commit: r1524544 -
/maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm
Author: rfscholte
Date: Wed Sep 18 19:39:43 2013
New Revision: 1524544
URL: http://svn.apache.org/r1524544
Log:
[MDEPLOY-154] Rewrite page 'deploy with classifier'
Modified:
maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm
Modified: maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm?rev=1524544&r1=1524543&r2=1524544&view=diff
==============================================================================
--- maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm (original)
+++ maven/plugins/trunk/maven-deploy-plugin/src/site/apt/examples/deploying-with-classifiers.apt.vm Wed Sep 18 19:39:43 2013
@@ -1,9 +1,9 @@
----
Deploy an artifact with classifier
------
- Allan Ramirez
+ Robert Scholte
------
- June 2006
+ September 2013
------
~~ Licensed to the Apache Software Foundation (ASF) under one
@@ -28,28 +28,34 @@
Deploy an artifact with classifier
- Classifiers are the additional text given to describe an artifact.
+ Beside the main artifact there can be additional files which are attached to the Maven project. Such attached filed can be recognized and accessed by their classifier.
-+---+
- artifact-name-1.0-bin.jar
- artifact-name-1.0-dev.jar
- artifact-name-1.0-prod.jar
-+---+
-
- From the above artifact names, classifiers can be located between the version and extension name of the artifact.
+ For example: from the following artifact names, the classifier is be located between the version and extension name of the artifact.
- *<<<bin>>> is used to describe that the artifact is a binary.
+ * <<<artifact-name-1.0.jar>>> the main jar which contains classes compiled without {{{http://maven.apache.org/plugins/maven-compiler-plugin/compile-mojo.html#debug}debugging}} information (such as linenumbers)
- *<<<dev>>> is used to describe that the artifact is for development.
+ * <<<artifact-name-1.0-debug.jar>>> the classified jar which contains classes compiled with {{{http://maven.apache.org/plugins/maven-compiler-plugin/compile-mojo.html#debug}debugging}} information, so will be smaller
- *<<<prod>>> is used to describe that the artifact is for production.
+ * <<<artifact-name-1.0-site.pdf>>> a pdf which contains an export of the site documentation.
[]
- To add classifier into your artifact for your deployment, set the text to the <<classifier>> parameter.
+ You can deploy the main artifact and the classified artifacts in a single run. Let's assume the original filename for the documentation is <<<site.pdf>>>:
+
++---+
+mvn ${project.groupId}:${project.artifactId}:${project.version}:deploy-file -Durl=http://localhost:8081/repomanager/ \
+ -DrepositoryId=some.id \
+ -Dfile=path/to/artifact-name-1.0.jar \
+ -DpomFile=path-to-your-pom.xml \
+ -Dfiles=path/to/artifact-name-1.0-debug.jar,path/to/site.pdf \
+ -Dclassifiers=debug,site \
+ -Dtypes=jar,pdf
++---+
+
+ If you only want to deploy the <<<debug>>>-jar and want to keep the classifier, you can execute the <<<deploy-file>>> like
+---+
-mvn ${project.groupId}:${project.artifactId}:${project.version}:deploy-file -Durl=file:///C:/m2-repo \
+mvn ${project.groupId}:${project.artifactId}:${project.version}:deploy-file -Durl=http://localhost:8081/repomanager/ \
-DrepositoryId=some.id \
-Dfile=path-to-your-artifact-jar \
-DpomFile=path-to-your-pom.xml \