|
|
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ |
|
|
|
|
|
<!-- Process this file with docbook-to-man to generate an nroff manual |
|
|
page: `docbook-to-man manpage.sgml > manpage.1'. You may view |
|
|
the manual page with: `docbook-to-man manpage.sgml | nroff -man | |
|
|
less'. A typical entry in a Makefile or Makefile.am is: |
|
|
|
|
|
manpage.1: manpage.sgml |
|
|
docbook-to-man $< > $@ |
|
|
--> |
|
|
|
|
|
<!ENTITY dhfirstname "<firstname>Yann</firstname>"> |
|
|
<!ENTITY dhsurname "<surname>Dirson</surname>"> |
|
|
<!-- Please adjust the date whenever revising the manpage. --> |
|
|
<!ENTITY dhdate "<date>mai 23, 2001</date>"> |
|
|
<!ENTITY dhemail "<email>dirson@debian.org</email>"> |
|
|
<!ENTITY dhusername "Yann Dirson"> |
|
|
<!ENTITY dhpackage "jam"> |
|
|
|
|
|
<!ENTITY debian "<productname>Debian GNU/Linux</productname>"> |
|
|
<!ENTITY gnu "<acronym>GNU</acronym>"> |
|
|
]> |
|
|
|
|
|
<refentry> |
|
|
<refentryinfo> |
|
|
<address> |
|
|
&dhemail; |
|
|
</address> |
|
|
<author> |
|
|
&dhfirstname; |
|
|
&dhsurname; |
|
|
</author> |
|
|
<copyright> |
|
|
<year>2001</year> |
|
|
<holder>&dhusername;</holder> |
|
|
</copyright> |
|
|
&dhdate; |
|
|
</refentryinfo> |
|
|
|
|
|
<refmeta> |
|
|
<refentrytitle>JAM</refentrytitle> |
|
|
<manvolnum>1</manvolnum> |
|
|
</refmeta> |
|
|
|
|
|
<refnamediv> |
|
|
<refname>Jam/MR</refname> |
|
|
<refpurpose>Make(1) Redux</refpurpose> |
|
|
</refnamediv> |
|
|
|
|
|
<refsynopsisdiv> |
|
|
<cmdsynopsis> |
|
|
<command>jam</command> |
|
|
|
|
|
<arg><option>-a</option></arg> |
|
|
<arg><option>-n</option></arg> |
|
|
<arg><option>-v</option></arg> |
|
|
|
|
|
<arg><option>-d <replaceable/debug/</option></arg> |
|
|
<arg><option>-f <replaceable/jambase/</option></arg> |
|
|
<arg><option>-j <replaceable/jobs/</option></arg> |
|
|
<arg><option>-o <replaceable/actionsfile/</option></arg> |
|
|
<arg><option>-s <replaceable/var/=<replaceable/value/</option></arg> |
|
|
<arg><option>-t <replaceable/target/</option></arg> |
|
|
|
|
|
<arg repeat><option><replaceable/target/</option></arg> |
|
|
</cmdsynopsis> |
|
|
</refsynopsisdiv> |
|
|
|
|
|
<refsect1> |
|
|
<title>DESCRIPTION</title> |
|
|
|
|
|
<para>Jam is a program construction tool, like make(1).</para> |
|
|
|
|
|
<para>Jam recursively builds target files from source files, using |
|
|
dependency information and updating actions expressed in the |
|
|
Jambase file, which is written in jam's own interpreted language. |
|
|
The default Jambase is compiled into jam and provides a |
|
|
boilerplate for common use, relying on a user-provide file |
|
|
"Jamfile" to enumerate actual targets and sources.</para> |
|
|
</refsect1> |
|
|
|
|
|
<refsect1> |
|
|
<title>OPTIONS</title> |
|
|
|
|
|
<variablelist> |
|
|
<varlistentry> |
|
|
<term><option/-a/</term> |
|
|
<listitem> |
|
|
<para>Build all targets anyway, even if they are up-to-date.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-d <replaceable/n/</option></term> |
|
|
<listitem> |
|
|
<para>Enable cummulative debugging levels from 1 to |
|
|
<replaceable/n/. Interesting values are: |
|
|
|
|
|
<glosslist> |
|
|
<glossentry><glossterm/1/ <glossdef><simpara/Show |
|
|
actions (the default)/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/2/ <glossdef><simpara/Show |
|
|
"quiet" actions and display all action |
|
|
text/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/3/ <glossdef><simpara>Show |
|
|
dependency analysis, and target/source |
|
|
timestamps/paths</simpara></glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/4/ <glossdef><simpara/Show shell |
|
|
arguments/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/5/ <glossdef><simpara/Show rule |
|
|
invocations and variable |
|
|
expansions/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/6/ <glossdef><simpara>Show |
|
|
directory/header file/archive |
|
|
scans</simpara></glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/7/ <glossdef><simpara/Show |
|
|
variable settings/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/8/ <glossdef><simpara/Show |
|
|
variable fetches/</glossdef></glossentry> |
|
|
|
|
|
<glossentry><glossterm/9/ <glossdef><simpara/Show |
|
|
variable manipulation, scanner |
|
|
tokens/</glossdef></glossentry> |
|
|
</glosslist> |
|
|
</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-d +<replaceable/n/</option></term> |
|
|
<listitem> |
|
|
<para>Enable debugging level <replaceable/n/.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option/-d 0/</term> |
|
|
<listitem> |
|
|
<para>Turn off all debugging levels. Only errors are not |
|
|
suppressed.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-f <replaceable/jambase/</option></term> |
|
|
<listitem> |
|
|
<para>Read <replaceable/jambase/ instead of using the |
|
|
built-in Jambase. Only one <option/-f/ flag is permitted, |
|
|
but the <replaceable/jambase/ may explicitly include other |
|
|
files.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-j <replaceable/n/</option></term> |
|
|
<listitem> |
|
|
<para>Run up to <replaceable/n/ shell commands concurrently |
|
|
(UNIX and NT only). The default is 1.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option/-n/</term> |
|
|
<listitem> |
|
|
<para>Don't actually execute the updating actions, but do |
|
|
everything else. This changes the debug level default to |
|
|
<option/-d2/.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-o <replaceable/file/</option></term> |
|
|
<listitem> |
|
|
<para>Write the updating actions to the specified file |
|
|
instead of running them (or outputting them, as on the |
|
|
Mac).</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-s <replaceable/var/=<replaceable/value/</option></term> |
|
|
<listitem> |
|
|
<para>Set the variable <replaceable/var/ to |
|
|
<replaceable/value/, overriding both internal variables and |
|
|
variables imported from the environment. </para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option>-t <replaceable/target/</option></term> |
|
|
<listitem> |
|
|
<para>Rebuild <replaceable/target/ and everything that |
|
|
depends on it, even if it is up-to-date.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
<varlistentry> |
|
|
<term><option/-v/</term> |
|
|
<listitem> |
|
|
<para>Print the version of jam and exit.</para> |
|
|
</listitem> |
|
|
</varlistentry> |
|
|
|
|
|
</variablelist> |
|
|
</refsect1> |
|
|
|
|
|
<refsect1> |
|
|
<title>SEE ALSO</title> |
|
|
|
|
|
<para>Jam is documented fully in HTML pages available on Debian |
|
|
systems from |
|
|
<filename>/usr/share/doc/jam/Jam.html</filename>.</para> |
|
|
</refsect1> |
|
|
|
|
|
<refsect1> |
|
|
<title>AUTHOR</title> |
|
|
|
|
|
<para>This manual page was created by &dhusername; &dhemail; from |
|
|
the <filename/Jam.html/ documentation, for the &debian; system |
|
|
(but may be used by others).</para> |
|
|
</refsect1> |
|
|
</refentry> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
