.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH MAVEN 1 "MAY 2004" Linux "User Manuals"
.SH NAME
maven \- builds a project
.SH SYNOPSIS
\fB maven\fR [\fIoptions\fR] [\fIgoal\fR [\fIgoal2\fR [\fIgoal3\fR] ...]]

.SH DESCRIPTION
.B Maven
is a Java project management and project comprehension tool. Maven is
based on the concept of a project object model (\fBPOM\fR) in that all the 
artifacts produced by Maven are a result of consulting a well defined model for
your project. Builds, documentation, source metrics, and source cross-references
are all controlled by your POM.

Maven has many goals , but in a nutshell Maven aims to make the developer's
life easier by providing a well defined project structure, well defined
development processes to follow, and a coherent body of documentation that
keeps your developers and clients apprised of what's happening with your
project. Maven alleviates a lot of what most developers consider drudgery and
lets them get on with the task at hand. This is essential in OSS projects where
there aren't many people dedicated to the task of documenting and propagating
the critical information about your project which is necessary in order to
attract potential new developers and clients.

.SH OPTIONS
Options must be given before the list of goals to execute.
.TP
\fB\-X\fR, \fB\-\-debug\fR
Produce execution debug output
.TP
\fB\-D\fR, \fB\-\-define\fR \fIarg\fR
Define a system property.
arg must be in the form: 
.br
maven.property.name=value
.TP
\fB\-d\fR, \fB\-\-dir\fR \fIarg\fR
Set the effective working directory.
.TP
\fB\-E\fR, \fB\-\-emacs\fR
Produce logging information without adornments.
.TP
\fB\-e\fR, \fB\-\-exception\fR
Produce exception stack traces.
.TP
\fB\-f\fR, \fB\-\-find\fR \fIarg\fR
Set the project file and effective working directory by finding the project.
file.
.TP
\fB\-g\fR, \fB\-\-goals\fR
Display available goals.
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help information.
.TP
\fB\-i\fR, \fB\-\-info\fR
Display system information.
.TP
\fB\-b\fR, \fB\-\-nobanner\fR
Suppress the logo banner.
.TP
\fB\-o\fR, \fB\-\-offline\fR
Build is happening offline.
.TP
\fB\-p\fR, \fB\-\-pom\fR \fIarg\fR
Set the project file.
.TP
\fB\-q\fR, \fB\-\-quitet\fR \fIarg\fR
Reduce execution output.
.TP
\fB\-v\fR, \fB\-\-version\fR
Display the version of \fBmaven\fR we are using.
.SH FILES
.I ./build.properties
.RS
Project wide configuration file.
.RE
.I ~/build.properties
.RS
Per user configuration file.
.SH ENVIRONMENT
.IP MAVEN_HOME
\fBMaven\fR's home directory.
.br
.IP MAVEN_REPO
\fBMaven\fR's local repository.
.SH BUGS
Probably. They can be found/added here:
.br
\fBhttp://jira.codehaus.org/BrowseProject.jspa?id=10030
.SH MAILING-LISTS
\fBUsers\fR:      maven-users@apache.org
.br
\fBDevelopers\fR: maven-dev@apache.org
.SH AUTHORS
Juancarlo Anez <juanco@apache.org>
.br
Stephane Bailliez <sbailliez@apache.org>
.br
Jeff Brekke <brekke@apache.org>
.br
Tom Copeland <tcopeland@apache.org>
.br
Eric Dobbs <eric@dobbse.net>
.br
dIon Gillard <dion@multitask.com.au>
.br
Pete Kazmier <pete-apache-dev@kazmier.com>
.br
Peter Lynch <plynch@apache.org>
.br
Glenn McAllister <glenn@somanetworks.com>
.br
Bob McWhirter <bob@werken.com>
.br
Geir Magnusson Jr. <geirm@optonline.net>
.br
Vincent Massol <vmassol@octo.com>
.br
Stéphane Mor <stephanemor@yahoo.fr>
.br
Kasper Nielsen <apache@kav.dk>
.br
Daniel Rall <dlr@finemaltcoding.com>
.br
Kurt Schrader <kschrader@karmalab.org>
.br
James Strachan <james_strachan@yahoo.co.uk>
.br
James Taylor <james@jamestaylor.org>
.br
Emmanuel Venisse <evenisse@ifrance.com>
.br
Jason van Zyl <jason@zenplex.com>
.br
Ben Walding <jakarta@walding.com>
.SH CVS HEADER
$Id$
.SH AUTHOR
This man page was originally written Stephane Mor <stephanemor@yahoo.fr>
and updated by Trygve Laugstoel <trygvis@apache.org>