Author: dennisl Date: Sun Mar 22 15:16:34 2009 New Revision: 757199 URL: http://svn.apache.org/viewvc?rev=757199&view=rev Log: o Add an example on how to install secondary artifacts.
Added: maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt (with props) Modified: maven/plugins/trunk/maven-install-plugin/src/site/apt/index.apt maven/plugins/trunk/maven-install-plugin/src/site/apt/usage.apt maven/plugins/trunk/maven-install-plugin/src/site/site.xml Added: maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt?rev=757199&view=auto ============================================================================== --- maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt (added) +++ maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt Sun Mar 22 15:16:34 2009 @@ -0,0 +1,49 @@ + ------ + Installing Secondary Artifacts + ------ + Dennis Lundberg + ------ + 2009-03-22 + ------ + +~~ Licensed to the Apache Software Foundation (ASF) under one +~~ or more contributor license agreements. See the NOTICE file +~~ distributed with this work for additional information +~~ regarding copyright ownership. The ASF licenses this file +~~ to you under the Apache License, Version 2.0 (the +~~ "License"); you may not use this file except in compliance +~~ with the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, +~~ software distributed under the License is distributed on an +~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +~~ KIND, either express or implied. See the License for the +~~ specific language governing permissions and limitations +~~ under the License. + +~~ NOTE: For help with the syntax of this file, see: +~~ http://maven.apache.org/doxia/references/apt-format.html + +Installing Secondary Artifacts + + Sometimes you need to install secondary artifacts after the main artifact has + been installed in your local repository. To install a secondary artifact you + need to use the <<<classifier>>> parameter to classify the secondary artifact. + + Let us assume that you want to install the sources for an old artifact, like + commons-logging-1.0.3. The + {{{http://repo1.maven.org/maven2/commons-logging/commons-logging/1.0.3/}central repository}} + only has the main artifact and a <<<-javadoc>>> artifact for that version. + Package up the sources into a JAR file on your local disk and then run the + following command: + ++---+ +mvn install:install-file -Dfile=path-to-commons-logging-sources.jar \ + -DgroupId=commons-logging \ + -DartifactId=commons-logging \ + -Dversion=1.0.3 \ + -Dpackaging=jar \ + -Dclassifier=sources ++---+ Propchange: maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt ------------------------------------------------------------------------------ svn:eol-style = native Propchange: maven/plugins/trunk/maven-install-plugin/src/site/apt/examples/installing-secondary-artifacts.apt ------------------------------------------------------------------------------ svn:keywords = Date Revision Author Id Modified: maven/plugins/trunk/maven-install-plugin/src/site/apt/index.apt URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-install-plugin/src/site/apt/index.apt?rev=757199&r1=757198&r2=757199&view=diff ============================================================================== --- maven/plugins/trunk/maven-install-plugin/src/site/apt/index.apt (original) +++ maven/plugins/trunk/maven-install-plugin/src/site/apt/index.apt Sun Mar 22 15:16:34 2009 @@ -88,4 +88,6 @@ * {{{examples/specific-local-repo.html}Installing an Artifact to a Specific Local Repository Path}} + * {{{examples/installing-secondary-artifacts.html}Installing Secondary Artifacts}} + [] Modified: maven/plugins/trunk/maven-install-plugin/src/site/apt/usage.apt URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-install-plugin/src/site/apt/usage.apt?rev=757199&r1=757198&r2=757199&view=diff ============================================================================== --- maven/plugins/trunk/maven-install-plugin/src/site/apt/usage.apt (original) +++ maven/plugins/trunk/maven-install-plugin/src/site/apt/usage.apt Sun Mar 22 15:16:34 2009 @@ -65,7 +65,8 @@ groupId can be considered if the groupId is not specified further for the current project or on the command line. - * the optional <<<classifier>>> parameter can be used to install secondary artifacts for a project, + * the optional <<<classifier>>> parameter can be used to + {{{examples/installing-secondary-artifacts.html}install secondary artifacts}} for a project, like a <<<javadoc>>> or <<<sources>>> JAR. If a classifier is not given, Maven assumes the file is the main artifact for the project. Modified: maven/plugins/trunk/maven-install-plugin/src/site/site.xml URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-install-plugin/src/site/site.xml?rev=757199&r1=757198&r2=757199&view=diff ============================================================================== --- maven/plugins/trunk/maven-install-plugin/src/site/site.xml (original) +++ maven/plugins/trunk/maven-install-plugin/src/site/site.xml Sun Mar 22 15:16:34 2009 @@ -33,6 +33,7 @@ <item name="Creating Checksums" href="examples/installing-checksums.html"/> <item name="Updating Release Info" href="examples/update-release-info.html"/> <item name="Installing to a Specific Local Repository Path" href="examples/specific-local-repo.html"/> + <item name="Installing Secondary Artifacts" href="examples/installing-secondary-artifacts.html"/> </menu> </body> </project>