From 5d14b0d08c708056239ae457775ed4ef7a917a75 Mon Sep 17 00:00:00 2001
From: Bruce Momjian <bruce@momjian.us>
Date: Wed, 24 Aug 2005 19:31:46 +0000
Subject: [PATCH] Suggest markup items for the future.
---
doc/src/sgml/release.sgml | 37 ++++++++++++++++++++++++++-----------
1 file changed, 26 insertions(+), 11 deletions(-)
diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml
index 6d7d2b840ff..e29e3deeb7b 100644
--- 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</>.
--
GitLab