mirror of
https://github.com/boostorg/build.git
synced 2026-02-16 13:22:11 +00:00
237 lines
7.0 KiB
Plaintext
237 lines
7.0 KiB
Plaintext
<!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>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
End:
|
|
-->
|