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>
