NAME

       jh_build - compile java sources in the absence of a (useful) upstream build system

SYNOPSIS

       jh_build [debhelper options]

       jh_build [debhelper options] jarfile source [... source]

DESCRIPTION

FILES

       debian/javabuild
           A file consisting of each build to perform.  One build per line where each line consists of:

           jarfile source [... source]

           Where  jarfile  is  the  name  of  the  jar file to be built and source is a source file or directory
           containing source files.

OPTIONS

       --main=main-class
           Set the Main-Class attribute in the manifest of the generated jar file(s) to main-class.  This  makes
           java -jar generated-jar-file run that class.

       --java-home=home
           Use home as JAVA_HOME (overrides the JAVA_HOME environment variable).

       -J, --javadoc, --no-javadoc
           Whether or not to build javadoc for the jar files.  The default is to generate javadoc along with the
           jar files.

       --javacopts=options
           Pass  options  to javac (when invoking javac).  The options value is a space-separate list of options
           (remember to quote the argument to avoid the shell interpreting the value).

       --javadoc-opts=options
           Pass options to javadoc (when invoking javadoc).  The options  value  is  a  space-separate  list  of
           options (remember to quote the argument to avoid the shell interpreting the value).

       --clean
           If  passed, jh_build will clean up after itself.  This is called by jh_clean(1) and using jh_clean(1)
           is recommended over calling jh_build with --clean directly.

ENVIRONMENT

       JAVA_HOME
           If set (and --java-home is omitted), it determines the location of the  java  home  for  finding  the
           javac(1) compiler, javadoc(1) compiler and the jar(1) utility.

           If  the  environment  variable  is  unset  and  --java-home is omitted, then the default java home is
           /usr/lib/jvm/default-java

       CLASSPATH
           If set, this is the classpath used during compilation of the source code.

       JH_JAR_EXTRA
           A space separated list of extra files or directories to include in the generated jar file(s).

           Can be omitted if no extra files need to be included.

EXAMPLE

         jh_build foo.jar src/java/main

       Will generate foo.jar from compiling all the java files in src/java/main and generate a javadoc from it.

SEE ALSO

       debhelper(7)

       This program is a part of javahelper  and  uses  debhelper  as  backend.  There  are  also  tutorials  in
       /usr/share/doc/javahelper.

0.79                                               2023-07-29                                        JH_BUILD(1)