src/site/apt/introduction.apt

~~ 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.    
 
 ------
 Maven 2 Dependency Plugin
 ------

Maven 2 Dependency Plugin

  This plugin provides the capability to manipulate artifacts. Currently it can copy and/or unpack artifacts from local or remote repositories to a specified location.
  
  The plugin has the following {{{index.html}goals}}:

	*{{{copy-mojo.html}copy}}: takes a list of artifacts defined in the plugin configuration section and copies them to a specified location, renaming them or stripping the version if desired. This goal can resolve the artifacts from remote repositories if they don't exist in local.

	*{{{copy-dependencies-mojo.html}copy-dependencies}}: takes the list of direct dependencies and optionally transitive dependencies and copies them to a specified location, stripping the version if desired. This goal can also be run from the command line.

	*{{{unpack-mojo.html}unpack}}: like copy but unpacks.

	*{{{unpack-dependencies-mojo.html}unpack-dependencies}}: like copy-dependencies but unpacks.
	
	*{{{resolve-mojo.html}resolve}}: Tells Maven to resolve test scope dependencies and displays the version.
	
	*{{{resolve-mojo.html}sources}}: Tells Maven to resolve test scope dependencies and their source attachments, and displays the version.
	
	*{{{resolve-plugins-mojo.html}resolve-plugins}}: Tells Maven to resolve plugins and their dependencies.

        *{{{go-offline-mojo.html}go-offline}}: Tells Maven to resolve everything this project is dependent on (dependencies, plugins, reports) in preparation for going offline.

        *{{{purge-local-repository.html}purge-local-repository}}: Clears out all dependency-artifact files for the current
           project or projects from the local repository, and optionally re-resolves them.		

  Where appropriate, goals are able to detect if the artifacts already exist and don't copy/unpack again. 
  
  All goals are also able to handle artifacts with classifiers. This enables the capability to manipulate sources and test-jars for example.

  To see examples of how to use the plugin, click {{{howto.html}here}}.

  To see the goal details, click {{{index.html}here}}.