File: mh_installjar.rst

package info (click to toggle)
maven-repo-helper 1.11
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 1,592 kB
  • sloc: java: 5,088; xml: 2,871; sh: 1,530; makefile: 60; perl: 12
file content (56 lines) | stat: -rw-r--r-- 3,080 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
mh\_installjar:
~~~~~~~~~~~~~~~

Usage:

::

    mh_installjar [option]... [pom] [jar] [link]...

Installs the jar file in /usr/share/maven-repo, at the correct location
for Maven. Both the native version and the Debian version of the jar are
installed. It can also create additional links to the jar, usually
placed in /usr/share/java.

Where:

::

    [pom] is the location of the POM associated with the jar to install.
      GroupId, artifactId and version will be extracted from this file.
    [jar] is the path to the jar to install, usually located in the build
      folder.
    [link] is an additional link to the jar to install, usually there should
      be a link to usr/share/java/.jar and
      usr/share/java/-.jar to comply with the Java packaging
      guidelines. Note that there is no need to specify those particular
      links if the --java-lib option is used.

Options:

::

    -h --help: show this text
    -V --version: show the version
    -p<package> --package=<package>: name of the Debian package which will contain this jar file
    -e<version>, --set-version=<version>: set the version for the jar, do not use the version declared in the POM file.
    -r<rules> --rules=<rules>: path to the file containing the 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.
    -l --java-lib: Optional, if given it will install the jar into /usr/share/java 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 /usr/share/maven-repo
    -n<name> --usj-name=<name>: Optional, the name to use when installing the library in /usr/share/java when --java-lib is used.
      Defaults to the artifact id found in the POM.
    -j<version> --usj-version=<version>: Optional, the version to use when installing the library in /usr/share/java when --java-lib is used.
      Defaults to the version found in the POM.
    -s --no-usj-versionless: Optional, don't install the versionless link in /usr/share/java.
      This flag is used only when the -l or --java-lib option is given.
    -d<path> --dest-jar=<path>: Optional, the destination for the real jar.
      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 --java-lib is used, otherwise the jar is installed in the versioned path in the Maven repository.
    -c<classifier> --classifier=<classifier>: Optional, the classifier for the jar. Empty by default.
    -v --verbose: show more information while running
    -n --no-act: don't actually do anything, just print the results
    --skip-clean-pom: don't clean the pom, assume that a previous action ran mh_cleanpom with the correct options.
      mh_cleanpom is run only to extract the groupId, artifactId and version of the jar