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 -N -r1.27.2.7 -r1.27.2.8
--- openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml	22 Apr 2017 17:18:48 -0000	1.27.2.7
+++ openacs-4/packages/acs-core-docs/www/xml/developers-guide/i18n.xml	2 Jun 2017 11:12:58 -0000	1.27.2.8
@@ -165,7 +165,7 @@
           <para>
             The advantage of the short syntax is that it&#39;s short. It&#39;s
             as simple as inserting the value of a variable.  Example:
-            <replaceable><span>#</span>forum.title#</replaceable>
+            <computeroutput>#<replaceable>forum.title</replaceable>#</computeroutput>
           </para>
         </listitem>
 
@@ -402,11 +402,11 @@
           <tbody>
             <row>
                <entry>class_instance_pages_csv</entry>
-               <entry><span>#</span>dotlrn.class_page_home_title#,Simple 2-Column;<span>#</span>dotlrn.class_page_calendar_title#,Simple 1-Column;<span>#</span>dotlrn.class_page_file_storage_title#,Simple 1-Column</entry>
+               <entry><computeroutput>#<replaceable>dotlrn.class_page_home_title</replaceable>#</computeroutput>,Simple 2-Column;<computeroutput>#<replaceable>dotlrn.class_page_calendar_title</replaceable>#</computeroutput>,Simple 1-Column;<computeroutput>#<replaceable>dotlrn.class_page_file_storage_title</replaceable>#</computeroutput>,Simple 1-Column</entry>
             </row>
             <row>
                <entry>departments_pretty_name</entry>
-               <entry><span>#</span>departments_pretty_name#</entry>
+               <entry><computeroutput>#<replaceable>departments_pretty_name</replaceable>#</computeroutput></entry>
             </row>
           </tbody>
         </tgroup>
@@ -437,7 +437,7 @@
             </row>
             <row>
                <entry>parameter::get -parameter departments_pretty_name</entry>
-               <entry><span>#</span>departments_pretty_name#</entry>
+               <entry><computeroutput>#<replaceable>departments_pretty_name</replaceable>#</computeroutput></entry>
             </row>
           </tbody>
         </tgroup>