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 8manpage.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 232Local variables: 233sgml-omittag:t 234sgml-shorttag:t 235End: 236--> 237