--- a/docs/ccguide/phases.appendix	Sun Dec 08 11:22:23 2002 +0000
+++ b/docs/ccguide/phases.appendix	Tue Dec 10 19:15:05 2002 +0000
@@ -1,15 +1,13 @@
 <appendix>
 <title>Compiler Phase Command Lines</title>
 <para>
-This appendix decsribes the command lines and options for the
+This appendix describes the command lines and options for the
 individual compiler phases. Each phase of the compiler may be
 executed separately. The following information describes the
 options available to each phase.
 </para>
 
-<variablelist>
-<varlistentry><term>cc1 &amp; cc2 (C executives)</term>
-<listitem>
+<section><title>cc1 &amp; cc2 (C executives)</title>
 <cmdsynopsis>
   <command>cc</command>
   <arg>options</arg>
@@ -21,7 +19,7 @@
 </para>
 <informaltable frame="none">
 <tgroup cols="2">
-<colspec colwidth="0.5in"/>
+<colspec colwidth="0.9in"/>
 <colspec colwidth="3.0in"/>
 <tbody>
 <row>
@@ -44,7 +42,7 @@
 </para>
 <informaltable frame="none">
 <tgroup cols="2">
-<colspec colwidth="0.5in"/>
+<colspec colwidth="0.9in"/>
 <colspec colwidth="3.0in"/>
 <tbody>
 <row>
@@ -62,10 +60,366 @@
     <entry>-o</entry>
     <entry>Inhibits assembly code optimizer pass.</entry>
 </row>
+<row>
+    <entry>-p</entry>
+    <entry>Invoke compiler function profiler.</entry>
+</row>
+<row>
+    <entry>-r</entry>
+    <entry>Suppress link step. Leave output in ".r" file.</entry>
+</row>
+<row>
+    <entry>-m=<replaceable>size</replaceable></entry>
+    <entry>Size in pages (in kbytes if followed by a K) of
+additional memory the linker should allocate to
+object module.</entry>
+</row>
+<row>
+    <entry>-l=<replaceable>path</replaceable></entry>
+    <entry>Library file for linker to search before the standard library.</entry>
+</row>
+<row>
+    <entry>-f=<replaceable>path</replaceable></entry>
+    <entry>Override other output naming. Module name (in
+object module) is the last name in the pathlist.
+-f is not allowed with -a or -r.</entry>
+</row>
+<row>
+    <entry>-c</entry>
+    <entry>Output comments in assembly language code.</entry>
+</row>
+<row>
+    <entry>-s</entry>
+    <entry>Suppress generation of stack-checking code.</entry>
+</row>
+<row>
+    <entry>-d<replaceable>NAME</replaceable></entry>
+    <entry>Is equivalent to #define <replaceable>NAME</replaceable> 1 in the
+preprocessor. -d<replaceable>NAME</replaceable>=<replaceable>STRING</replaceable>
+is equivalent
+to #define <replaceable>NAME</replaceable> <replaceable>STRING</replaceable>.</entry>
+</row>
+<row>
+    <entry>-n=<replaceable>name</replaceable></entry>
+    <entry>output module name. <replaceable>name</replaceable> is used to override
+    the -f default output name.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>
+CC1 only:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-x</entry>
+    <entry>Create, but do not execute c.com command file.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>
+CC2 only:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-q</entry>
+    <entry>Quiet mode. Suppress echo of file names.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+
+<section><title>c.prep (C macro preprocessor)</title>
+<cmdsynopsis>
+  <command>c.prep</command>
+  <arg>options</arg>
+  <arg choice="plain"><replaceable>path</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<para>
+<replaceable>path</replaceable> is read as input. C.prep causes c.comp to generate
+psect directive with last element of pathlist and _c as the
+psect name. If <replaceable>path</replaceable> is /d0/myprog.c, psect name is myprog_c.
+Output is always to stdout.
+</para>
+<para>
+Recognized options:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-l</entry>
+    <entry>Cause c.comp to copy source lines to assembly output as comments.</entry>
+</row>
+<row>
+    <entry>-E=<replaceable>n</replaceable></entry>
+    <entry></entry>
+</row>
+<row>
+    <entry>-e=<replaceable>n</replaceable></entry>
+    <entry>Use <replaceable>n</replaceable> as psect edition number.</entry>
+</row>
+<row>
+    <entry>-D<replaceable>NAME</replaceable></entry>
+    <entry>Same as described above for cc1/cc2.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+
+<section><title>c.comp (One-pass compiler)</title>
+<cmdsynopsis>
+  <command>c.comp</command>
+  <arg>options</arg>
+  <arg><replaceable>file</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<para>
+If <replaceable>file</replaceable> is not present, c.comp will read stdin. Input text
+need not be c.prep output, but no preprocessor directives are
+recognized (#include, #define, macros etc.). Output assembly
+code is normally to stdout. Error message output is always
+written to stdout.
+</para>
+<para>
+Recognized options:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-s</entry>
+    <entry>Suppress generation of stack checking code.</entry>
+</row>
+<row>
+    <entry>-p</entry>
+    <entry>Generate profile code.</entry>
+</row>
+<row>
+    <entry>-o=<replaceable>path</replaceable></entry>
+    <entry>Write assembly output to <replaceable>path</replaceable>.</entry>
+</row>
 </tbody>
 </tgroup>
 </informaltable>
-</listitem>
-</varlistentry>
-</variablelist>
+</section>
+
+<section><title>c.pass (Pass One/Two of Two-pass Compiler)</title>
+<cmdsynopsis>
+  <command>c.pass1</command>
+  <arg>options</arg>
+  <arg><replaceable>file</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<cmdsynopsis>
+  <command>c.pass2</command>
+  <arg>options</arg>
+  <arg><replaceable>file</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<para>
+Command line and options are the same as c.comp. If the
+options given to c.pass1 are not given to c.pass2 also, c.pass2
+will not be able to read the c.pass1 output. Both c.pass1 and
+c.pass2 read stdin and write stdout normally.
+</para>
+</section>
+
+<section><title>c.opt (Assembly code optimizer)</title>
+<cmdsynopsis>
+  <command>c.opt</command>
+  <arg><replaceable>inpath</replaceable></arg>
+  <arg><replaceable>outpath</replaceable></arg>
+</cmdsynopsis>
+<para>
+C.opt reads stdin and writes stdout. <replaceable>inpath</replaceable>
+must be present if <replaceable>outpath</replaceable> is given.
+Since c.opt rearranges and changes code, comments and assembler directives
+may be rearranged.
+</para>
+</section>
+
+<section><title>c.asm (Assembler)</title>
+<cmdsynopsis>
+  <command>c.asm</command>
+  <arg choice="plain"><replaceable>file</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<para>
+C.asm reads <replaceable>file</replaceable> as assembly language input. Errors are
+written to stderr. Options are turned on with one '-' and
+negated with '--'. To turn listing on use -l. To turn
+listing off use --l. To turn conditionals off use --c.
+</para>
+<para>
+Recognized options:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-o=<replaceable>path</replaceable></entry>
+    <entry>Write relocatable output to path. Must be a disk file.</entry>
+</row>
+<row>
+    <entry>-l</entry>
+    <entry>Write listing to stdout. (default off)</entry>
+</row>
+<row>
+    <entry>-c</entry>
+    <entry>List conditional assembly lines. (default on)</entry>
+</row>
+<row>
+    <entry>-f</entry>
+    <entry>Formfeed for top of form. (default off)</entry>
+</row>
+<row>
+    <entry>-g</entry>
+    <entry>List all code bytes generated. (default off)</entry>
+</row>
+<row>
+    <entry>-x</entry>
+    <entry>Suppress macro expansion listing. (default on)</entry>
+</row>
+<row>
+    <entry>-e</entry>
+    <entry>Print errors. (default on)</entry>
+</row>
+<row>
+    <entry>-s</entry>
+    <entry>Print symbol table. (default off)</entry>
+</row>
+<row>
+    <entry>-d<replaceable>n</replaceable></entry>
+    <entry>Set lines per page to <replaceable>n</replaceable>. (default 66).</entry>
+</row>
+<row>
+    <entry>-w<replaceable>n</replaceable></entry>
+    <entry>Set line width to <replaceable>n</replaceable>. (default 80).</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
+
+<section><title>c.link (Linker)</title>
+<cmdsynopsis>
+  <command>c.link</command>
+  <arg>options</arg>
+  <arg choice="plain"><replaceable>mainline</replaceable></arg>
+  <arg rep="repeat" choice="plain"><replaceable>subn</replaceable></arg>
+  <arg>options</arg>
+</cmdsynopsis>
+<para>
+C.link turns c.asm output into executable form. All input
+files must contain relocatable object format (ROF) files.
+<replaceable>mainline</replaceable> specifies the base module from which to resolve
+external references. A mainline module is indicated by setting
+the type/lang value in the psect directive to non-zero. No other
+ROF can contain a mainline psect. The mainline and all
+subroutine files will appear in the final linked object module
+whether actually referenced or not.
+</para>
+<para>
+For the C Compiler, cstart.r is the mainline module. It is the
+mainline module's job to perform the initialization of data and
+the relocation of any data-text and data-data references within
+the initialized data using the information in the object module
+supplied be c.link.
+</para>
+<para>
+Recognized options:
+</para>
+<informaltable frame="none">
+<tgroup cols="2">
+<colspec colwidth="0.9in"/>
+<colspec colwidth="3.0in"/>
+<tbody>
+<row>
+    <entry>-o=<replaceable>path</replaceable></entry>
+    <entry>Linker object output file. Must be a disk
+file. The last element in <replaceable>path</replaceable> is used as the
+module name unless overridden by -n.</entry>
+</row>
+<row>
+    <entry>-n=<replaceable>name</replaceable></entry>
+    <entry>Use <replaceable>name</replaceable> as object file name.</entry>
+</row>
+<row>
+    <entry>-l=<replaceable>path</replaceable></entry>
+    <entry>Use <replaceable>path</replaceable> as library file. A library file
+consistes of one or more merged assembly ROF
+files. Each psect in the file is checked to see
+if it resolves any unresolved references. If
+so, the module is included on the final output
+module, otherwise it is skipped. No mainline
+psects are allowed in a library file. Library
+files are searched on the order given on the
+command line.</entry>
+</row>
+<row>
+    <entry>-E=<replaceable>n</replaceable></entry>
+    <entry></entry>
+</row>
+<row>
+    <entry>-e=<replaceable>n</replaceable></entry>
+    <entry><replaceable>n</replaceable> is used for the edition number in the final
+output module. 1 is used is -e is not present.</entry>
+</row>
+<row>
+    <entry>-M=<replaceable>size</replaceable></entry>
+    <entry><replaceable>size</replaceable> indicates the number of pages (kbytes if
+size is followed by a K) of additional memory,
+c.link will allocate to the data area of the
+final object module. If no additional memory is
+given, c.link add up the total data stack
+requirements found in the psect of the modules
+in the input modules.</entry>
+</row>
+<row>
+    <entry>-m</entry>
+    <entry>Prints linkage map indicating base addresses of
+the psects in the final object module.</entry>
+</row>
+<row>
+    <entry>-s</entry>
+    <entry>Prints final addresses assigned to symbols in
+the final object module.</entry>
+</row>
+<row>
+    <entry>-b=<replaceable>ept</replaceable></entry>
+    <entry>Link C functions to be callable by BASIC09.
+<replaceable>ept</replaceable> is the name of the function to be
+transferred to when BASIC09 executes the RUN command.</entry>
+</row>
+<row>
+    <entry>-t</entry>
+    <entry>Allows static data to appear in a BASIC09 callable
+module. It is assumed the C function called
+and the calling BASIC09 program have provided
+a sufficiently large static storage data area
+pointed to by the Y register.</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+</section>
 </appendix>