Index: openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml,v
diff -u -r1.6 -r1.7
--- openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml	14 Oct 2003 10:10:06 -0000	1.6
+++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml	11 Dec 2003 21:39:48 -0000	1.7
@@ -100,21 +100,21 @@
         <listitem>
           <para>
             The <emphasis role="strong">short</emphasis>:
-            <computeroutput>#<emphasis>package_key.message_key</emphasis>#</computeroutput>
+            <computeroutput>#<replaceable>package_key.message_key</replaceable>#</computeroutput>
           </para>
           <para>
             The advantage of the short syntax is that it's short. It's
             as simple as inserting the value of a variable.  Example:
-            <emphasis>#forum.title#</emphasis>
+            <replaceable>#forum.title#</replaceable>
           </para>
         </listitem>
 
         <listitem>
           <para>
             The <emphasis role="strong">verbose</emphasis>: <computeroutput>&lt;trn
-            key="<emphasis>package_key.message_key</emphasis>"
-            locale="<emphasis>locale</emphasis>"&gt;<emphasis>default
-            text</emphasis>&lt;/trn&gt;</computeroutput>
+            key="<replaceable>package_key.message_key</replaceable>"
+            locale="<replaceable>locale</replaceable>"&gt;<replaceable>default
+            text</replaceable>&lt;/trn&gt;</computeroutput>
           </para>
           <para>
             The verbose syntax allows you to specify a default text in
@@ -131,8 +131,8 @@
         <listitem>
           <para>
             The <emphasis role="strong">temporary</emphasis>:
-           <computeroutput> &lt;#<emphasis>message_key</emphasis>
-           <emphasis>original text</emphasis>#&gt;</computeroutput>
+           <computeroutput> &lt;#<replaceable>message_key</replaceable>
+           <replaceable>original text</replaceable>#&gt;</computeroutput>
           </para>
           <para>
             This syntax has been designed to make it easy to
@@ -177,7 +177,7 @@
         parameters, taken directly from the dotlrn package.
       </para>
 
-      <table frame="all">
+      <informaltable frame="all">
         <tgroup cols="2" colsep="1" rowsep="1">
           <colspec colname="c1"/>
           <colspec colname="c2"/>
@@ -198,13 +198,13 @@
             </row>
           </tbody>
         </tgroup>
-      </table>
+      </informaltable>
 
       <para>
         Then, depending on how we retrieve the value, here's what we get:
       </para>
   
-      <table frame="all">
+      <informaltable frame="all">
         <tgroup cols="2" colsep="1" rowsep="1">
           <colspec colname="c1"/>
           <colspec colname="c2"/>
@@ -229,7 +229,7 @@
             </row>
           </tbody>
         </tgroup>
-      </table>
+      </informaltable>
   
       <para>
         The value in the rightmost column in the table above is the