Suggest markup items for the future.

diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index 6d7d2b840ff394f4543bd45a0bfaec7ba6890c29..e29e3deeb7b758e55de4cdb2515719b9d9807de9 100644 (file)
--- a/doc/src/sgml/release.sgml
+++ b/doc/src/sgml/release.sgml
@@ -1,5 +1,15 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.359 2005/08/24 19:31:46 momjian Exp $
+
+Typical markup:
+[A-Z][A-Z ]+[A-Z]      <command>
+[A-Za-z_][A-Za-z0-9_]+()   <function>
+[A-Za-z_]/[A-Za-z_]+       <filename>
+PostgreSQL         <productname>
+pg_[A-Za-z0-9_]            <appication>
+[A-Z][A-Z]         <type>, <envar.
+               <literal>
+&<>                use &
 -->
 
 <appendix id="release">
@@ -88,7 +98,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
         prepared transaction can be committed after it is restarted. New
         syntax includes <command>PREPARE TRANSACTION</> and
         <command>COMMIT/ROLLBACK PREPARED</>. A new system view
-        pg_prepared_xacts has also been added.
+        <literal>pg_prepared_xacts</> has also been added.
        </para>
       </listitem>
      </varlistentry>
@@ -138,8 +148,9 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
         So, once a user logs into a role, she inherits capabilities of
         the login role plus any inherited roles, and can use
         <command>SET ROLE</> to switch to other member roles. This
-        change also replaces pg_shadow and pg_group by with new
-        role-capable catalogs pg_authid and pg_auth_members. The old
+        change also replaces <literal>pg_shadow</> and 
+        <literal>pg_group</> by with new role-capable catalogs 
+        <literal>pg_authid</> and <literal>pg_auth_members</>. The old
         tables are redefined as views on the new role tables.
        </para>
       </listitem>
@@ -1283,7 +1294,7 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
 
       <listitem>
        <para>
-        Move language handlers into the pg_catalog schema
+        Move language handlers into the <literal>pg_catalog</> schema
        </para>
        <para>
         This makes it easier to drop the public schema if desired.
@@ -1556,8 +1567,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
   
       <listitem>
        <para>
-        Add <option>-n</> / <option>--schema</> switch to pg_restore
-        (Richard van den Bergg)
+        Add <option>-n</> / <option>--schema</> switch to 
+        <application>pg_restore</> (Richard van den Bergg)
        </para>
        <para>
         This allows only objects from a specified schema to be restored.
@@ -1566,14 +1577,16 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
 
       <listitem>
        <para>
-        Allow pg_dump to dump a consistent snapshot of large objects
+        Allow <application>pg_dump</> to dump a consistent snapshot of 
+        large objects
         (Tom)
        </para>
       </listitem>
 
       <listitem>
        <para>
-        Allow pg_dump to dump large objects even in text mode (Tom)
+        Allow <application>pg_dump</> to dump large objects even in 
+        text mode (Tom)
        </para>
       </listitem>
 
@@ -1585,7 +1598,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
 
       <listitem>
        <para>
-        Add <option>--encoding</> to pg_dump (Magnus Hagander)
+        Add <option>--encoding</> to <application>pg_dump</> 
+        (Magnus Hagander)
        </para>
        <para>
         This allows a database to be dumped in an encoding that is
@@ -1668,7 +1682,8 @@ $PostgreSQL: pgsql/doc/src/sgml/release.sgml,v 1.358 2005/08/24 19:24:20 momjian
 
       <listitem>
        <para>
-        Allow pg_config to be compiled using MSVC (Andrew Dunstan)
+        Allow <application>pg_config</> to be compiled using MSVC (Andrew
+        Dunstan)
        </para>
        <para>
         This is required to build DBD::Pg using <application>MSVC</>.