.\" 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 \- Creates a link in /usr/share/maven-repo for an existing jar.
.SH SYNOPSIS
.B mh_linkjar
[\fI\,option\/\fR]... [\fI\,pom\/\fR] [\fI\,dest_jar\/\fR] [\fI\,link\/\fR]...
.SH DESCRIPTION
Create symlinks for a jar installed by other means. The symlinks created
include links to the jar in \fI\,/usr/share/maven\-repo\/\fP, at the correct
location for Maven.
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
[dest_jar] is the path of the installed jar, usually located in the
.IP
usr/share/java 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\-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