Author: rfscholte
Date: Sat Jul 13 18:01:39 2013
New Revision: 1502830
URL: http://svn.apache.org/r1502830
Log:
[MINSTALL-95] Enhance documentation of install-file
Modified:
maven/site/trunk/content/apt/guides/mini/guide-3rd-party-jars-local.apt
Modified:
maven/site/trunk/content/apt/guides/mini/guide-3rd-party-jars-local.apt
URL:
http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guide-3rd-party-jars-local.apt?rev=1502830&r1=1502829&r2=1502830&view=diff
==============================================================================
--- maven/site/trunk/content/apt/guides/mini/guide-3rd-party-jars-local.apt
(original)
+++ maven/site/trunk/content/apt/guides/mini/guide-3rd-party-jars-local.apt Sat
Jul 13 18:01:39 2013
@@ -2,17 +2,19 @@
Guide to installing 3rd party JARs
------
Jason van Zyl
+ Robert Scholte
------
- 12 October 2005
+ 13 July 2013
------
Guide to installing 3rd party JARs
- Often times you will have 3rd party JARs that you need to put in your local
repository for use in your
- builds. The JARs must be placed in the local repository in the correct place
in order for it to be correctly
- picked up by Maven. To make this easier, and less error prone, we have
provide a goal in the install plug-in
- which should make this relatively painless. To install a JAR in the local
repository use the following
- command:
+ Although rarely, but sometimes you will have 3rd party JARs that you need to
put in your local repository for use in your
+ builds, since they don't exist in any public repository like
{{{http://search.maven.org}Maven Central}}.
+ The JARs must be placed in the local repository in the correct place in order
for it to be correctly
+ picked up by Apache Maven. To make this easier, and less error prone, we have
provide a goal in the
+
{{{http://maven.apache.org/plugins/maven-install-plugin/}maven-install-plugin}}
which should make this relatively painless.
+ To install a JAR in the local repository use the following command:
+----+
@@ -20,3 +22,22 @@ mvn install:install-file -Dfile=<path-to
-DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=<packaging>
+----+
+
+ If there's a pom-file as well, you can install it with the following command:
+
++----+
+
+mvn install:install-file -Dfile=<path-to-file> -DpomFile=<path-to-pomfile>
+
++----+
+
+ With version 2.5 of the maven-install-plugin it gets even better. If the JAR
was built by Apache Maven, it'll contain a
+ pom.xml in a subfolder of the META-INF directory, which will be read by
default. In that case, all you need to do is:
+
++----+
+
+mvn install:install-file -Dfile=<path-to-file>
+
++----+
+
+
