jh_installlibs1

Usage

Overview

For library packages Debian Java policy currently requires that the libraries be installed to /usr/share/java in a versioned format and with an unversioned symlink. jh_installlibs will take a jar and correctly install it.

As with debhelper programs, this can either take a jar as a parameter, or read a list of jars from a file in the Debian directory. It also follows the -p, -i and -a semantics of debhelper for selecting which packages to install the jar to. When operating on a package, jh_installlibs will read the list of library jars from debian/package.jlibs or debian/jlibs.

The jlibs file is a list of jars to install, one per line, and works exactly the same as listing them on the command line. Each jar is installed to debian/package/usr/share/java/ in the appropriate versioned and unversioned forms.

If the jars built by upstream already contain the version number, this will be stripped before installing. jh_installlibs will also try to strip the upstream version number of any ds or dfsg suffix. Other version-mangling options or explicit version numbers can also be provided.

Files

debian/package.jlibs, debian/jlibs

The jlibs file is a list of jars to install, one per line, and works exactly the same as listing them on the command line. Each jar is installed to debian/package/usr/share/java/ in the appropriate versioned and unversioned forms.

Note that unlike most other debhelper commands, jh_installlibs will use debian/jlibs as a fallback configuration file for all packages that it acts on. Other debhelper commands usually only apply this fallback to the "main package".

Options

--no-mangle

Do not try to sanitize the upstream version number.

--upstream-version=version

Use version as the upstream version. This option implies --no-mangle

--version-strip=regex

Use regex instead of the built-in rules for sanitizing the upstream version number.

This option is ignored when --no-mangle is passed (or implied by another option).

Beyond the above, jh_classpath also accepts the shared debhelper options documented in debhelper(7).