Index: /trunk/source/doc/src/openmcl-documentation.xml
===================================================================
--- /trunk/source/doc/src/openmcl-documentation.xml	(revision 8547)
+++ /trunk/source/doc/src/openmcl-documentation.xml	(revision 8548)
@@ -279,5 +279,5 @@
 </programlisting>
         <para>The openmcl shell script will pass all of its arguments
-        to the OpenMCL kernel.  See <xref linkend="invocation"/> for
+        to the OpenMCL kernel.  See <xref linkend="Invocation"/> for
         more information about "args".  When invoked this way, the
         lisp should be able to initialize the
@@ -292,5 +292,14 @@
 </programlisting>
       </sect2>
-
+      <sect2 id="Invocation">
+	<title>Invocation</title>
+	<para>Assuming that the shell script is properly installed, it can be used to invoke OpenMCL from a shell prompt:
+	<programlisting>
+shell&gt;<replaceable>ccl</replaceable> <emphasis>args</emphasis>
+	</programlisting>
+	<literal>ccl</literal> will run a 32-bit session;
+	<literal>ccl64</literal> will run a 64-bit session.
+	</para>
+      </sect2>
       <sect2 id="Personal-Customization-with-the-Init-File">
 	<title>Personal Customization with the Init File</title>
@@ -604,5 +613,5 @@
     here.</para>
 
-    <sect1 id="building-definitions"><title>>building definitions</title>
+    <sect1 id="building-definitions"><title>building definitions</title>
       <para>The following terms are used in subsequent sections; it
       may be helpful to refer to these definitions.</para>
@@ -7530,5 +7539,5 @@
 	      <listitem>
 		<para>The argument/return values
-		is <link linkend=""Referencing-and-Using-Foreign-Memory-Addresses">a MACPTR</link>.</para>
+		is <link linkend="Referencing-and-Using-Foreign-Memory-Addresses">a MACPTR</link>.</para>
 	      </listitem>
 	    </varlistentry>
@@ -9878,5 +9887,5 @@
 	      <listitem>
 		<para>NIL or a keyword; the keyword may contain
-		<link linkend="arb30">escaping constructs</link>.</para>
+		<link linkend="Case-sensitivity-of-foreign-names-in-OpenMCL" >escaping constructs</link>.</para>
 	      </listitem>
 	    </varlistentry>
@@ -10029,5 +10038,5 @@
 	    that would mean that any stand-alone application using it would
 	    have to include a copy of the interface database
-	    (see <xref linkend="arb25"/>), which is undesireable
+	    (see <xref linkend="The-Interface-Database"/>), which is undesireable
 	    because it's large.
 	  </para>
@@ -10201,5 +10210,5 @@
 	      <listitem>
 		<para>a keyword which names a foreign type or record, as
-		described in <xref linkend="arb45"/>.
+		described in <xref linkend="Foreign-type--record--and-field-names"/>.
 		</para>
 	      </listitem>
@@ -10544,5 +10553,5 @@
 	      <listitem>
 		<para>One of the foreign argument-type keywords, described
-		above, or an equivalent <link linkend="arb23">foreign
+		above, or an equivalent <link linkend="Specifying-And-Using-Foreign-Types">foreign
 		type specifier</link>.</para>
 	      </listitem>
@@ -10563,5 +10572,5 @@
 	      <listitem>
 		<para>One of the foreign argument-type keywords, described
-		above, or an equivalent <link linkend="arb23">foreign
+		above, or an equivalent <link linkend="Specifying-And-Using-Foreign-Types">foreign
 		type specifier</link>.</para>
 	      </listitem>
@@ -10658,5 +10667,5 @@
 	      <listitem>
 		<para>One of the foreign argument-type keywords, described
-		above, or an equivalent <link linkend="arb23">foreign
+		above, or an equivalent <link linkend="Specifying-And-Using-Foreign-Types">foreign
 		type specifier</link>.</para>
 	      </listitem>
@@ -10677,5 +10686,5 @@
 	      <listitem>
 		<para>One of the foreign argument-type keywords, described
-		above, or an equivalent <link linkend="arb23">foreign
+		above, or an equivalent <link linkend="Specifying-And-Using-Foreign-Types">foreign
 		type specifier</link>.</para>
 	      </listitem>
@@ -10814,12 +10823,13 @@
 
 	      <listitem>
-		<para>One of the foreign argument-type keywords, described
-		above, or an equivalent <link linkend="arb23">foreign
-		type specifier</link>.
-		In addition, if the keyword
+		<para>One of the foreign argument-type keywords,
+		described above, or an equivalent <link
+		linkend="Specifying-And-Using-Foreign-Types">foreign
+		type specifier</link>.  In addition, if the keyword
 		:WITHOUT-INTERRUPTS is specified, the callback will be
-		executed with lisp interrupts disabled if the corresponding
-		var is non-NIL. If :WITHOUT-INTERRUPTS is specified more
-		than once, the rightmost instance wins.</para>
+		executed with lisp interrupts disabled if the
+		corresponding var is non-NIL. If :WITHOUT-INTERRUPTS
+		is specified more than once, the rightmost instance
+		wins.</para>
 	      </listitem>
 	    </varlistentry>
@@ -10887,10 +10897,10 @@
 	  bound to the &#34;OS&#34; package and with readtable-case preserved.</para>
 	  
-	  <para>Does a lookup on that symbol
-	  in <link linkend="arb25">the OpenMCL interface database</link>,
-	  signalling
-	  an error if no foreign function information can be found for the
-	  symbol in any 
-	  active <link linkend="arb29">interface directory</link>.</para>
+	  <para>Does a lookup on that symbol in <link
+	  linkend="The-Interface-Database">the OpenMCL interface
+	  database</link>, signalling an error if no foreign function
+	  information can be found for the symbol in any active <link
+	  linkend="Using-Interface-Directories">interface
+	  directory</link>.</para>
 
 	  <para>Notes the foreign function information, including the foreign
@@ -11205,5 +11215,5 @@
 
 	  <simplelist type="inline">
-	    <member><xref linkend="arb35"/></member>
+	    <member><xref linkend="Tutorial--Allocating-Foreign-Data-on-the-Lisp-Heap"/></member>
 	  </simplelist>
 	</refsect1>