.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.1.
.TH MAVEN "1" "February 2021" "Maven Repo Helper version 1.7.1" "User Commands"
.SH NAME
Maven \- Installs a jar into /usr/share/maven-repo.
.SH SYNOPSIS
.B mh_installjar
[\fI\,option\/\fR]... [\fI\,pom\/\fR] [\fI\,jar\/\fR] [\fI\,link\/\fR]...
.SH DESCRIPTION
Installs the jar file in \fI\,/usr/share/maven\-repo\/\fP, at the correct location for
Maven. The jar is copied into the build directory.
It can also create additional links to the jar, usually located in
\fI\,/usr/share/java\/\fP.
.PP
Where
.IP
[pom] is the location of the POM associated with the jar to install.
.IP
GroupId, artifactId and version will be extracted from this file.
.IP
[jar] is the path to the jar to install, usually located in the build
.IP
folder.
.IP
[link] is an additional link to the jar to install, usually there should
.IP
be a link to usr/share/java/$jar.jar and
usr/share/java/$jar\-$version.jar to comply with the Java packaging
guidelines. Note that there is no need to specify those particular
links if the \fB\-\-java\-lib\fR option is used.
.SH OPTIONS
.HP
\fB\-h\fR \fB\-\-help\fR: show this text
.HP
\fB\-V\fR \fB\-\-version\fR: show the version
.HP
\fB\-p\fR<package> \fB\-\-package=\fR<package>: name of the Debian package which
.IP
will contain this jar file
.HP
\fB\-e\fR<version>, \fB\-\-set\-version=\fR<version>: set the version for the jar,
.IP
do not use the version declared in the POM file.
.HP
\fB\-r\fR<rules> \fB\-\-rules=\fR<rules>: path to the file containing the
.IP
rules to apply when cleaning the POM.
Optional, the default location is debian/maven.rules
Maven rules are used here to extract the groupId, artifactId
and version from the POM file.
.HP
\fB\-l\fR \fB\-\-java\-lib\fR: Optional, if given it will install the jar into
.IP
\fI\,/usr/share/java\/\fP to comply with the Debian Java specification.
The jar will be installed as /usr/share/java/$name\-$version.jar and
a versionless link /usr/share/java/$name.jar will point to it, as
well as the links installed in \fI\,/usr/share/maven\-repo\/\fP
.HP
\fB\-n\fR<name> \fB\-\-usj\-name=\fR<name>: Optional, the name to use when installing the
.IP
library in \fI\,/usr/share/java\/\fP when \fB\-\-java\-lib\fR is used.
Defaults to the artifact id found in the POM.
.HP
\fB\-j\fR<version> \fB\-\-usj\-version=\fR<version>: Optional, the version to use when
.IP
installing the library in \fI\,/usr/share/java\/\fP when \fB\-\-java\-lib\fR is used.
Defaults to the version found in the POM.
.HP
\fB\-s\fR \fB\-\-no\-usj\-versionless\fR: Optional, don't install the versionless link
.IP
in \fI\,/usr/share/java\/\fP.
This flag is used only when the \fB\-l\fR or \fB\-\-java\-lib\fR option is given.
.HP
\fB\-d\fR<path> \fB\-\-dest\-jar=\fR<path>: Optional, the destination for the real jar.
.IP
The other places where the jar appears, in the repository or in the
list of links, will be symlinks to this jar.
Defaults to /usr/share/java/$name\-$version.jar if \fB\-\-java\-lib\fR is used,
otherwise the jar is installed in the versioned path in the Maven repository.
.HP
\fB\-c\fR<classifier> \fB\-\-classifier=\fR<classifier>: Optional, the classifier for
.IP
the jar. Empty by default.
.HP
\fB\-v\fR \fB\-\-verbose\fR: show more information while running
.HP
\fB\-n\fR \fB\-\-no\-act\fR: don't actually do anything, just print the results
.HP
\fB\-\-skip\-clean\-pom\fR: don't clean the pom, assume that a previous action ran
.IP
mh_cleanpom with the correct options. mh_cleanpom is run only to extract
the groupId, artifactId and version of the jar
.PP
See also: mh_installpom(1), mh_installsite(1)