ceph/src/boost/tools/build/src/engine/debian/jam.man.sgml

   1 <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
   2
   3 <!-- Process this file with docbook-to-man to generate an nroff manual
   4      page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
   5      the manual page with: `docbook-to-man manpage.sgml | nroff -man |
   6      less'.  A typical entry in a Makefile or Makefile.am is:
   7
   8 manpage.1: manpage.sgml
   9         docbook-to-man $< > $@
  10   -->
  11
  12   <!ENTITY dhfirstname "<firstname>Yann</firstname>">
  13   <!ENTITY dhsurname   "<surname>Dirson</surname>">
  14   <!-- Please adjust the date whenever revising the manpage. -->
  15   <!ENTITY dhdate      "<date>mai 23, 2001</date>">
  16   <!ENTITY dhemail     "<email>dirson@debian.org</email>">
  17   <!ENTITY dhusername  "Yann Dirson">
  18   <!ENTITY dhpackage   "jam">
  19
  20   <!ENTITY debian      "<productname>Debian GNU/Linux</productname>">
  21   <!ENTITY gnu         "<acronym>GNU</acronym>">
  22 ]>
  23
  24 <refentry>
  25   <refentryinfo>
  26     <address>
  27       &dhemail;
  28     </address>
  29     <author>
  30       &dhfirstname;
  31       &dhsurname;
  32     </author>
  33     <copyright>
  34       <year>2001</year>
  35       <holder>&dhusername;</holder>
  36     </copyright>
  37     &dhdate;
  38   </refentryinfo>
  39
  40   <refmeta>
  41     <refentrytitle>JAM</refentrytitle>
  42     <manvolnum>1</manvolnum>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>Jam/MR</refname>
  47     <refpurpose>Make(1) Redux</refpurpose>
  48   </refnamediv>
  49
  50   <refsynopsisdiv>
  51     <cmdsynopsis>
  52       <command>jam</command>
  53
  54       <arg><option>-a</option></arg>
  55       <arg><option>-n</option></arg>
  56       <arg><option>-v</option></arg>
  57
  58       <arg><option>-d <replaceable/debug/</option></arg>
  59       <arg><option>-f <replaceable/jambase/</option></arg>
  60       <arg><option>-j <replaceable/jobs/</option></arg>
  61       <arg><option>-o <replaceable/actionsfile/</option></arg>
  62       <arg><option>-s <replaceable/var/=<replaceable/value/</option></arg>
  63       <arg><option>-t <replaceable/target/</option></arg>
  64
  65       <arg repeat><option><replaceable/target/</option></arg>
  66     </cmdsynopsis>
  67   </refsynopsisdiv>
  68
  69   <refsect1>
  70     <title>DESCRIPTION</title>
  71
  72     <para>Jam is a program construction tool, like make(1).</para>
  73
  74     <para>Jam recursively builds target files from source files, using
  75     dependency information and updating actions expressed in the
  76     Jambase file, which is written in jam's own interpreted language.
  77     The default Jambase is compiled into jam and provides a
  78     boilerplate for common use, relying on a user-provide file
  79     "Jamfile" to enumerate actual targets and sources.</para>
  80   </refsect1>
  81
  82   <refsect1>
  83     <title>OPTIONS</title>
  84
  85     <variablelist>
  86       <varlistentry>
  87         <term><option/-a/</term>
  88         <listitem>
  89           <para>Build all targets anyway, even if they are up-to-date.</para>
  90         </listitem>
  91       </varlistentry>
  92
  93       <varlistentry>
  94         <term><option>-d <replaceable/n/</option></term>
  95         <listitem>
  96           <para>Enable cummulative debugging levels from 1 to
  97             <replaceable/n/. Interesting values are:
  98
  99             <glosslist>
 100               <glossentry><glossterm/1/ <glossdef><simpara/Show
 101               actions (the default)/</glossdef></glossentry>
 102
 103               <glossentry><glossterm/2/ <glossdef><simpara/Show
 104               "quiet" actions and display all action
 105               text/</glossdef></glossentry>
 106
 107               <glossentry><glossterm/3/ <glossdef><simpara>Show
 108               dependency analysis, and target/source
 109               timestamps/paths</simpara></glossdef></glossentry>
 110
 111               <glossentry><glossterm/4/ <glossdef><simpara/Show shell
 112               arguments/</glossdef></glossentry>
 113
 114               <glossentry><glossterm/5/ <glossdef><simpara/Show rule
 115               invocations and variable
 116               expansions/</glossdef></glossentry>
 117
 118               <glossentry><glossterm/6/ <glossdef><simpara>Show
 119               directory/header file/archive
 120               scans</simpara></glossdef></glossentry>
 121
 122               <glossentry><glossterm/7/ <glossdef><simpara/Show
 123               variable settings/</glossdef></glossentry>
 124
 125               <glossentry><glossterm/8/ <glossdef><simpara/Show
 126               variable fetches/</glossdef></glossentry>
 127
 128               <glossentry><glossterm/9/ <glossdef><simpara/Show
 129               variable manipulation, scanner
 130               tokens/</glossdef></glossentry>
 131             </glosslist>
 132           </para>
 133         </listitem>
 134       </varlistentry>
 135
 136       <varlistentry>
 137         <term><option>-d +<replaceable/n/</option></term>
 138         <listitem>
 139           <para>Enable debugging level <replaceable/n/.</para>
 140         </listitem>
 141       </varlistentry>
 142
 143       <varlistentry>
 144         <term><option/-d 0/</term>
 145         <listitem>
 146           <para>Turn off all debugging levels. Only errors are not
 147           suppressed.</para>
 148         </listitem>
 149       </varlistentry>
 150
 151       <varlistentry>
 152         <term><option>-f <replaceable/jambase/</option></term>
 153         <listitem>
 154           <para>Read <replaceable/jambase/ instead of using the
 155           built-in Jambase. Only one <option/-f/ flag is permitted,
 156           but the <replaceable/jambase/ may explicitly include other
 157           files.</para>
 158         </listitem>
 159       </varlistentry>
 160
 161       <varlistentry>
 162         <term><option>-j <replaceable/n/</option></term>
 163         <listitem>
 164           <para>Run up to <replaceable/n/ shell commands concurrently
 165           (UNIX and NT only). The default is 1.</para>
 166         </listitem>
 167       </varlistentry>
 168
 169       <varlistentry>
 170         <term><option/-n/</term>
 171         <listitem>
 172           <para>Don't actually execute the updating actions, but do
 173           everything else. This changes the debug level default to
 174           <option/-d2/.</para>
 175         </listitem>
 176       </varlistentry>
 177
 178       <varlistentry>
 179         <term><option>-o <replaceable/file/</option></term>
 180         <listitem>
 181           <para>Write the updating actions to the specified file
 182           instead of running them (or outputting them, as on the
 183           Mac).</para>
 184         </listitem>
 185       </varlistentry>
 186
 187       <varlistentry>
 188         <term><option>-s <replaceable/var/=<replaceable/value/</option></term>
 189         <listitem>
 190           <para>Set the variable <replaceable/var/ to
 191           <replaceable/value/, overriding both internal variables and
 192           variables imported from the environment. </para>
 193         </listitem>
 194       </varlistentry>
 195
 196       <varlistentry>
 197         <term><option>-t <replaceable/target/</option></term>
 198         <listitem>
 199           <para>Rebuild <replaceable/target/ and everything that
 200           depends on it, even if it is up-to-date.</para>
 201         </listitem>
 202       </varlistentry>
 203
 204       <varlistentry>
 205         <term><option/-v/</term>
 206         <listitem>
 207           <para>Print the version of jam and exit.</para>
 208         </listitem>
 209       </varlistentry>
 210
 211     </variablelist>
 212   </refsect1>
 213
 214   <refsect1>
 215     <title>SEE ALSO</title>
 216
 217     <para>Jam is documented fully in HTML pages available on Debian
 218     systems from
 219     <filename>/usr/share/doc/jam/Jam.html</filename>.</para>
 220   </refsect1>
 221
 222   <refsect1>
 223     <title>AUTHOR</title>
 224
 225     <para>This manual page was created by &dhusername; &dhemail; from
 226     the <filename/Jam.html/ documentation, for the &debian; system
 227     (but may be used by others).</para>
 228   </refsect1>
 229 </refentry>
 230
 231 <!-- Keep this comment at the end of the file
 232 Local variables:
 233 sgml-omittag:t
 234 sgml-shorttag:t
 235 End:
 236 -->