Helix SwarmHelix Swarm
Loading...

Jambase.html

  • //
  • guest/
  • dick_dunbar/
  • jam/
  • src/
  • Jambase.html #2
  • View
  • Commits
  • Open Download .zip Download (55 KB) 
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
  2. <HTML>
  3.  
  4. <HEAD>
  5. 	<META HTTP-EQUIV="Content-Type" CONTENT="text/html;CHARSET=iso-8859-1">
  6. <META NAME="VPSiteProject" CONTENT="file:///D|/rld/Docs/Project.vpp">
  7.  
  8. 	<META NAME="GENERATOR" Content="Visual Page 2.0 for Windows">
  9. 	<TITLE>Jambase Reference</TITLE>
  10. </HEAD>
  11.  
  12. <BODY>
  13.  
  14. <P ALIGN="CENTER"><A HREF="http://ddunbar/Analytics/Jam/Jam.html"> Jam</A>
  15. <H1 ALIGN="CENTER"><A NAME="TOP"></A> Jambase Reference</H1>
  16. <P>Jambase is a base set of Jam rules which provide roughly make(1)-like functionality for <A HREF="Jam.html"><B>jam</B></A>,
  17. the Jam executable program. This document, which started out as the Jambase(5) man page, is a reference guide to
  18. the <A HREF="#RULES">rules</A>, <A HREF="#PSEUDOTARGETS">pseudotargets</A>, and <A HREF="#VARS">variables</A> defined
  19. in Jambase for use in Jamfiles.</P>
  20. <P>For further information see:</P>
  21.  
  22. <UL>
  23. 	<LI><A HREF="Jamfile.html">Using Jamfiles, Jamrules and Jambase</A>
  24. 	<LI><A HREF="Jam.html">The Jam Executable Program</A>
  25. </UL>
  26.  
  27. <P>Jam documentation and source are available from the <A HREF="http://public.perforce.com/public/index.html">Perforce
  28. Public Depot</A>. <BR>
  29. For detailed information about any of the rules summarized below, see the <A HREF="Jambase">Jambase</A> file itself.</P>
  30. <P>
  31. <HR ALIGN="CENTER">
  32.  
  33. <H2><A NAME="RULES"></A> Jambase Rules</H2>
  34. <P><B>ToDo: </B>makeString, makeDirName, Archive, ShrLibrary, Libs, etc.</P>
  35. <P><B>Always </B><I>target target ... </I>; <B>builtin</B>
  36.  
  37. <BLOCKQUOTE>
  38. 	<P>Always build these targets. Jambase example:<BR>
  39. 	<FONT SIZE="2" FACE="Courier New, Courier">Always clean uninstall ;</FONT></P>
  40. </BLOCKQUOTE>
  41.  
  42. <P><B>Archive</B> <I>library</I> : <I>sources</I> ;
  43.  
  44. <BLOCKQUOTE>
  45. 	<P>Compiles <I>sources</I> and archives the targets into the archive <I>library.</I> The intermediate <I>objects</I>
  46. 	are deleted. Calls Objects and ArchiveFromObjects.</P>
  47. 	<P>If Library is invoked with no suffix on <I>library</I>, the $(SUFLIB) suffix is used.<BR>
  48. 	If Library is invoked with a suffix on <I>library<B>, </B></I>it is corrected to the platform $(SUFLIB).<BR>
  49. 	<B>ToDo: </B>Is the &quot;lib&quot; prefix added? Ignored? What name is used in the link flag (-l) ?</P>
  50. </BLOCKQUOTE>
  51.  
  52. <P><B>As</B> <I>obj.o</I> : <I>source.s</I> ;</P>
  53.  
  54. <BLOCKQUOTE>
  55. 	<P>Assemble the file <I>source.s.</I> Called by the Object rule.
  56. </BLOCKQUOTE>
  57.  
  58. <P><B>Bulk</B> <I>directory</I> : <I>sources</I> ;
  59.  
  60. <BLOCKQUOTE>
  61. 	<P>Copies <I>sources</I> into <I>directory.</I>
  62. </BLOCKQUOTE>
  63.  
  64. <P><B>Cc</B> <I>object</I> : <I>source</I> ;
  65.  
  66. <BLOCKQUOTE>
  67. 	<P>Compile the file <I>source</I> into <I>object,</I> using the C compiler $(CC), its flags $(CCFLAGS) and $(OPTIM),
  68. 	and the header file directories $(HDRS). Called by the Object rule.
  69. </BLOCKQUOTE>
  70.  
  71. <P><B>CcFlags </B><I>flags </I>; <B>Not implemented.</B></P>
  72. <P><B>C++</B> <I>obj.o</I> : <I>source.cpp</I> ;
  73.  
  74. <BLOCKQUOTE>
  75. 	<P>Compile the C++ source file <I>source.cpp.</I> Called by the Object rule.
  76. </BLOCKQUOTE>
  77.  
  78. <P><B>C++Flags </B><I>flags</I> ; <B>Not implemented.</B></P>
  79. <P><B>Chmod</B> <I>target</I> ;
  80.  
  81. <BLOCKQUOTE>
  82. 	<P><I>(Unix only.)</I> Change file permissions on <I>target</I> to target-specific $(MODE) value set by Link, File,
  83. 	Install*, and Shell rules.
  84. </BLOCKQUOTE>
  85.  
  86. <P><B>Clean</B> <I>clean</I> : <I>targets</I> ;
  87.  
  88. <BLOCKQUOTE>
  89. 	<P>Removes existing <I>targets</I> when <I>clean</I> is built. clean is not a dependency of all, and must be built
  90. 	explicitly for targets to be removed.
  91. </BLOCKQUOTE>
  92.  
  93. <P><B>Defines </B><I>names </I>;
  94.  
  95. <BLOCKQUOTE>
  96. 	<P>Add <I>names</I> to the list of preprocessor defines to variable DEFINES.</P>
  97. </BLOCKQUOTE>
  98.  
  99. <P><B>Depends</B> <I>targets1</I> : <I>targets2 </I>; <B>builtin</B>
  100.  
  101. <BLOCKQUOTE>
  102. 	<P>Builds a direct dependency. Each of <I>targets1</I> depend on each of <I>targets2</I>.<BR>
  103. 	<I>targets1</I> will be rebuilt if <I>targets2</I> are rebuilt or are newer than <I>targets1</I>.<BR>
  104. 	Jambase examples:<BR>
  105. 	<FONT SIZE="2" FACE="Arial, Helvetica">Depends all : shell files lib exe obj ;<BR>
  106. 	Depends all shell files lib exe obj : first ;</FONT></P>
  107. </BLOCKQUOTE>
  108.  
  109. <P><B>Echo </B><I>args </I>; <B>builtin</B>
  110.  
  111. <BLOCKQUOTE>
  112. 	<P>Blurts out message <I>args</I> to stdout.</P>
  113. </BLOCKQUOTE>
  114.  
  115. <P><B>Exit </B><I>args </I>; <B>builtin</B>
  116.  
  117. <BLOCKQUOTE>
  118. 	<P>Blurts out message args, and exits with a failure status.</P>
  119. </BLOCKQUOTE>
  120.  
  121. <P><B>FDefines</B> <I>defines</I> ;
  122.  
  123. <BLOCKQUOTE>
  124. 	<P>Expands a list of definitions into a list of compiler (or preprocessor) switches (such as -D<I>symbol</I>=<I>val</I>
  125. 	on Unix) to pass the definitions.
  126. </BLOCKQUOTE>
  127.  
  128. <P><B>File</B> <I>target</I> : <I>source</I> ;
  129.  
  130. <BLOCKQUOTE>
  131. 	<P>Copies <I>source</I> into <I>target.</I>
  132. </BLOCKQUOTE>
  133.  
  134. <P><B>FAppendSuffix</B> <I>f1 f2 ... </I>: $(SUF) ;
  135.  
  136. <BLOCKQUOTE>
  137. 	<P>Return $(&lt;) with suffixes.<B> </B>Example:<B><BR>
  138. 	</B><FONT SIZE="2" FACE="Courier New, Courier">FAppendSuffix yacc lex foo.bat : $(SUFEXE) ;<BR>
  139. 	returns (yacc.exe,lex.exe,foo.bat) on Windows. <BR>
  140. 	returns (yacc, lex, foo.bat) on Unix</FONT></P>
  141. </BLOCKQUOTE>
  142.  
  143. <P><B>FDefines</B> <I>...</I> ;
  144.  
  145. <BLOCKQUOTE>
  146. 	<P>Unknown</P>
  147. </BLOCKQUOTE>
  148.  
  149. <P><B>FDirName</B> <I>d1 d2 ...</I> ;
  150.  
  151. <BLOCKQUOTE>
  152. 	<P>Return path from root to dir.<B> </B><FONT SIZE="2" FACE="Courier New, Courier">d1/d2</FONT> on unix; <FONT
  153. 	SIZE="2" FACE="Courier New, Courier">d1\d2</FONT> on windows.</P>
  154. </BLOCKQUOTE>
  155.  
  156. <P><B>FGrist</B> <I>d1 d2 ...</I> ;
  157.  
  158. <BLOCKQUOTE>
  159. 	<P>Return <FONT SIZE="2" FACE="Courier New, Courier">d1!d2!</FONT></P>
  160. </BLOCKQUOTE>
  161.  
  162. <P><B>FGristFiles</B> <I>value</I> ;
  163.  
  164. <BLOCKQUOTE>
  165. 	<P>Return <FONT SIZE="2" FACE="Courier New, Courier">$(value:G=$(SOURCE_GRIST))</FONT></P>
  166. </BLOCKQUOTE>
  167.  
  168. <P><B>FGristSourceFiles</B> <I>value</I> ;
  169.  
  170. <BLOCKQUOTE>
  171. 	<P>Return source file name with grist in it. Leave headers alone.<BR>
  172. 	<FONT SIZE="2" FACE="Courier New, Courier">$(value:G=$(SOURCE_GRIST))</FONT></P>
  173. </BLOCKQUOTE>
  174.  
  175. <P><B>FDirName</B> <I>dirs</I> ;
  176.  
  177. <BLOCKQUOTE>
  178. 	<P>Describe ???</P>
  179. </BLOCKQUOTE>
  180.  
  181. <P><B>FIncludes</B> <I>dirs</I> ;
  182.  
  183. <BLOCKQUOTE>
  184. 	<P>Expands a list of directories into a list of compiler (or preprocessor) switches (such as -I<I>dir</I> on Unix)
  185. 	to add the directories to the header inclusion search path.
  186. </BLOCKQUOTE>
  187.  
  188. <P><B>FQuote</B> <I>files</I> ;
  189.  
  190. <BLOCKQUOTE>
  191. 	<P>Returns each of <I>files</I> suitably quoted so as to hide shell metacharacters (such as whitespace and filename
  192. 	matching wildcards) from the shell.
  193. </BLOCKQUOTE>
  194.  
  195. <P><B>FRelPath </B><I>d1 </I>:<I> d2</I> ;
  196.  
  197. <BLOCKQUOTE>
  198. 	<P>Return relative path from <FONT SIZE="2" FACE="Courier New, Courier">d1</FONT> to <FONT SIZE="2" FACE="Courier New, Courier">d2</FONT>.</P>
  199. </BLOCKQUOTE>
  200.  
  201. <P><B>FReverse </B><I>a1 a2 a3</I> ;
  202.  
  203. <BLOCKQUOTE>
  204. 	<P>Return <FONT SIZE="2" FACE="Courier New, Courier">a3 a2 a1</FONT>.</P>
  205. </BLOCKQUOTE>
  206.  
  207. <P><B>FStripCommon</B> <I>v1</I> :<I> v2</I> ;
  208.  
  209. <BLOCKQUOTE>
  210. 	<P>Strip common inital parts of v1 v2.</P>
  211. </BLOCKQUOTE>
  212.  
  213. <P><B>FSubDir </B><I>d1 d2</I> ... ; <B>deprecated ?</B>
  214.  
  215. <BLOCKQUOTE>
  216. 	<P>Return path to named directory.</P>
  217. </BLOCKQUOTE>
  218.  
  219. <P><B>FSubDirPath </B><I>d1 d2</I> ... ;
  220.  
  221. <BLOCKQUOTE>
  222. 	<P>If jam is invoked in a subdirectory of TOP, then ../ is prepended to every level.</P>
  223. 	<P>
  224. </BLOCKQUOTE>
  225.  
  226. <P><B>GenFile</B> <I>target</I> : <I>image</I> <I>sources</I> ;</P>
  227.  
  228. <BLOCKQUOTE>
  229. 	<P>Runs the command &quot;<I>image</I> <I>target</I> <I>sources</I>&quot; to create <I>target</I> from <I>sources</I>
  230. 	and <I>image</I>. (where <I>image</I> is an executable built by the Main rule.)</P>
  231. </BLOCKQUOTE>
  232.  
  233. <P><B>GenFile1</B> <I>target</I> : <I>image</I> <I>sources</I> ;</P>
  234.  
  235. <BLOCKQUOTE>
  236. 	<P>Runs<B> </B>without setting up Clean or Depends rules.</P>
  237. </BLOCKQUOTE>
  238.  
  239. <P><B>Glob </B><I>directories </I><B>:</B><I> patterns </I><B>;</B> <B>builtin</B>
  240.  
  241. <BLOCKQUOTE>
  242. 	<P>Scans <I>directories</I> for files matching regex <I>patterns</I>, returning the list of matching files with
  243. 	directory prepended. Useful with the<FONT FACE="Courier New, Courier"> [...] </FONT>construct to change the Glob
  244. 	result into a list.
  245. </BLOCKQUOTE>
  246.  
  247. <P><B>HardLink</B> <I>target</I> : <I>source</I> ;
  248.  
  249. <BLOCKQUOTE>
  250. 	<P>Makes <I>target</I> a hard link to <I>source,</I> if it isn't one already. (Unix only.)
  251. </BLOCKQUOTE>
  252.  
  253. <P><B>HdrRule</B> <I>source</I> : <I>headers</I> ;
  254.  
  255. <BLOCKQUOTE>
  256. 	<P>Arranges the proper dependencies when the file <I>source</I> includes the files <I>headers</I> through the &quot;#include&quot;
  257. 	C preprocessor directive.</P>
  258. 	<P>This rule is not intended to be called explicitly. It is called automatically during header scanning on sources
  259. 	handled by the Object rule (e.g., sources in Main or Library rules).</P>
  260. </BLOCKQUOTE>
  261.  
  262. <P><B>Includes </B><I>targets1 </I>: <I>targets2 </I>; <B>builtin</B>
  263.  
  264. <BLOCKQUOTE>
  265. 	<P>Builds a siebling dependency. Any target that depends on <I>targets1</I> will also depend on <I>targets2</I>.<B><BR>
  266. 	</B>Such dependencies arise when one source file includes another.</P>
  267. </BLOCKQUOTE>
  268.  
  269. <P><B>InstallBin</B> <I>dir</I> : <I>sources</I> ;
  270.  
  271. <BLOCKQUOTE>
  272. 	<P>Copy <I>sources</I> into <I>dir</I> with mode $(EXEMODE).
  273. </BLOCKQUOTE>
  274.  
  275. <P><B>InstallFile </B><I>dir</I> : <I>sources</I> ;</P>
  276.  
  277. <BLOCKQUOTE>
  278. 	<P>Copy <I>sources</I> into <I>dir</I> with mode $(FILEMODE).</P>
  279. </BLOCKQUOTE>
  280.  
  281. <P><B>InstallInto </B><I>dir</I> : <I>sources</I> ;</P>
  282.  
  283. <BLOCKQUOTE>
  284. 	<P>Copy <I>sources</I> into <I>dir</I> with Chmod, Chown, Chgrp. Utility rule.</P>
  285. </BLOCKQUOTE>
  286.  
  287. <P><B>InstallLib</B> <I>dir</I> : <I>sources</I> ;
  288.  
  289. <BLOCKQUOTE>
  290. 	<P>Copy <I>sources</I> into <I>dir</I> with mode $(FILEMODE).</P>
  291. </BLOCKQUOTE>
  292.  
  293. <P><B>InstallMan</B> <I>dir</I> : <I>sources</I> ;
  294.  
  295. <BLOCKQUOTE>
  296. 	<P>Copy <I>sources</I> into the appropriate subdirectory of <I>dir</I> with mode $(FILEMODE). The subdirectory
  297. 	is man<I>s,</I> where <I>s</I> is the suffix of each of sources.
  298. </BLOCKQUOTE>
  299.  
  300. <P><B>InstallShell</B> <I>dir</I> : <I>sources</I> ;
  301.  
  302. <BLOCKQUOTE>
  303. 	<P>Copy <I>sources</I> into <I>dir</I> with mode $(SHELLMODE).</P>
  304. </BLOCKQUOTE>
  305.  
  306. <P><B>InstallShr</B> <I>dir</I> : <I>sources</I> ;
  307.  
  308. <BLOCKQUOTE>
  309. 	<P>Copy <I>sources</I> into <I>dir</I> with mode $(SHRMODE).
  310. </BLOCKQUOTE>
  311.  
  312. <P><B>Leaves</B> <I>...</I> ; <B>builtin</B>
  313.  
  314. <BLOCKQUOTE>
  315. 	<P>Leaves the innermost loop.</P>
  316. </BLOCKQUOTE>
  317.  
  318. <P><B>Lex</B> <I>source.c</I> : <I>source.l</I> ;
  319.  
  320. <BLOCKQUOTE>
  321. 	<P>Process the lex(1) source file <I>source.l</I> and rename the lex.yy.c to <I>source.c.</I> Called by the Object
  322. 	rule.
  323. </BLOCKQUOTE>
  324.  
  325. <P><B>Library</B> <I>library</I> : <I>sources</I> ;
  326.  
  327. <BLOCKQUOTE>
  328. 	<P>Compiles <I>sources</I> and builds a shared <I>library.</I> The intermediate <I>objects</I> are deleted. Calls
  329. 	Objects and LibraryFromObjects.</P>
  330. 	<P>If Library is invoked with no suffix on <I>library</I>, the $(SUFLIB) suffix is used.<BR>
  331. 	If Library is invoked with a suffix on <I>library<B>, </B></I>it is corrected to the platform $(SUFLIB).<BR>
  332. 	<B>ToDo: </B>Is the &quot;lib&quot; prefix added? Ignored? What name is used in the link flag (-l) ?</P>
  333. </BLOCKQUOTE>
  334.  
  335. <P><B>LibraryFromObjects</B> <I>library</I> : <I>objects</I> ;
  336.  
  337. <BLOCKQUOTE>
  338. 	<P>Archives <I>objects</I> into <I>library.</I> The <I>objects</I> are then deleted.</P>
  339. 	<P>If <I>library</I> has no suffix, the $(SUFLIB) suffix is used.</P>
  340. </BLOCKQUOTE>
  341.  
  342. <P><B>Libs</B> <I>image</I> : <I>libraries</I> ;
  343.  
  344. <BLOCKQUOTE>
  345. 	<P>Make <I>image</I> depend on <I>libraries</I> and include them during the linking.<BR>
  346. 	<I>image</I> may be referenced without a suffix in this rule invocation; Libs supplies the suffix or adjusts the
  347. 	suffix supplied for the current platform. (Rule was LinkLibraries).</P>
  348. </BLOCKQUOTE>
  349.  
  350. <P><B>LibFlags </B><I>flag1 flag2 </I>;
  351.  
  352. <BLOCKQUOTE>
  353. 	<P>Modifies LINKFLAGS in a compiler independent way.</P>
  354. </BLOCKQUOTE>
  355.  
  356. <P><B>Link</B> <I>image</I> : <I>objects</I> ;
  357.  
  358. <BLOCKQUOTE>
  359. 	<P>Links <I>image</I> from <I>objects</I> and sets permissions on <I>image</I> to $(EXEMODE). <I>Image</I> must
  360. 	be actual filename; suffix is not supplied. Called by Main.
  361. </BLOCKQUOTE>
  362.  
  363. <P><B>LinkFlags </B><I>flags</I> ;</P>
  364. <P><B>Main</B> <I>image</I> : <I>sources</I> ;
  365.  
  366. <BLOCKQUOTE>
  367. 	<P>Compiles <I>sources</I> and links them into <I>image.</I> Calls Objects and MainFromObjects.</P>
  368. 	<P><I>image</I> may be referenced without a suffix in this rule invocation; Main supplies the suffix or adjust
  369. 	the suffix supplied for the current platform.</P>
  370. </BLOCKQUOTE>
  371.  
  372. <P><B>MainFromObjects</B> <I>image</I> : <I>objects</I> ;
  373.  
  374. <BLOCKQUOTE>
  375. 	<P>Links <I>objects</I> into <I>image.</I> Dependency of exe. MainFromObjects supplies the suffix on <I>image</I>
  376. 	filename.
  377. </BLOCKQUOTE>
  378.  
  379. <P><B>MakeLocate</B> <I>target</I> : <I>dir</I> ;
  380.  
  381. <BLOCKQUOTE>
  382. 	<P>Creates <I>dir</I> and causes <I>target</I> to be built into <I>dir</I>.
  383. </BLOCKQUOTE>
  384.  
  385. <P><B>Match </B><I>regexps </I><B>:</B><I> list </I><B>;</B> <B>builtin</B>
  386.  
  387. <BLOCKQUOTE>
  388. 	<P>Matches the <B>egrep</B> style regular expression<I> regexps</I> against the strings in<I> list</I>.<I> </I>Result
  389. 	is the concatenation of matching subexpressions for each string in <I>list</I>. Useful with <FONT FACE="Courier New, Courier">[
  390. 	]</FONT> to change result into a list.</P>
  391. </BLOCKQUOTE>
  392.  
  393. <P><B>MkDir</B> <I>dir</I> ;
  394.  
  395. <BLOCKQUOTE>
  396. 	<P>Creates <I>dir</I> and its parent directories.</P>
  397. </BLOCKQUOTE>
  398.  
  399. <P><B>NoCare </B><I>target ...</I> ; <B>builtin</B>
  400.  
  401. <BLOCKQUOTE>
  402. 	<P>Don't panic if the target cannot be built.</P>
  403. </BLOCKQUOTE>
  404.  
  405. <P><B>NotFile </B><I>target ...</I> ; <B>builtin</B>
  406.  
  407. <BLOCKQUOTE>
  408. 	<P>Ignore the timestamp of the target; it is not a file.</P>
  409. </BLOCKQUOTE>
  410.  
  411. <P><B>NoUpdate</B> <I>target ...</I> ; <B>builtin</B>
  412.  
  413. <BLOCKQUOTE>
  414. 	<P>Create the target if needed, but never update it.
  415. </BLOCKQUOTE>
  416.  
  417. <P><B>Object</B> <I>object</I> : <I>source</I> ;
  418.  
  419. <BLOCKQUOTE>
  420. 	<P>Compiles a <I>single</I> source file source into <I>object.</I> The Main and Library rules use this rule to
  421. 	compile source files.</P>
  422. 	<P>Causes <I>source</I> to be scanned for &quot;#include&quot; directives and calls HdrRule to make all included
  423. 	files dependencies of <I>object</I>.</P>
  424. 	<P>Calls one of the following rules to do the actual compiling, depending on the suffix of source:</P>
  425. 	<PRE>		     *.c:   Cc 
  426. 		     *.cc:  C++ 
  427. 		     *.cpp: C++
  428. 		     *.cxx: C++
  429. <STRIKE>		     *.C:   C++ </STRIKE>
  430. 		     *.l:   Lex 
  431. 		     *.y:   Yacc
  432. 		     *.*:   UserObject
  433. </PRE>
  434. </BLOCKQUOTE>
  435.  
  436. <P><B>ObjectC++Flags</B> <I>source</I> : <I>flags</I> ; <BR>
  437. <B>ObjectCcFlags</B> <I>source</I> : <I>flags</I> ;
  438.  
  439. <BLOCKQUOTE>
  440. 	<P>Add <I>flags</I> to the source-specific value of $(CCFLAGS) or $(C++FLAGS) when compiling <I>source.</I> Any
  441. 	file suffix on <I>source</I> is ignored.
  442. </BLOCKQUOTE>
  443.  
  444. <P><B>ObjectDefines</B> <I>object</I> : <I>defines</I> ;
  445.  
  446. <BLOCKQUOTE>
  447. 	<P>Adds preprocessor symbol definitions to the (gristed) target-specific $(CCDEFS) for the <I>object</I>.
  448. </BLOCKQUOTE>
  449.  
  450. <P><B>ObjectHdrs</B> <I>source</I> : <I>dirs</I> ;
  451.  
  452. <BLOCKQUOTE>
  453. 	<P>Add <I>dirs</I> to the source-specific value of $(HDRS) when scanning and compiling <I>source.</I> Any file
  454. 	suffix on <I>source</I> is ignored.
  455. </BLOCKQUOTE>
  456.  
  457. <P><B>Objects</B> <I>sources</I> ;
  458.  
  459. <BLOCKQUOTE>
  460. 	<P>For each source file in <I>sources,</I> calls Object to compile the source file into a similarly named object
  461. 	file.
  462. </BLOCKQUOTE>
  463.  
  464. <P><B>Resource </B><I>targets : sources ;</I></P>
  465.  
  466. <BLOCKQUOTE>
  467. 	<P>Invokes the resource compiler to build target.</P>
  468. </BLOCKQUOTE>
  469.  
  470. <P><B>RmTemps</B> <I>targets</I> : <I>sources</I> ;
  471.  
  472. <BLOCKQUOTE>
  473. 	<P>Marks <I>sources</I> as temporary with the Temporary rule, and deletes <I>sources</I> once <I>targets</I> are
  474. 	built. Must be the last rule invoked on <I>targets.</I> Used internally by LibraryFromObjects rule.
  475. </BLOCKQUOTE>
  476.  
  477. <P><B>Setuid</B> <I>images</I> ;
  478.  
  479. <BLOCKQUOTE>
  480. 	<P>Sets the setuid bit on each of <I>images</I> after linking. (Unix only.)
  481. </BLOCKQUOTE>
  482.  
  483. <P><B>Shell</B> <I>image</I> : <I>source</I> ;
  484.  
  485. <BLOCKQUOTE>
  486. 	<P>Copies <I>source</I> into the executable sh(1) script <I>image.</I> Ensures that the first line of the script
  487. 	is $(SHELLHEADER) (default #!/bin/sh).</P>
  488. </BLOCKQUOTE>
  489.  
  490. <P><B>SoftLink</B> <I>target</I> : <I>source</I> ;
  491.  
  492. <BLOCKQUOTE>
  493. 	<P>Makes <I>target</I> a symbolic link to <I>source,</I> if it isn't one already. (Unix only.)
  494. </BLOCKQUOTE>
  495.  
  496. <P><B>SubDir</B> <I>TOP d1 ... dn</I> ;
  497.  
  498. <BLOCKQUOTE>
  499. 	<P>Sets up housekeeping for the source files located in <I><CODE>$(TOP)/d1/.../dn</CODE></I>:
  500. 	<UL>
  501. 		<LI><I>TOP</I> is the name of a variable; <I>d1</I> thru <I>dn</I> are elements of a directory path.
  502. 		<LI>Reads in rules file associated with <I>TOP</I>, if it hasn't already been read.
  503. 		<LI>Initializes variables for search paths, output directories, compiler flags, and grist, using <I>d1 ... dn</I>
  504. 		tokens.
  505. 		<LI>If TOP is not defined, relative path directories are used
  506. 	</UL>
  507. 	<P>
  508. </BLOCKQUOTE>
  509.  
  510. <P><B>SubDirC++Flags</B> <I>flags</I> ; <BR>
  511. <B>SubDirCcFlags</B> <I>flags</I> ;
  512.  
  513. <BLOCKQUOTE>
  514. 	<P>Adds <I>flags</I> to the compiler flags for source files in SubDir's directory.
  515. </BLOCKQUOTE>
  516.  
  517. <P><B>SubDirDefines</B> <I>f1 f2 ...</I> ;
  518.  
  519. <BLOCKQUOTE>
  520. 	<P>Directory dependent compiler macro definitions.</P>
  521. </BLOCKQUOTE>
  522.  
  523. <P><B>SubDirHdrs</B> <I>d1 ... dn</I> ;
  524.  
  525. <BLOCKQUOTE>
  526. 	<P>Adds the path <I>d1/.../dn/</I> to the header search paths for source files in SubDir's directory. <I>d1</I>
  527. 	through <I>dn</I> are elements of a directory path.
  528. </BLOCKQUOTE>
  529.  
  530. <P><B>SubInclude</B> <I>VAR d1 ... dn</I> ;
  531.  
  532. <BLOCKQUOTE>
  533. 	<P>Reads the Jamfile in <I><CODE>$(VAR)/d1/.../dn/</CODE></I>.
  534. </BLOCKQUOTE>
  535.  
  536. <P><B>SubRules</B> <I>TOP d1 ... dn</I> :<I> Other-TOP</I> ;
  537.  
  538. <BLOCKQUOTE>
  539. 	<P>Reads another tree's Jamrules.</P>
  540. </BLOCKQUOTE>
  541.  
  542. <P><B>Temporary </B><I>target ... </I>; <B>builtin</B>
  543.  
  544. <BLOCKQUOTE>
  545. 	<P>Target need not be present if sources haven't changed.</P>
  546. </BLOCKQUOTE>
  547.  
  548. <P><B>Unique</B> <I>images</I> : <I>flags</I> ; <B>(to be implemented)</B>
  549.  
  550. <BLOCKQUOTE>
  551. 	<P>Adds<I> flags </I>to <I>images</I>, if it does not already exist.<BR>
  552. 	Useful for setting compiler flags, without getting duplicates.</P>
  553. </BLOCKQUOTE>
  554.  
  555. <P><B>Undefines</B> <I>images</I> : <I>symbols</I> ;
  556.  
  557. <BLOCKQUOTE>
  558. 	<P>Adds flags to mark <I>symbols</I> as undefined on link command for <I>images</I>. <I>Images</I> may be referenced
  559. 	unsuffixed; the Undefines rule supplies the suffix.
  560. </BLOCKQUOTE>
  561.  
  562. <P><B>UserObject</B> <I>object</I> : <I>source</I> ;
  563.  
  564. <BLOCKQUOTE>
  565. 	<P>This rule is called by Object for source files with unknown suffixes, and should be defined in Jamrules with
  566. 	a user-provided rule to handle the source file types not handled by the Object rule. The Jambase UserObject rule
  567. 	merely issues a complaint when it encounters <I>source</I> with file suffixes it does not recognize.
  568. </BLOCKQUOTE>
  569.  
  570. <P><B>Yacc</B> <I>source.c</I> : <I>source.y</I> ;
  571.  
  572. <BLOCKQUOTE>
  573. 	<P>Process the yacc(1) file <I>source.y</I> and renamed the resulting y.tab.c and y.tab.h to <I>source.c.</I> Produces
  574. 	a y.tab.h and renames it to <I>source.h.</I> Called by the <B>Object</B> rule.
  575. </BLOCKQUOTE>
  576.  
  577. <P>
  578. <HR ALIGN="CENTER">
  579. <A NAME="PSEUDOTARGETS"></A>
  580. <H3>Jambase Pseudotargets</H3>
  581. <P>There are two kinds of Jam targets: file targets and pseudotargets. File targets are objects that can be found
  582. in the filesystem. Pseudotargets are symbolic, defined by <I>NotFile</I> rule and usually represent other targets.
  583. Most Jambase rules that define file targets also define pseudotargets which are dependent on types of file targets.
  584.  A pseudotarget is created by the <B>NotFile</B> rule.<BR>
  585. The Jambase pseudotargets are:</P>
  586.  
  587. <P>
  588. <TABLE BORDER="1" WIDTH="68%">
  589. 	<TR>
  590. 		<TD WIDTH="11%">
  591. 			<P ALIGN="CENTER"><B>all</B>
  592. 		</TD>
  593. 		<TD WIDTH="89%">Default target</TD>
  594. 	</TR>
  595. 	<TR>
  596. 		<TD WIDTH="11%">
  597. 			<P ALIGN="CENTER"><B>clean</B>
  598. 		</TD>
  599. 		<TD WIDTH="89%">Remove built targets (except files copied by Install rules)</TD>
  600. 	</TR>
  601. 	<TR>
  602. 		<TD WIDTH="11%">
  603. 			<P ALIGN="CENTER"><B>dirs</B>
  604. 		</TD>
  605. 		<TD WIDTH="89%">Directories where target files are written</TD>
  606. 	</TR>
  607. 	<TR>
  608. 		<TD WIDTH="11%">
  609. 			<P ALIGN="CENTER"><B>files</B>
  610. 		</TD>
  611. 		<TD WIDTH="89%">Files copied by File and Bulk rules</TD>
  612. 	</TR>
  613. 	<TR>
  614. 		<TD WIDTH="11%">
  615. 			<P ALIGN="CENTER"><B>first</B>
  616. 		</TD>
  617. 		<TD WIDTH="89%">first dependent of<B> 'all',</B> for initialization</TD>
  618. 	</TR>
  619. 	<TR>
  620. 		<TD WIDTH="11%">
  621. 			<P ALIGN="CENTER"><B>exe</B>
  622. 		</TD>
  623. 		<TD WIDTH="89%">Executables linked by Main or MainFromObjects rules</TD>
  624. 	</TR>
  625. 	<TR>
  626. 		<TD WIDTH="11%">
  627. 			<P ALIGN="CENTER"><B>install</B>
  628. 		</TD>
  629. 		<TD WIDTH="89%">Files copied by Install rules</TD>
  630. 	</TR>
  631. 	<TR>
  632. 		<TD WIDTH="11%">
  633. 			<P ALIGN="CENTER"><B>lib</B>
  634. 		</TD>
  635. 		<TD WIDTH="89%">Libraries copied by the Library or LibraryFromObjects rules</TD>
  636. 	</TR>
  637. 	<TR>
  638. 		<TD WIDTH="11%">
  639. 			<P ALIGN="CENTER"><B>obj</B>
  640. 		</TD>
  641. 		<TD WIDTH="89%">Compiled objects used to create Main or Library targets</TD>
  642. 	</TR>
  643. 	<TR>
  644. 		<TD WIDTH="11%">
  645. 			<P ALIGN="CENTER"><B>shell</B>
  646. 		</TD>
  647. 		<TD WIDTH="89%">Files copied by Shell rule</TD>
  648. 	</TR>
  649. 	<TR>
  650. 		<TD WIDTH="11%">
  651. 			<P ALIGN="CENTER"><B>uninstall</B>
  652. 		</TD>
  653. 		<TD WIDTH="89%">Remove targets copied by Install rules</TD>
  654. 	</TR>
  655. </TABLE>
  656. </P>
  657.  
  658. <P>In addition, Jambase makes the <B>jam</B> default target &quot;all&quot; depend on &quot;exe&quot;, &quot;lib&quot;,
  659. &quot;obj&quot;, &quot;files&quot;, and &quot;shell&quot;.</P>
  660.  
  661. <P><B>Modifiers on actions:<BR>
  662. </B>
  663. <TABLE BORDER="1" WIDTH="100%">
  664. 	<TR>
  665. 		<TD WIDTH="10%">
  666. 			<P ALIGN="CENTER">together
  667. 		</TD>
  668. 		<TD WIDTH="90%">multiple instances of same rule on target get executed once with their sources ($(&gt;)) catenated</TD>
  669. 	</TR>
  670. 	<TR>
  671. 		<TD WIDTH="10%">
  672. 			<P ALIGN="CENTER">updated
  673. 		</TD>
  674. 		<TD WIDTH="90%">refers to updated sources only $(&gt;)</TD>
  675. 	</TR>
  676. 	<TR>
  677. 		<TD WIDTH="10%">
  678. 			<P ALIGN="CENTER">ignore
  679. 		</TD>
  680. 		<TD WIDTH="90%">ignore return status of command</TD>
  681. 	</TR>
  682. 	<TR>
  683. 		<TD WIDTH="10%">
  684. 			<P ALIGN="CENTER">quietly
  685. 		</TD>
  686. 		<TD WIDTH="90%">don't trace execution unless verbose</TD>
  687. 	</TR>
  688. 	<TR>
  689. 		<TD WIDTH="10%">
  690. 			<P ALIGN="CENTER">piecemeal
  691. 		</TD>
  692. 		<TD WIDTH="90%">iterate command each time with small subset of $(&gt;)</TD>
  693. 	</TR>
  694. 	<TR>
  695. 		<TD WIDTH="10%">
  696. 			<P ALIGN="CENTER">existing
  697. 		</TD>
  698. 		<TD WIDTH="90%">refers to currently existing sources only $(&gt;)</TD>
  699. 	</TR>
  700. 	<TR>
  701. 		<TD WIDTH="10%">
  702. 			<P ALIGN="CENTER">bind vars
  703. 		</TD>
  704. 		<TD WIDTH="90%">subject to binding before expanding in actions</TD>
  705. 	</TR>
  706. </TABLE>
  707. <BR>
  708.  
  709. <HR ALIGN="CENTER">
  710. </P>
  711. <H3>Jam Variable Modifiers</H3>
  712.  
  713. <DL>
  714. 	<P>
  715. 	<TABLE BORDER="1" WIDTH="75%">
  716. 		<CAPTION>
  717. 			<P><B><FONT SIZE="4">Variable Modifiers</FONT></B>
  718. 		</CAPTION>
  719. <tbody>       																						<TR>
  720. 			<TD><CODE> [<I>n</I>]</CODE></TD>
  721. 			<TD>Select element number <I>n</I> (starting at 1). If the variable contains fewer than <I>n</I> elements, the result
  722. 				is a zero-element list.</TD>
  723. 		</TR>
  724. 		<TR>
  725. 			<TD><CODE> [<I>n</I>-<I>m</I>]</CODE></TD>
  726. 			<TD>Select elements number <I>n</I> through <I>m</I>.</TD>
  727. 		</TR>
  728. 		<TR>
  729. 			<TD><CODE> [<I>n</I>-]</CODE></TD>
  730. 			<TD>Select elements number <I>n</I> through the last.</TD>
  731. 		</TR>
  732. 		<TR>
  733. 			<TD><CODE> :<I>chars</I></CODE></TD>
  734. 			<TD>Select the components listed in <I>chars</I>.</TD>
  735. 		</TR>
  736. 		<TR>
  737. 			<TD><CODE> :B</CODE></TD>
  738. 			<TD>Select filename base.</TD>
  739. 		</TR>
  740. 		<TR>
  741. 			<TD><CODE> :B=<I>base</I></CODE></TD>
  742. 			<TD>Replace the base part of file name with <I>base</I></TD>
  743. 		</TR>
  744. 		<TR>
  745. 			<TD><CODE>:BS=<I>base.suffix</I></CODE></TD>
  746. 			<TD>Base and suffix of the variable (without directory).</TD>
  747. 		</TR>
  748. 		<TR>
  749. 			<TD><CODE> :D</CODE></TD>
  750. 			<TD>Select directory path.</TD>
  751. 		</TR>
  752. 		<TR>
  753. 			<TD><CODE> :D=<I>path</I></CODE></TD>
  754. 			<TD>Replace directory with <I>path.</I></TD>
  755. 		</TR>
  756. 		<TR>
  757. 			<TD><CODE> :E</CODE></TD>
  758. 			<TD>If VAR is unset, $(VAR:E) is a list containing a single null string.</TD>
  759. 		</TR>
  760. 		<TR>
  761. 			<TD><CODE> :E=<I>value</I></CODE></TD>
  762. 			<TD>Use <I>value</I> instead if the variable is unset.</TD>
  763. 		</TR>
  764. 		<TR>
  765. 			<TD><CODE> :G</CODE></TD>
  766. 			<TD>Select grist.</TD>
  767. 		</TR>
  768. 		<TR>
  769. 			<TD><CODE> :G=<I>grist</I></CODE></TD>
  770. 			<TD>Replace grist with <I>grist</I>.</TD>
  771. 		</TR>
  772. 		<TR>
  773. 			<TD><CODE> :J=<I>joinval</I></CODE></TD>
  774. 			<TD>Concatenate list elements into single element, separated by <I>joinval</I>.</TD>
  775. 		</TR>
  776. 		<TR>
  777. 			<TD><CODE> :L</CODE></TD>
  778. 			<TD>Replace uppercase characters with lowercase.</TD>
  779. 		</TR>
  780. 		<TR>
  781. 			<TD><CODE> :M</CODE></TD>
  782. 			<TD>Select archive member name.</TD>
  783. 		</TR>
  784. 		<TR>
  785. 			<TD><CODE> :M=<I>mem</I></CODE></TD>
  786. 			<TD>Replace the archive member name with <I>mem</I>.</TD>
  787. 		</TR>
  788. 		<TR>
  789. 			<TD><CODE> :P</CODE></TD>
  790. 			<TD>Select parent directory.</TD>
  791. 		</TR>
  792. 		<TR>
  793. 			<TD><CODE> :R=<I>root</I></CODE></TD>
  794. 			<TD>Prepend <I>root</I> to the whole file name, if not already rooted.</TD>
  795. 		</TR>
  796. 		<TR>
  797. 			<TD><CODE> :S</CODE></TD>
  798. 			<TD>Select (last) filename suffix.</TD>
  799. 		</TR>
  800. 		<TR>
  801. 			<TD><CODE> :S=<I>suf</I></CODE></TD>
  802. 			<TD>Replace the suffix of file name with <I>suf</I>.</TD>
  803. 		</TR>
  804. 		<TR>
  805. 			<TD><CODE> :U</CODE></TD>
  806. 			<TD>Replace lowercase characters with uppercase.</TD>
  807. 		</TR>
  808. </tbody>    											</TABLE>
  809. </P>
  810. 	<P>$(var:P) is the parent directory of $(var:D).</P>
  811. </DL>
  812.  
  813. <P>
  814. <HR ALIGN="CENTER">
  815. <A NAME="VARS"></A>
  816. <H3>Jambase Variables</H3>
  817. <P>Most of the following variables have default values for each platform; refer to the Jambase file to see what
  818. those defaults are.</P>
  819. <P><B>ToDo: </B>What about JAMDATE, JAMUNAME, JAMVERSION, JAMSHELL, JAMUSER</P>
  820. <P>ALL_LOCATE_TARGET</P>
  821.  
  822. <BLOCKQUOTE>
  823. 	<P>Alternative location of built targets. By default, Jambase rules locate built targets in the source tree. By
  824. 	setting $(ALL_LOCATE_TARGET) in Jamrules, you can cause <B>jam</B> to write built targets to a location outside
  825. 	the source tree.
  826. </BLOCKQUOTE>
  827.  
  828. <P>AR
  829.  
  830. <BLOCKQUOTE>
  831. 	<P>The archive command used to update Library and LibraryFromObjects targets.
  832. </BLOCKQUOTE>
  833.  
  834. <P>AS
  835.  
  836. <BLOCKQUOTE>
  837. 	<P>The assembler for As rule targets.
  838. </BLOCKQUOTE>
  839.  
  840. <P>ASFLAGS
  841.  
  842. <BLOCKQUOTE>
  843. 	<P>Flags handed to the assembler for As.
  844. </BLOCKQUOTE>
  845.  
  846. <P>AWK
  847.  
  848. <BLOCKQUOTE>
  849. 	<P>The name of awk interpreter, used when copying a shell script for the Shell rule.
  850. </BLOCKQUOTE>
  851.  
  852. <P>BINDIR
  853.  
  854. <BLOCKQUOTE>
  855. 	<P>Local bin directory. <FONT SIZE="2" FACE="Courier New, Courier">/usr/local/bin</FONT></P>
  856. </BLOCKQUOTE>
  857.  
  858. <P>CC
  859.  
  860. <BLOCKQUOTE>
  861. 	<P>C compiler used for Cc rule targets.
  862. </BLOCKQUOTE>
  863.  
  864. <P>CCFLAGS
  865.  
  866. <BLOCKQUOTE>
  867. 	<P>Compile flags for Cc rule targets. The Cc rule sets target-specific $(CCFLAGS) values on its targets.
  868. </BLOCKQUOTE>
  869.  
  870. <P>C++
  871.  
  872. <BLOCKQUOTE>
  873. 	<P>C++ compiler used for C++ rule targets.
  874. </BLOCKQUOTE>
  875.  
  876. <P>C++FLAGS
  877.  
  878. <BLOCKQUOTE>
  879. 	<P>Compile flags for C++ rule targets. The C++ rule sets target-specific $(C++FLAGS) values on its targets.
  880. </BLOCKQUOTE>
  881.  
  882. <P>CHMOD
  883.  
  884. <BLOCKQUOTE>
  885. 	<P>Program (usually chmod(1)) used to set file permissions for Chmod rule.
  886. </BLOCKQUOTE>
  887.  
  888. <P>CP
  889.  
  890. <BLOCKQUOTE>
  891. 	<P>The file copy program, used by File and Install* rules.
  892. </BLOCKQUOTE>
  893.  
  894. <P>CRELIB <B>(deprecated)</B>
  895.  
  896. <BLOCKQUOTE>
  897. 	<P>If set, causes the Library rule to invoke the CreLib rule on the target library before attempting to archive
  898. 	any members, so that the library can be created if needed.
  899. </BLOCKQUOTE>
  900.  
  901. <P>DEFINES
  902.  
  903. <BLOCKQUOTE>
  904. 	<P>Preprocessor symbol definitions for Cc and C++ rule targets. The Cc and C++ rules set target-specific $(CCDEFS)
  905. 	values on their targets, based on $(DEFINES). (The &quot;indirection&quot; here is required to support compilers
  906. 	with baroque command line syntax for setting symbols).
  907. </BLOCKQUOTE>
  908.  
  909. <P>DOT
  910.  
  911. <BLOCKQUOTE>
  912. 	<P>The operating system-specific name for the current directory.
  913. </BLOCKQUOTE>
  914.  
  915. <P>DOTDOT
  916.  
  917. <BLOCKQUOTE>
  918. 	<P>The operating system-specific name for the parent directory.
  919. </BLOCKQUOTE>
  920.  
  921. <P>EXEMODE
  922.  
  923. <BLOCKQUOTE>
  924. 	<P>Permissions for executables linked with Link, Main, and MainFromObjects, on platforms with a Chmod action.
  925. </BLOCKQUOTE>
  926.  
  927. <P>FILEMODE
  928.  
  929. <BLOCKQUOTE>
  930. 	<P>Permissions for files copied by File or Bulk, on platforms with a Chmod action.
  931. </BLOCKQUOTE>
  932.  
  933. <P>GROUP
  934.  
  935. <BLOCKQUOTE>
  936. 	<P><I>(Unix only.)</I> The group owner for Install* rule targets.
  937. </BLOCKQUOTE>
  938.  
  939. <P>HDRGRIST
  940.  
  941. <BLOCKQUOTE>
  942. 	<P>If set, used by the HdrRule to distinguish header files with the same name in different directories.
  943. </BLOCKQUOTE>
  944.  
  945. <P>HDRPATTERN
  946.  
  947. <BLOCKQUOTE>
  948. 	<P>A regular expression pattern that matches C preprocessor &quot;#include&quot; directives in source files and
  949. 	returns the name of the included file.<BR>
  950. 	<FONT SIZE="2" FACE="Courier New, Courier">HDRSCAN = &quot;^[ \t]*#[ \t]*include[ \t]*[&lt;\\&quot;]([^\\&quot;&gt;]*)[\\&quot;&gt;].*$&quot;
  951. 	;</FONT>
  952. </BLOCKQUOTE>
  953.  
  954. <P>HDRRULE
  955.  
  956. <BLOCKQUOTE>
  957. 	<P>Name of the rule to invoke with the results of header file scanning. Default is &quot;HdrRule&quot;.</P>
  958. 	<P>This is a jam-special variable. If both HDRRULE and HDRSCAN are set on a target, that target will be scanned
  959. 	for lines matching $(HDRSCAN), and $(HDDRULE) will be invoked on included files found in the matching $(HDRSCAN)
  960. 	lines.</P>
  961. </BLOCKQUOTE>
  962.  
  963. <P>HDRS
  964.  
  965. <BLOCKQUOTE>
  966. 	<P>Directories to be searched for header files. This is used by the Object rule to:
  967. 	<UL>
  968. 		<LI>set up search paths for finding files returned by header scans
  969. 		<LI>add -I flags on compile commands
  970. 	</UL>
  971. 	<P>(See STDHDRS.)
  972. </BLOCKQUOTE>
  973.  
  974. <P>HDRSCAN
  975.  
  976. <BLOCKQUOTE>
  977. 	<P>Regular expression pattern to use for header file scanning. The Object rule sets this to $(HDRPATTERN). This
  978. 	is a jam-special variable; see HDRRULE.
  979. </BLOCKQUOTE>
  980.  
  981. <P>HDRSEARCH
  982.  
  983. <BLOCKQUOTE>
  984. 	<P>Used by the HdrRule to fix the list of directories where header files can be found for a given source file.
  985. </BLOCKQUOTE>
  986.  
  987. <P>INSTALLGRIST
  988.  
  989. <BLOCKQUOTE>
  990. 	<P>Used by the Install* rules to grist paths to installed files; defaults to &quot;installed&quot;.
  991. </BLOCKQUOTE>
  992.  
  993. <P>JAMDATE
  994.  
  995. <BLOCKQUOTE>
  996. 	<P>Time and Date at jam startup.</P>
  997. </BLOCKQUOTE>
  998.  
  999. <P>JAMUNAME
  1000.  
  1001. <BLOCKQUOTE>
  1002. 	<P>Output of uname(1) command (Unix only, but why? It's in Win).</P>
  1003. </BLOCKQUOTE>
  1004.  
  1005. <P>JAMVERSION
  1006.  
  1007. <BLOCKQUOTE>
  1008. 	<P>Jam version, reported by <FONT SIZE="2" FACE="Courier New, Courier">jam -v</FONT>.</P>
  1009. </BLOCKQUOTE>
  1010.  
  1011. <P>JAMSHELL
  1012.  
  1013. <BLOCKQUOTE>
  1014. 	<P>Shell invocation control when Jam invokes an action block.<BR>
  1015. 	<FONT SIZE="2" FACE="Courier New, Courier">JAMSHELL = &quot;/bin/sh -c %&quot; </FONT>on unix.</P>
  1016. </BLOCKQUOTE>
  1017.  
  1018. <P>JAMUSER
  1019.  
  1020. <BLOCKQUOTE>
  1021. 	<P>Username that invoked jam.</P>
  1022. </BLOCKQUOTE>
  1023.  
  1024. <P>JAMFILE
  1025.  
  1026. <BLOCKQUOTE>
  1027. 	<P>Default is &quot;Jamfile&quot;; the name of the user-written rules file found in each source directory.
  1028. </BLOCKQUOTE>
  1029.  
  1030. <P>JAMRULES
  1031.  
  1032. <BLOCKQUOTE>
  1033. 	<P>Default is &quot;Jamrules&quot;; the name of a rule definition file to be read in at the first SubDir rule invocation.
  1034. </BLOCKQUOTE>
  1035.  
  1036. <P>KEEPOBJS
  1037.  
  1038. <BLOCKQUOTE>
  1039. 	<P>If set, tells the LibraryFromObjects rule not to delete object files once they are archived.
  1040. </BLOCKQUOTE>
  1041.  
  1042. <P>LEX
  1043.  
  1044. <BLOCKQUOTE>
  1045. 	<P>The lex(1) command and flags.
  1046. </BLOCKQUOTE>
  1047.  
  1048. <P>LIBDIR
  1049.  
  1050. <BLOCKQUOTE>
  1051. 	<P>Local library directory for installs. Default: <FONT SIZE="2" FACE="Courier New, Courier">/usr/local/lib</FONT>
  1052. 	or <FONT SIZE="2" FACE="Courier New, Courier">$(MSVCDIR)\\lib</FONT>
  1053. </BLOCKQUOTE>
  1054.  
  1055. <P>LINK
  1056.  
  1057. <BLOCKQUOTE>
  1058. 	<P>The linker. Defaults to $(CC).
  1059. </BLOCKQUOTE>
  1060.  
  1061. <P>LINKFLAGS
  1062.  
  1063. <BLOCKQUOTE>
  1064. 	<P>Flags handed to the linker. Defaults to $(CCFLAGS).
  1065. </BLOCKQUOTE>
  1066.  
  1067. <P>LINKLIBS
  1068.  
  1069. <BLOCKQUOTE>
  1070. 	<P>List of external libraries to link with. The target image does not depend on these libraries.<BR>
  1071. 	Windows: <FONT SIZE="2" FACE="Courier New, Courier"><BR>
  1072. 	$(LIBDIR)\\libc.lib <BR>
  1073. 	$(LIBDIR)\\oldnames.lib <BR>
  1074. 	$(LIBDIR)\\kernel32.lib ;</FONT></P>
  1075. 	<P>Unix: ... none yet. libc, libpthreads, libdl ...
  1076. </BLOCKQUOTE>
  1077.  
  1078. <P>LN
  1079.  
  1080. <BLOCKQUOTE>
  1081. 	<P>The hard link command for HardLink rule.
  1082. </BLOCKQUOTE>
  1083.  
  1084. <P>LOCATE
  1085.  
  1086. <BLOCKQUOTE>
  1087. 	<P>Where to plop something not found with SEARCH.
  1088. </BLOCKQUOTE>
  1089.  
  1090. <P>LOCATE_SOURCE
  1091.  
  1092. <BLOCKQUOTE>
  1093. 	<P>Used to set the location of <I>generated source files.</I> The Yacc, Lex, and GenFile rules set LOCATE on their
  1094. 	targets to $(LOCATE_SOURCE). $(LOCATE_SOURCE) is initialized by the SubDir rule to the source directory itself.
  1095. 	(see ALL_LOCATE_TARGET.)
  1096. </BLOCKQUOTE>
  1097.  
  1098. <P>LOCATE_TARGET
  1099.  
  1100. <BLOCKQUOTE>
  1101. 	<P>Used to set the location of built binary targets. The Object rule, and hence the Main and Library rules, set
  1102. 	LOCATE on their targets to $(LOCATE_TARGET). $(LOCATE_TARGET) is initialized by the SubDir rule to the source directory
  1103. 	itself. (See ALL_LOCATE_TARGET.)
  1104. </BLOCKQUOTE>
  1105.  
  1106. <P>MANDIR
  1107.  
  1108. <BLOCKQUOTE>
  1109. 	<P>Default directory for man pages. Default: <FONT SIZE="2" FACE="Courier New, Courier">/usr/local/man</FONT> .</P>
  1110. </BLOCKQUOTE>
  1111.  
  1112. <P>MKDIR
  1113.  
  1114. <BLOCKQUOTE>
  1115. 	<P>The 'create directory' command used for the MkDir rule.
  1116. </BLOCKQUOTE>
  1117.  
  1118. <P>MODE
  1119.  
  1120. <BLOCKQUOTE>
  1121. 	<P>The target-specific file mode (permissions) for targets of the Shell, Setuid, Link, and Install* rules. Used
  1122. 	by the Chmod action; hence relevant to NT only.
  1123. </BLOCKQUOTE>
  1124.  
  1125. <P>MSVCDIR
  1126.  
  1127. <BLOCKQUOTE>
  1128. 	<P>Selects Microsoft Visual C NT 6.0 and later compile &amp; link actions on NT. 
  1129. </BLOCKQUOTE>
  1130.  
  1131. <P>MV
  1132.  
  1133. <BLOCKQUOTE>
  1134. 	<P>The file rename command and options.
  1135. </BLOCKQUOTE>
  1136.  
  1137. <P>NEEDLIBS
  1138.  
  1139. <BLOCKQUOTE>
  1140. 	<P>The list of libraries used when linking an executable. Used by the Link rule.
  1141. </BLOCKQUOTE>
  1142.  
  1143. <P>NOARSCAN
  1144.  
  1145. <BLOCKQUOTE>
  1146. 	<P>If set, indicates that library members' timestamps can't be found, and prevents the individual objects from
  1147. 	being deleted, so that their timestamps can be used instead.
  1148. </BLOCKQUOTE>
  1149.  
  1150. <P>NOARUPDATE
  1151.  
  1152. <BLOCKQUOTE>
  1153. 	<P>If set, indicates that libraries can't be updated, but only created whole.
  1154. </BLOCKQUOTE>
  1155.  
  1156. <P>NT</P>
  1157. <P>OPTIM
  1158.  
  1159. <BLOCKQUOTE>
  1160. 	<P>The C compiler flag for optimization, used by Cc and C++ rules.
  1161. </BLOCKQUOTE>
  1162.  
  1163. <P>OS
  1164.  
  1165. <BLOCKQUOTE>
  1166. 	<P>$(OS) contains the platform ($(NT), $(AIX), $(HPUX), $(SOLARIS), etc). Useful in switch statements.<BR>
  1167. 	switch $(OS) {<BR>
  1168. 	case NT : stmt1 ; stmt2 ;<BR>
  1169. 	case AIX : stmt1 ; stmt2 ;<BR>
  1170. 	}</P>
  1171. </BLOCKQUOTE>
  1172.  
  1173. <P>OSPLAT
  1174.  
  1175. <BLOCKQUOTE>
  1176. 	<P>Type of hardware platform ( VAX, PPC, AXP, X86, SPARC, MIPS, ARM, IA64, 390)</P>
  1177. </BLOCKQUOTE>
  1178.  
  1179. <P>OSFULL
  1180.  
  1181. <BLOCKQUOTE>
  1182. 	<P>The concatenation of $(OS)$(OSVER)$(OSPLAT), used when jam builds itself to determine the target binary directory.
  1183. 	$(OS) and $(OSPLAT) are determined by jam at its compile time (in jam.h). $(OSVER) can optionally be set by the
  1184. 	user.
  1185. </BLOCKQUOTE>
  1186.  
  1187. <P>OWNER
  1188.  
  1189. <BLOCKQUOTE>
  1190. 	<P>The owner of installed files. Used by Install* rules.
  1191. </BLOCKQUOTE>
  1192.  
  1193. <P>RANLIB
  1194.  
  1195. <BLOCKQUOTE>
  1196. 	<P>The name of the ranlib command. If set, causes the Ranlib action to be applied after the Archive action to targets
  1197. 	of the Library rule.
  1198. </BLOCKQUOTE>
  1199.  
  1200. <P>RC
  1201.  
  1202. <BLOCKQUOTE>
  1203. 	<P>Resource Compiler command.</P>
  1204. </BLOCKQUOTE>
  1205.  
  1206. <P>RCP
  1207.  
  1208. <BLOCKQUOTE>
  1209. 	<P>Remote copy command.</P>
  1210. </BLOCKQUOTE>
  1211.  
  1212. <P>RM
  1213.  
  1214. <BLOCKQUOTE>
  1215. 	<P>The command and options to remove a file.
  1216. </BLOCKQUOTE>
  1217.  
  1218. <P>RMDIR
  1219.  
  1220. <BLOCKQUOTE>
  1221. 	<P>The command and options to remove a directory.</P>
  1222. </BLOCKQUOTE>
  1223.  
  1224. <P>RSH
  1225.  
  1226. <BLOCKQUOTE>
  1227. 	<P>Remote Shell Command.</P>
  1228. </BLOCKQUOTE>
  1229.  
  1230. <P>SEARCH
  1231.  
  1232. <BLOCKQUOTE>
  1233. 	<P>Where to find something; used during binding and actions.</P>
  1234. </BLOCKQUOTE>
  1235.  
  1236. <P>SEARCH_SOURCE
  1237.  
  1238. <BLOCKQUOTE>
  1239. 	<P>The directory to find sources listed with Main, Library, Object, Bulk, File, Shell, InstallBin, InstallLib,
  1240. 	and InstallMan rules. This works by setting the jam-special variable SEARCH to the value of $(SEARCH_SOURCE) for
  1241. 	each of the rules' sources. The SubDir rule initializes SEARCH_SOURCE for each directory.
  1242. </BLOCKQUOTE>
  1243.  
  1244. <P>SED
  1245.  
  1246. <BLOCKQUOTE>
  1247. 	<P>Shell editor command..</P>
  1248. </BLOCKQUOTE>
  1249.  
  1250. <P>SHELLHEADER
  1251.  
  1252. <BLOCKQUOTE>
  1253. 	<P>A string inserted to the first line of every file created by the Shell rule.
  1254. </BLOCKQUOTE>
  1255.  
  1256. <P>SHELLMODE
  1257.  
  1258. <BLOCKQUOTE>
  1259. 	<P>Permissions for files installed by Shell rule.
  1260. </BLOCKQUOTE>
  1261.  
  1262. <P>SLASH
  1263.  
  1264. <BLOCKQUOTE>
  1265. 	<P>Directory separator character. <FONT SIZE="2" FACE="Courier New, Courier">(/)</FONT> on unix; <FONT SIZE="2"
  1266. 	FACE="Courier New, Courier">(\)</FONT> on windows..</P>
  1267. </BLOCKQUOTE>
  1268.  
  1269. <P>SOURCE_GRIST
  1270.  
  1271. <BLOCKQUOTE>
  1272. 	<P>Set by the SubDir to a value derived from the directory name, and used by Objects and related rules as 'grist'
  1273. 	to perturb file names.
  1274. </BLOCKQUOTE>
  1275.  
  1276. <P>STDHDRS
  1277.  
  1278. <BLOCKQUOTE>
  1279. 	<P>Directories where headers can be found without resorting to using the flag to the C compiler. The $(STDHDRS)
  1280. 	directories are used to find headers during scanning, but are not passed to the compiler commands as -I paths.<BR>
  1281. 	<FONT SIZE="2" FACE="Courier New, Courier">$(MSVCDIR)\\include</FONT> on windows.
  1282. </BLOCKQUOTE>
  1283.  
  1284. <P>SUBDIR
  1285.  
  1286. <BLOCKQUOTE>
  1287. 	<P>The path from the current directory to the directory last named by the SubDir rule.
  1288. </BLOCKQUOTE>
  1289.  
  1290. <P>SUBDIRRESET
  1291.  
  1292. <BLOCKQUOTE>
  1293. 	<P>Flags to manage on changing directories. Jambase example:<BR>
  1294. 	<FONT SIZE="2" FACE="Courier New, Courier">SUBDIRRESET ?= ASFLAGS HDRS C++FLAGS CCFLAGS ;</FONT></P>
  1295. </BLOCKQUOTE>
  1296.  
  1297. <P>SUBDIRRULES
  1298.  
  1299. <BLOCKQUOTE>
  1300. 	<P>Unknown.
  1301. </BLOCKQUOTE>
  1302.  
  1303. <P>SUFDLL
  1304.  
  1305. <BLOCKQUOTE>
  1306. 	<P>The suffix for <B>shared</B> libraries. Used by Library and Archive rules.<BR>
  1307. 	<FONT SIZE="2" FACE="Courier New, Courier">.so</FONT> on unix; <FONT SIZE="2" FACE="Courier New, Courier">.dll</FONT>
  1308. 	on windows.</P>
  1309. </BLOCKQUOTE>
  1310.  
  1311. <P>SUFEXE
  1312.  
  1313. <BLOCKQUOTE>
  1314. 	<P>The suffix for executable files, if none provided. Used by the Main rule.<BR>
  1315. 	<FONT SIZE="2" FACE="Courier New, Courier">.exe</FONT> on windows; null on unix.</P>
  1316. </BLOCKQUOTE>
  1317.  
  1318. <P>SUFILK <B>(unneeded. No unix counterpart)</B>
  1319.  
  1320. <BLOCKQUOTE>
  1321. 	<P>The suffix for xxx files. <FONT SIZE="2" FACE="Courier New, Courier">.ilk </FONT>on windows.</P>
  1322. </BLOCKQUOTE>
  1323.  
  1324. <P>SUFLIB
  1325.  
  1326. <BLOCKQUOTE>
  1327. 	<P>The suffix for <B>archive</B> libraries. Used by Library and Archive rules.<BR>
  1328. 	<FONT SIZE="2" FACE="Courier New, Courier">.a</FONT> on unix. <FONT SIZE="2" FACE="Courier New, Courier">.lib</FONT>
  1329. 	on windows.
  1330. </BLOCKQUOTE>
  1331.  
  1332. <P>SUFOBJ
  1333.  
  1334. <BLOCKQUOTE>
  1335. 	<P>The suffix for object files. Used by the Objects and related rules.<BR>
  1336. 	<FONT SIZE="2" FACE="Courier New, Courier">.obj </FONT>on windows; <FONT SIZE="2" FACE="Courier New, Courier">.o</FONT>
  1337. 	on unix.
  1338. </BLOCKQUOTE>
  1339.  
  1340. <P>SUFPDB <B>(unneeded. No unix counterpart)</B>
  1341.  
  1342. <BLOCKQUOTE>
  1343. 	<P>The suffix for xxx files. <FONT SIZE="2" FACE="Courier New, Courier">.pdb </FONT>on windows.</P>
  1344. </BLOCKQUOTE>
  1345.  
  1346. <P>TOP
  1347.  
  1348. <BLOCKQUOTE>
  1349. 	<P>The path from the current directory to the directory that has the Jamrules file. Used by the SubDir rule.</P>
  1350. </BLOCKQUOTE>
  1351.  
  1352. <P>UNDEFFLAG
  1353.  
  1354. <BLOCKQUOTE>
  1355. 	<P>The flag prefixed to each symbol for the Undefines rule (i.e., the compiler flag for undefined symbols). &quot;<FONT
  1356. 	SIZE="2" FACE="Courier New, Courier">-u _&quot;</FONT> on windows; &quot;<FONT SIZE="2" FACE="Courier New, Courier">-u</FONT>&quot;
  1357. 	on unix.
  1358. </BLOCKQUOTE>
  1359.  
  1360. <P>UNIX
  1361.  
  1362. <BLOCKQUOTE>
  1363. 	<P>$(UNIX) is true, if on a Unix platform.</P>
  1364. </BLOCKQUOTE>
  1365.  
  1366. <P>YACC
  1367.  
  1368. <BLOCKQUOTE>
  1369. 	<P>The yacc(1) command.
  1370. </BLOCKQUOTE>
  1371.  
  1372. <P>YACCFILES
  1373.  
  1374. <BLOCKQUOTE>
  1375. 	<P>The base filename generated by yacc(1).
  1376. </BLOCKQUOTE>
  1377.  
  1378. <P>YACCFLAGS
  1379.  
  1380. <BLOCKQUOTE>
  1381. 	<P>The yacc(1) command flags.
  1382. </BLOCKQUOTE>
  1383.  
  1384. <P>YACCGEN
  1385.  
  1386. <BLOCKQUOTE>
  1387. 	<P>The suffix used on generated yacc(1) output.
  1388. </BLOCKQUOTE>
  1389.  
  1390. <P>
  1391. <HR ALIGN="CENTER">
  1392. <B>Jam Language</B></P>
  1393. <P><B>Statements<BR>
  1394. </B>
  1395. <TABLE BORDER="1" WIDTH="98%">
  1396. 	<TR>
  1397. 		<TD WIDTH="23%">
  1398. 			<P ALIGN="CENTER">rule Rule
  1399. 		</TD>
  1400. 		<TD WIDTH="77%">statements to process a rule</TD>
  1401. 	</TR>
  1402. 	<TR>
  1403. 		<TD WIDTH="23%">
  1404. 			<P ALIGN="CENTER">actions Rule
  1405. 		</TD>
  1406. 		<TD WIDTH="77%">system commands for target update</TD>
  1407. 	</TR>
  1408. </TABLE>
  1409. <B>Modifiers on actions:<BR>
  1410. </B>
  1411. <TABLE BORDER="1" WIDTH="100%">
  1412. 	<TR>
  1413. 		<TD WIDTH="10%">
  1414. 			<P ALIGN="CENTER">together
  1415. 		</TD>
  1416. 		<TD WIDTH="90%">multiple instances of same rule on target get executed once with their sources ($(&gt;)) catenated</TD>
  1417. 	</TR>
  1418. 	<TR>
  1419. 		<TD WIDTH="10%">
  1420. 			<P ALIGN="CENTER">updated
  1421. 		</TD>
  1422. 		<TD WIDTH="90%">refers to updated sources only $(&gt;)</TD>
  1423. 	</TR>
  1424. 	<TR>
  1425. 		<TD WIDTH="10%">
  1426. 			<P ALIGN="CENTER">ignore
  1427. 		</TD>
  1428. 		<TD WIDTH="90%">ignore return status of command</TD>
  1429. 	</TR>
  1430. 	<TR>
  1431. 		<TD WIDTH="10%">
  1432. 			<P ALIGN="CENTER">quietly
  1433. 		</TD>
  1434. 		<TD WIDTH="90%">don't trace execution unless verbose</TD>
  1435. 	</TR>
  1436. 	<TR>
  1437. 		<TD WIDTH="10%">
  1438. 			<P ALIGN="CENTER">piecemeal
  1439. 		</TD>
  1440. 		<TD WIDTH="90%">iterate command each time with small subset of $(&gt;)</TD>
  1441. 	</TR>
  1442. 	<TR>
  1443. 		<TD WIDTH="10%">
  1444. 			<P ALIGN="CENTER">existing
  1445. 		</TD>
  1446. 		<TD WIDTH="90%">refers to currently existing sources only $(&gt;)</TD>
  1447. 	</TR>
  1448. 	<TR>
  1449. 		<TD WIDTH="10%">
  1450. 			<P ALIGN="CENTER">bind vars
  1451. 		</TD>
  1452. 		<TD WIDTH="90%">subject to binding before expanding in actions</TD>
  1453. 	</TR>
  1454. </TABLE>
  1455. <B>Special Rules:<BR>
  1456. </B>
  1457. <TABLE BORDER="1" WIDTH="100%">
  1458. 	<TR>
  1459. 		<TD WIDTH="11%">
  1460. 			<P ALIGN="CENTER">Always
  1461. 		</TD>
  1462. 		<TD WIDTH="89%">always build a target</TD>
  1463. 	</TR>
  1464. 	<TR>
  1465. 		<TD WIDTH="11%">
  1466. 			<P ALIGN="CENTER">Depends
  1467. 		</TD>
  1468. 		<TD WIDTH="89%">builds dependency graph. Appends each source on the dependency list of each target. Binds both targets and sources
  1469. 			as TARGETs.</TD>
  1470. 	</TR>
  1471. 	<TR>
  1472. 		<TD WIDTH="11%">
  1473. 			<P ALIGN="CENTER">Echo
  1474. 		</TD>
  1475. 		<TD WIDTH="89%">blurt out targets on stdout</TD>
  1476. 	</TR>
  1477. 	<TR>
  1478. 		<TD WIDTH="11%">
  1479. 			<P ALIGN="CENTER">Exit
  1480. 		</TD>
  1481. 		<TD WIDTH="89%">blurt out tarets and exit</TD>
  1482. 	</TR>
  1483. 	<TR>
  1484. 		<TD WIDTH="11%">
  1485. 			<P ALIGN="CENTER">Includes
  1486. 		</TD>
  1487. 		<TD WIDTH="89%">marks source as headers for target (codependency)</TD>
  1488. 	</TR>
  1489. 	<TR>
  1490. 		<TD WIDTH="11%">
  1491. 			<P ALIGN="CENTER">Leaves
  1492. 		</TD>
  1493. 		<TD WIDTH="89%">&nbsp;</TD>
  1494. 	</TR>
  1495. 	<TR>
  1496. 		<TD WIDTH="11%">
  1497. 			<P ALIGN="CENTER">NoCare
  1498. 		</TD>
  1499. 		<TD WIDTH="89%">don't panic if target can't be built</TD>
  1500. 	</TR>
  1501. 	<TR>
  1502. 		<TD WIDTH="11%">
  1503. 			<P ALIGN="CENTER">NoUpdate
  1504. 		</TD>
  1505. 		<TD WIDTH="89%">create target if needed; never update it</TD>
  1506. 	</TR>
  1507. 	<TR>
  1508. 		<TD WIDTH="11%">
  1509. 			<P ALIGN="CENTER">NotFile
  1510. 		</TD>
  1511. 		<TD WIDTH="89%">ignore timestamp of target (it's not a file)</TD>
  1512. 	</TR>
  1513. 	<TR>
  1514. 		<TD WIDTH="11%">
  1515. 			<P ALIGN="CENTER">Temporary
  1516. 		</TD>
  1517. 		<TD WIDTH="89%">target need not be present if sources haven't changed</TD>
  1518. 	</TR>
  1519. </TABLE>
  1520. <B>Special Variables set by Jam:<BR>
  1521. </B>
  1522. <TABLE BORDER="1" WIDTH="100%">
  1523. 	<TR>
  1524. 		<TD WIDTH="19%">
  1525. 			<P ALIGN="CENTER">$(&lt;)
  1526. 		</TD>
  1527. 		<TD WIDTH="81%">targets of rule (to left of : )</TD>
  1528. 	</TR>
  1529. 	<TR>
  1530. 		<TD WIDTH="19%">
  1531. 			<P ALIGN="CENTER">$(&gt;)
  1532. 		</TD>
  1533. 		<TD WIDTH="81%">sources of rule (to the right of : )</TD>
  1534. 	</TR>
  1535. 	<TR>
  1536. 		<TD WIDTH="19%">
  1537. 			<P ALIGN="CENTER">$(xxx)
  1538. 		</TD>
  1539. 		<TD WIDTH="81%">true on xxx (UNIX, NT, AIX, HPUX, SOLARIS)</TD>
  1540. 	</TR>
  1541. 	<TR>
  1542. 		<TD WIDTH="19%">
  1543. 			<P ALIGN="CENTER">$(OS)
  1544. 		</TD>
  1545. 		<TD WIDTH="81%">name of Operating System</TD>
  1546. 	</TR>
  1547. 	<TR>
  1548. 		<TD WIDTH="19%">
  1549. 			<P ALIGN="CENTER">$(JAMVERSION)
  1550. 		</TD>
  1551. 		<TD WIDTH="81%">version number 2.5a</TD>
  1552. 	</TR>
  1553. </TABLE>
  1554. <B>Special Variables used by Jam:<BR>
  1555. </B>
  1556. <TABLE BORDER="1" WIDTH="100%">
  1557. 	<TR>
  1558. 		<TD WIDTH="15%">
  1559. 			<P ALIGN="CENTER">SEARCH
  1560. 		</TD>
  1561. 		<TD WIDTH="85%">where to find something (used during binding and actions)</TD>
  1562. 	</TR>
  1563. 	<TR>
  1564. 		<TD WIDTH="15%">
  1565. 			<P ALIGN="CENTER">LOCATE
  1566. 		</TD>
  1567. 		<TD WIDTH="85%">where to plop something not found with SEARCH</TD>
  1568. 	</TR>
  1569. 	<TR>
  1570. 		<TD WIDTH="15%">
  1571. 			<P ALIGN="CENTER">HDRRULE
  1572. 		</TD>
  1573. 		<TD WIDTH="85%">rule to handle include files</TD>
  1574. 	</TR>
  1575. 	<TR>
  1576. 		<TD WIDTH="15%">
  1577. 			<P ALIGN="CENTER">HDRSCAN
  1578. 		</TD>
  1579. 		<TD WIDTH="85%">egrep regex to extract include files</TD>
  1580. 	</TR>
  1581. </TABLE>
  1582. </P>
  1583. <H2><B>Jam rules</B></H2>
  1584. <P><B>Special targets:</B></P>
  1585. <P>
  1586. <TABLE BORDER="1" WIDTH="100%">
  1587. 	<TR>
  1588. 		<TD WIDTH="8%">
  1589. 			<P ALIGN="CENTER"><B>all</B>
  1590. 		</TD>
  1591. 		<TD WIDTH="92%">parent of <B>first, shell, files, lib, exe<BR>
  1592. 			</B>(default if jam command line targets are not supplied)</TD>
  1593. 	</TR>
  1594. 	<TR>
  1595. 		<TD WIDTH="8%">
  1596. 			<P ALIGN="CENTER"><B>first</B>
  1597. 		</TD>
  1598. 		<TD WIDTH="92%">first dependent of<B> 'all',</B> for potential initialization</TD>
  1599. 	</TR>
  1600. 	<TR>
  1601. 		<TD WIDTH="8%">
  1602. 			<P ALIGN="CENTER"><B>shell</B>
  1603. 		</TD>
  1604. 		<TD WIDTH="92%">all <B>Shell </B>targets</TD>
  1605. 	</TR>
  1606. 	<TR>
  1607. 		<TD WIDTH="8%">
  1608. 			<P ALIGN="CENTER"><B>files</B>
  1609. 		</TD>
  1610. 		<TD WIDTH="92%">all <B>File</B> targets</TD>
  1611. 	</TR>
  1612. 	<TR>
  1613. 		<TD WIDTH="8%">
  1614. 			<P ALIGN="CENTER"><B>lib</B>
  1615. 		</TD>
  1616. 		<TD WIDTH="92%">all <B>Library</B> targets</TD>
  1617. 	</TR>
  1618. 	<TR>
  1619. 		<TD WIDTH="8%">
  1620. 			<P ALIGN="CENTER"><B>exe</B>
  1621. 		</TD>
  1622. 		<TD WIDTH="92%">all <B>Main</B> targets</TD>
  1623. 	</TR>
  1624. 	<TR>
  1625. 		<TD WIDTH="8%">
  1626. 			<P ALIGN="CENTER"><B>dirs</B>
  1627. 		</TD>
  1628. 		<TD WIDTH="92%">all <B>MkDir</B> targets</TD>
  1629. 	</TR>
  1630. 	<TR>
  1631. 		<TD WIDTH="8%">
  1632. 			<P ALIGN="CENTER"><B>clean</B>
  1633. 		</TD>
  1634. 		<TD WIDTH="92%">remove all <B>Shell, File, Library, Main</B> targets</TD>
  1635. 	</TR>
  1636. 	<TR>
  1637. 		<TD WIDTH="8%">
  1638. 			<P ALIGN="CENTER"><B>uninstall</B>
  1639. 		</TD>
  1640. 		<TD WIDTH="92%">remove all <B>Install </B>targets</TD>
  1641. 	</TR>
  1642. </TABLE>
  1643. </P>
  1644. <P><B>Jam Built-In Rules:</B></P>
  1645. <PRE><B></B></PRE>
  1646. <P>
  1647. <TABLE BORDER="1" WIDTH="96%">
  1648. 	<TR>
  1649. 		<TD WIDTH="18%">
  1650. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">As</FONT></B>
  1651. 		</TD>
  1652. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">As obj.o : source.s ;</FONT></TD>
  1653. 		<TD WIDTH="39%"><FONT FACE="Courier New, Courier">.s -&gt; .o</FONT></TD>
  1654. 	</TR>
  1655. 	<TR>
  1656. 		<TD WIDTH="18%">
  1657. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Bulk</FONT></B>
  1658. 		</TD>
  1659. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Bulk dir : files ;</FONT></TD>
  1660. 		<TD WIDTH="39%">populate directory with many files</TD>
  1661. 	</TR>
  1662. 	<TR>
  1663. 		<TD WIDTH="18%">
  1664. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Cc</FONT></B>
  1665. 		</TD>
  1666. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Cc obj.o : source.c ;</FONT></TD>
  1667. 		<TD WIDTH="39%"><FONT FACE="Courier New, Courier">.c -&gt; .o</FONT></TD>
  1668. 	</TR>
  1669. 	<TR>
  1670. 		<TD WIDTH="18%">
  1671. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">C++</FONT></B>
  1672. 		</TD>
  1673. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">C++ obj.o : source.cc ;</FONT></TD>
  1674. 		<TD WIDTH="39%"><FONT FACE="Courier New, Courier">.cpp -&gt; .o</FONT></TD>
  1675. 	</TR>
  1676. 	<TR>
  1677. 		<TD WIDTH="18%">
  1678. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Clean</FONT></B>
  1679. 		</TD>
  1680. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Clean clean : sources ;</FONT></TD>
  1681. 		<TD WIDTH="39%">remove source targets with 'jam clean'</TD>
  1682. 	</TR>
  1683. 	<TR>
  1684. 		<TD WIDTH="18%">
  1685. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">File</FONT></B>
  1686. 		</TD>
  1687. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">File dest : source ;</FONT></TD>
  1688. 		<TD WIDTH="39%">copy file</TD>
  1689. 	</TR>
  1690. 	<TR>
  1691. 		<TD WIDTH="18%">
  1692. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">GenFile</FONT></B>
  1693. 		</TD>
  1694. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">GenFile source.c : program args ;</FONT></TD>
  1695. 		<TD WIDTH="39%">make custom file</TD>
  1696. 	</TR>
  1697. 	<TR>
  1698. 		<TD WIDTH="18%">
  1699. 			<P ALIGN="CENTER">Glob
  1700. 		</TD>
  1701. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Glob directories : patterns ;</FONT></TD>
  1702. 		<TD WIDTH="39%">Scans <I>directories</I> for files matching regex <I>patterns</I>, returning the list of matching files.</TD>
  1703. 	</TR>
  1704. 	<TR>
  1705. 		<TD WIDTH="18%">
  1706. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">HardLink</FONT></B>
  1707. 		</TD>
  1708. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">HardLink target : source ;</FONT></TD>
  1709. 		<TD WIDTH="39%">make link from source to target</TD>
  1710. 	</TR>
  1711. 	<TR>
  1712. 		<TD WIDTH="18%">
  1713. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">HdrRule</FONT></B>
  1714. 		</TD>
  1715. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">HdrRule source : headers ;</FONT></TD>
  1716. 		<TD WIDTH="39%">handle #includes</TD>
  1717. 	</TR>
  1718. 	<TR>
  1719. 		<TD WIDTH="18%">
  1720. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallInto</FONT></B>
  1721. 		</TD>
  1722. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallInto dir : sources ;</FONT></TD>
  1723. 		<TD WIDTH="39%">install any files</TD>
  1724. 	</TR>
  1725. 	<TR>
  1726. 		<TD WIDTH="18%">
  1727. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallBin</FONT></B>
  1728. 		</TD>
  1729. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallBin dir : sources ;</FONT></TD>
  1730. 		<TD WIDTH="39%">install binaries</TD>
  1731. 	</TR>
  1732. 	<TR>
  1733. 		<TD WIDTH="18%">
  1734. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallLib</FONT></B>
  1735. 		</TD>
  1736. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallLib dir : sources ;</FONT></TD>
  1737. 		<TD WIDTH="39%">install library files</TD>
  1738. 	</TR>
  1739. 	<TR>
  1740. 		<TD WIDTH="18%">
  1741. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallFile</FONT></B>
  1742. 		</TD>
  1743. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallFile dir : sources ;</FONT></TD>
  1744. 		<TD WIDTH="39%">install files</TD>
  1745. 	</TR>
  1746. 	<TR>
  1747. 		<TD WIDTH="18%">
  1748. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallMan</FONT></B>
  1749. 		</TD>
  1750. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallMan dir : sources ;</FONT></TD>
  1751. 		<TD WIDTH="39%">install man pages</TD>
  1752. 	</TR>
  1753. 	<TR>
  1754. 		<TD WIDTH="18%">
  1755. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">InstallShell</FONT></B>
  1756. 		</TD>
  1757. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">InstallShell dir : sources ;</FONT></TD>
  1758. 		<TD WIDTH="39%">install shell scripts</TD>
  1759. 	</TR>
  1760. 	<TR>
  1761. 		<TD WIDTH="18%">
  1762. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Lex</FONT></B>
  1763. 		</TD>
  1764. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Lex source.c : source.l ;</FONT></TD>
  1765. 		<TD WIDTH="39%"><FONT FACE="Courier New, Courier">.l -&gt; .o</FONT></TD>
  1766. 	</TR>
  1767. 	<TR>
  1768. 		<TD WIDTH="18%">
  1769. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Library</FONT></B>
  1770. 		</TD>
  1771. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Library lib : source ;</FONT></TD>
  1772. 		<TD WIDTH="39%">archive library from source</TD>
  1773. 	</TR>
  1774. 	<TR>
  1775. 		<TD WIDTH="18%">
  1776. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">LibraryFromObjects</FONT></B>
  1777. 		</TD>
  1778. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">LibraryFromObjects lib : objects ;</FONT></TD>
  1779. 		<TD WIDTH="39%">archive library from objects</TD>
  1780. 	</TR>
  1781. 	<TR>
  1782. 		<TD WIDTH="18%">
  1783. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Libs</FONT></B>
  1784. 		</TD>
  1785. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Libs images : libraries ;</FONT></TD>
  1786. 		<TD WIDTH="39%">dependency on libraries</TD>
  1787. 	</TR>
  1788. 	<TR>
  1789. 		<TD WIDTH="18%">
  1790. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Main</FONT></B>
  1791. 		</TD>
  1792. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Main image : source ;</FONT></TD>
  1793. 		<TD WIDTH="39%">link executable from source</TD>
  1794. 	</TR>
  1795. 	<TR>
  1796. 		<TD WIDTH="18%">
  1797. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">MainFromObjects</FONT></B>
  1798. 		</TD>
  1799. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">MainFromObjects image : objects ;</FONT></TD>
  1800. 		<TD WIDTH="39%">link executable from objects</TD>
  1801. 	</TR>
  1802. 	<TR>
  1803. 		<TD WIDTH="18%">
  1804. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Match</FONT></B>
  1805. 		</TD>
  1806. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Match</FONT><I><FONT SIZE="2" FACE="Courier New, Courier"> regexps </FONT></I><B><FONT
  1807. 			SIZE="2" FACE="Courier New, Courier">:</FONT></B><I><FONT SIZE="2" FACE="Courier New, Courier"> list </FONT></I><B><FONT
  1808. 			SIZE="2" FACE="Courier New, Courier">;</FONT></B></TD>
  1809. 		<TD WIDTH="39%">Match regular expression<I> regexps</I> against strings in<I> list</I>.</TD>
  1810. 	</TR>
  1811. 	<TR>
  1812. 		<TD WIDTH="18%">
  1813. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">MkDir</FONT></B>
  1814. 		</TD>
  1815. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">MkDir dir ;</FONT></TD>
  1816. 		<TD WIDTH="39%">make directory</TD>
  1817. 	</TR>
  1818. 	<TR>
  1819. 		<TD WIDTH="18%">
  1820. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Object</FONT></B>
  1821. 		</TD>
  1822. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Object object : source ;</FONT></TD>
  1823. 		<TD WIDTH="39%">compile object from source</TD>
  1824. 	</TR>
  1825. 	<TR>
  1826. 		<TD WIDTH="18%">
  1827. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">ObjectCcFlags</FONT></B>
  1828. 		</TD>
  1829. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">ObjectCcFlags source : flags ;</FONT></TD>
  1830. 		<TD WIDTH="39%">c compiler flags for source</TD>
  1831. 	</TR>
  1832. 	<TR>
  1833. 		<TD WIDTH="18%">
  1834. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">ObjectC++Flags</FONT></B>
  1835. 		</TD>
  1836. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">ObjectC++Flags source : flags ;</FONT></TD>
  1837. 		<TD WIDTH="39%">c++ compiler flags for source</TD>
  1838. 	</TR>
  1839. 	<TR>
  1840. 		<TD WIDTH="18%">
  1841. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">ObjectHdrs</FONT></B>
  1842. 		</TD>
  1843. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">ObjectHdrs source : dirs ;</FONT></TD>
  1844. 		<TD WIDTH="39%">include directories for source</TD>
  1845. 	</TR>
  1846. 	<TR>
  1847. 		<TD WIDTH="18%">
  1848. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Objects</FONT></B>
  1849. 		</TD>
  1850. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Objects sources ;</FONT></TD>
  1851. 		<TD WIDTH="39%">compile sources</TD>
  1852. 	</TR>
  1853. 	<TR>
  1854. 		<TD WIDTH="18%">
  1855. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">RmTemps</FONT></B>
  1856. 		</TD>
  1857. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">RmTemps target : sources ;</FONT></TD>
  1858. 		<TD WIDTH="39%">remove temp sources after target made</TD>
  1859. 	</TR>
  1860. 	<TR>
  1861. 		<TD WIDTH="18%">
  1862. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Setuid</FONT></B>
  1863. 		</TD>
  1864. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Setuid images ;</FONT></TD>
  1865. 		<TD WIDTH="39%">mark executables suid</TD>
  1866. 	</TR>
  1867. 	<TR>
  1868. 		<TD WIDTH="18%">
  1869. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SoftLink</FONT></B>
  1870. 		</TD>
  1871. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SoftLink target : source ;</FONT></TD>
  1872. 		<TD WIDTH="39%">make symlink</TD>
  1873. 	</TR>
  1874. 	<TR>
  1875. 		<TD WIDTH="18%">
  1876. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SubDir</FONT></B>
  1877. 		</TD>
  1878. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SubDir TOP d1 d2 ... ;</FONT></TD>
  1879. 		<TD WIDTH="39%">start subdirectory Jamfile</TD>
  1880. 	</TR>
  1881. 	<TR>
  1882. 		<TD WIDTH="18%">
  1883. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SubDirCcFlags</FONT></B>
  1884. 		</TD>
  1885. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SubDirCcFlags flags ;</FONT></TD>
  1886. 		<TD WIDTH="39%">c compiler flags until next SubDir</TD>
  1887. 	</TR>
  1888. 	<TR>
  1889. 		<TD WIDTH="18%">
  1890. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SubDirC++Flags</FONT></B>
  1891. 		</TD>
  1892. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SubDirC++Flags flags ;</FONT></TD>
  1893. 		<TD WIDTH="39%">c++ compiler flags until next SubDir</TD>
  1894. 	</TR>
  1895. 	<TR>
  1896. 		<TD WIDTH="18%">
  1897. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SubDirHdrs</FONT></B>
  1898. 		</TD>
  1899. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SubDirHdrs d1 d2 ... ;</FONT></TD>
  1900. 		<TD WIDTH="39%">include directory until next SubDir</TD>
  1901. 	</TR>
  1902. 	<TR>
  1903. 		<TD WIDTH="18%">
  1904. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">SubInclude</FONT></B>
  1905. 		</TD>
  1906. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">SubInclude TOP d1 d2 ... ;</FONT></TD>
  1907. 		<TD WIDTH="39%">Include subdirectory Jamfile</TD>
  1908. 	</TR>
  1909. 	<TR>
  1910. 		<TD WIDTH="18%">
  1911. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Shell</FONT></B>
  1912. 		</TD>
  1913. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Shell exe : source ;</FONT></TD>
  1914. 		<TD WIDTH="39%">make a shell executable</TD>
  1915. 	</TR>
  1916. 	<TR>
  1917. 		<TD WIDTH="18%">
  1918. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Undefines</FONT></B>
  1919. 		</TD>
  1920. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Undefines images : symbols ;</FONT></TD>
  1921. 		<TD WIDTH="39%">save undef's for linking</TD>
  1922. 	</TR>
  1923. 	<TR>
  1924. 		<TD WIDTH="18%">
  1925. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">UserObject</FONT></B>
  1926. 		</TD>
  1927. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">UserObject object : source ;</FONT></TD>
  1928. 		<TD WIDTH="39%">handle unknown suffixes for object</TD>
  1929. 	</TR>
  1930. 	<TR>
  1931. 		<TD WIDTH="18%">
  1932. 			<P ALIGN="CENTER"><B><FONT FACE="Courier New, Courier">Yacc</FONT></B>
  1933. 		</TD>
  1934. 		<TD WIDTH="43%"><FONT SIZE="2" FACE="Courier New, Courier">Yacc source.c : source.y ;</FONT></TD>
  1935. 		<TD WIDTH="39%"><FONT FACE="Courier New, Courier">.y -&gt; .c</FONT></TD>
  1936. 	</TR>
  1937. </TABLE>
  1938. </P>
  1939.  
  1940. <P>Copyright 1993-2002 Christopher Seiwald and Perforce Software, Inc.
  1941.  
  1942. </BODY>
  1943.  
  1944. </HTML>
# Change User Description Committed
#2 4362 Dick Dunbar Documentation updates. 21 years ago
#1 4356 Dick Dunbar Jam 2.5 base established 21 years ago
//guest/perforce_software/jam/src/Jambase.html
#10 2564 rmg Use MSVCDIR instead of MSVCNT if MSVCNT isn't set.
 Microsoft
changed the name to... MSVCDIR in VC 6.0.

Porting change documented in RELNOTES.

=== computer:1666: Change 39600 by seiwald@play-seiwald on 2002/12/27 18:06:42 «		 22 years ago
#9 2511 rmg Make the description of SubDir match the Jambase code. 22 years ago
#8 2488 rmg Remove the /MR suffix from Jam.

=== computer:1666: Change 37146 by seiwald@play-seiwald... on 2002/10/21 15:23:18 «		 22 years ago
#7 1579 rmg Document the new SoftLink rule. 23 years ago
#6 1578 rmg Document the addition of INSTALLGRIST.
Related changes: 1577, 1572 		23 years ago
#5 1319 rmg Jam 2.3 + Perforce's internal changes.

This change is a drop of the Perforce internal J...am changes
since the 2.3 public release. The individual changes
represented herein are preserved in the
//guest/richard_geiger/intjam/ branch.

The intent of this drop is to provide a base, from which other
contributors' Jam branches may be integrated into. It is not
intended to become a packaged release in this state. We will
be integrating changes from other users prior to creating the
next packaged release.

Please refer to the src/RELNOTES file for an overview of the
changes present in this integration.

  - Richard Geiger
  Open Source Engineer at Perforce «		 23 years ago
#4 486 Perforce staff Jam 2.3.
 See RELNOTES for a list of changes from 2.2.x.

Just about every source... file was touched when jam got ANSI-fied. «		 24 years ago
#3 76 Laura Wingerd Integrate command-block-too-long fix, plus minor doc
updates. Jam/MR release level is now... 2.2.5.
(change 72, change 73, change 74, change 75) «		 26 years ago
#2 51 Laura Wingerd Update copyright year. 26 years ago
#1 2 laura Add Jam/MR 2.2 source 27 years ago