.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "JH_BUILD 1"
.TH JH_BUILD 1 "2023-07-29" "0.79" "Javahelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
jh_build \- compile java sources in the absence of a (useful) upstream build system
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBjh_build\fR [\fIdebhelper options\fR]
.PP
\&\fBjh_build\fR [\fIdebhelper options\fR] \fIjarfile\fR \fIsource\fR [... \fIsource\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
.SH "FILES"
.IX Header "FILES"
.IP "debian/javabuild" 4
.IX Item "debian/javabuild"
A file consisting of each build to perform.  One build per line
where each line consists of:
.Sp
\&\fIjarfile\fR \fIsource\fR [... \fIsource\fR]
.Sp
Where \fIjarfile\fR is the name of the jar file to be built and \fIsource\fR is
a source file or directory containing source files.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-\-main=\fR\fImain-class\fR" 4
.IX Item "--main=main-class"
Set the \fBMain-Class\fR attribute in the manifest of the generated jar file(s) to \fImain-class\fR.
This makes \fBjava \-jar \f(BIgenerated-jar-file\fB\fR run that class.
.IP "\fB\-\-java\-home=\fR\fIhome\fR" 4
.IX Item "--java-home=home"
Use \fIhome\fR as \fB\s-1JAVA_HOME\s0\fR (overrides the \fB\s-1JAVA_HOME\s0\fR environment variable).
.IP "\fB\-J\fR, \fB\-\-javadoc\fR, \fB\-\-no\-javadoc\fR" 4
.IX Item "-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.
.IP "\fB\-\-javacopts=\fR\fIoptions\fR" 4
.IX Item "--javacopts=options"
Pass \fIoptions\fR to javac (when invoking javac).  The \fIoptions\fR value
is a space-separate list of options (remember to quote the argument to avoid the shell
interpreting the value).
.IP "\fB\-\-javadoc\-opts=\fR\fIoptions\fR" 4
.IX Item "--javadoc-opts=options"
Pass \fIoptions\fR to javadoc (when invoking javadoc).  The \fIoptions\fR value
is a space-separate list of options (remember to quote the argument to avoid the shell
interpreting the value).
.IP "\fB\-\-clean\fR" 4
.IX Item "--clean"
If passed, \fBjh_build\fR will clean up after itself.  This is called by
\&\fBjh_clean\fR\|(1) and using \fBjh_clean\fR\|(1) is recommended over calling
\&\fBjh_build\fR with \fB\-\-clean\fR directly.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.IP "\fB\s-1JAVA_HOME\s0\fR" 4
.IX Item "JAVA_HOME"
If set (and \fB\-\-java\-home\fR is omitted), it determines the location of the java home
for finding the \fBjavac\fR\|(1) compiler, \fBjavadoc\fR\|(1) compiler and the \fBjar\fR\|(1) utility.
.Sp
If the environment variable is unset and \fB\-\-java\-home\fR is omitted, then the default
java home is \fI/usr/lib/jvm/default\-java\fR
.IP "\s-1CLASSPATH\s0" 4
.IX Item "CLASSPATH"
If set, this is the classpath used during compilation of the source code.
.IP "\s-1JH_JAR_EXTRA\s0" 4
.IX Item "JH_JAR_EXTRA"
A space separated list of extra files or directories to include in the generated jar file(s).
.Sp
Can be omitted if no extra files need to be included.
.SH "EXAMPLE"
.IX Header "EXAMPLE"
.Vb 1
\&  jh_build foo.jar src/java/main
.Ve
.PP
Will generate \fBfoo.jar\fR from compiling all the java files in \fIsrc/java/main\fR
and generate a javadoc from it.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdebhelper\fR\|(7)
.PP
This program is a part of javahelper and uses debhelper as backend. There are
also tutorials in /usr/share/doc/javahelper.