Index: chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/fdp-primer/psgml-mode/chapter.sgml,v
retrieving revision 1.10
diff -u -r1.10 chapter.sgml
--- chapter.sgml	24 Sep 2005 23:15:42 -0000	1.10
+++ chapter.sgml	26 Dec 2008 02:01:53 -0000
@@ -34,8 +34,8 @@
   <title>Using <literal>sgml-mode</literal> with
     <application>Emacs</application></title>
   
-  <para>Recent versions of <application>Emacs</application> or <application>XEmacs</application> (available from the ports
-    collection) contain a very useful package called PSGML. Automatically
+  <para>Recent versions of <application>Emacs</application> or <application>XEmacs</application> (available from the Ports
+    Collection) contain a very useful package called PSGML (can be installed from <filename role="package">editors/psgml</filename>).  Automatically
     invoked when a file with the <filename>.sgml</filename> extension is loaded,
     or by typing <command>M-x sgml-mode</command>, it is a major mode for
     dealing with SGML files, elements and attributes.</para>
@@ -48,9 +48,9 @@
       <term><command>C-c C-e</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-insert-element</literal>. You will be
+	<para>Runs <function>sgml-insert-element</function>. You will be
 	  prompted for the name of the element to insert at the current point.
-	  You can use the TAB key to complete the element. Elements that are
+	  You can use the <keycap>Tab</keycap> key to complete the element. Elements that are
 	  not valid at the current point will be disallowed.</para>
 
 	<para>The start and end tags for the element will be inserted. If the
@@ -63,7 +63,7 @@
       <term><command>C-c =</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-change-element-name</literal>. Place the
+	<para>Runs <function>sgml-change-element-name</function>. Place the
 	  point within an element and run this command. You will be prompted
 	  for the name of the element to change to. Both the start and end
 	  tags of the current element will be changed to the new
@@ -75,8 +75,8 @@
       <term><command>C-c C-r</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-tag-region</literal>. Select some text (move
-	  to start of text, C-space, move to end of text, C-space) and then
+	<para>Runs <function>sgml-tag-region</function>. Select some text (move
+	  to start of text, <command>C-space</command>, move to end of text, <command>C-space</command>) and then
 	  run this command. You will be prompted for the element to use. This
 	  element will then be inserted immediately before and after your
 	  marked region.</para>
@@ -87,7 +87,7 @@
       <term><command>C-c -</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-untag-element</literal>. Place the point
+	<para>Runs <function>sgml-untag-element</function>. Place the point
 	  within the start or end tag of an element you want to remove, and
 	  run this command. The element's start and end tags will be
 	  removed.</para>
@@ -98,7 +98,7 @@
       <term><command>C-c C-q</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-fill-element</literal>. Will recursively fill
+	<para>Runs <function>sgml-fill-element</function>. Will recursively fill
 	  (i.e., reformat) content from the current element in. The filling
 	  <emphasis>will</emphasis> affect content in which whitespace is
 	  significant, such as within <sgmltag>programlisting</sgmltag>
@@ -110,9 +110,9 @@
       <term><command>C-c C-a</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-edit-attributes</literal>. Opens a second
+	<para>Runs <function>sgml-edit-attributes</function>. Opens a second
 	  buffer containing a list of all the attributes for the closest
-	  enclosing element, and their current values. Use TAB to navigate
+	  enclosing element, and their current values. Use <keycap>Tab</keycap> to navigate
 	  between attributes, <command>C-k</command> to remove an existing
 	  value and replace it with a new one, <command>C-c C-c</command>
 	  to close this buffer and return to the main document.</para>
@@ -123,7 +123,7 @@
       <term><command>C-c C-v</command></term>
       
       <listitem>
-	<para>Runs <literal>sgml-validate</literal>. Prompts you to save the
+	<para>Runs <function>sgml-validate</function>. Prompts you to save the
 	  current document (if necessary) and then runs an SGML validator. The
 	  output from the validator is captured into a new buffer, and you can
 	  then navigate from one troublespot to the next, fixing markup errors
@@ -135,7 +135,7 @@
       <term><command>C-c /</command></term>
 
       <listitem>
-        <para>Runs <literal>sgml-insert-end-tag</literal>. Inserts the
+        <para>Runs <function>sgml-insert-end-tag</function>. Inserts the
 	  end tag for the current open element.</para>
       </listitem>
     </varlistentry>