From 9c8d5f0be1ebc8d854681e2035b62237f0a68d4a Mon Sep 17 00:00:00 2001
From: Neil Conway <neilc@samurai.com>
Date: Tue, 17 Feb 2004 09:07:16 +0000
Subject: [PATCH] Add a few more <xref> tags to the SGML docs, where
appropriate. Original patch from Michael Glaesemann, additional changes by
Neil Conway.
---
doc/src/sgml/backup.sgml | 15 ++++++++-------
doc/src/sgml/ref/pg_restore.sgml | 6 +++---
doc/src/sgml/user-manag.sgml | 7 ++++---
3 files changed, 15 insertions(+), 13 deletions(-)
diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml
index c235cf9e4f5..4a35a3f8a64 100644
--- a/doc/src/sgml/backup.sgml
+++ b/doc/src/sgml/backup.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.35 2004/02/03 17:34:02 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/backup.sgml,v 2.36 2004/02/17 09:07:16 neilc Exp $
-->
<chapter id="backup">
<title>Backup and Restore</title>
@@ -86,9 +86,9 @@ pg_dump <replaceable class="parameter">dbname</replaceable> > <replaceable cl
When your database schema relies on OIDs (for instance as foreign
keys) you must instruct <application>pg_dump</> to dump the OIDs
as well. To do this, use the <option>-o</option> command line
- option. <quote>Large objects</> are not dumped by default, either.
- See <application>pg_dump</>'s command reference page if you use
- large objects.
+ option. <quote>Large objects</> are not dumped by default,
+ either. See <xref linkend="app-pgdump">'s reference page if you
+ use large objects.
</para>
</important>
@@ -260,7 +260,8 @@ cat <replaceable class="parameter">filename</replaceable>* | psql <replaceable c
pg_dump -Fc <replaceable class="parameter">dbname</replaceable> > <replaceable class="parameter">filename</replaceable>
</programlisting>
- See the <application>pg_dump</> and <application>pg_restore</> reference pages for details.
+ See the <xref linkend="app-pgdump"> and <xref
+ linkend="app-pgrestore"> reference pages for details.
</para>
</formalpara>
@@ -298,8 +299,8 @@ pg_dump -Fc <replaceable class="parameter">dbname</replaceable> > <replaceable c
</para>
<para>
- Please familiarize yourself with the
- <citerefentry><refentrytitle>pg_dump</></> reference page.
+ Please familiarize yourself with the <xref linkend="app-pgdump">
+ reference page.
</para>
</sect2>
</sect1>
diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml
index 20486ccca19..8f4c1cd9b92 100644
--- a/doc/src/sgml/ref/pg_restore.sgml
+++ b/doc/src/sgml/ref/pg_restore.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.45 2003/12/06 03:00:10 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/ref/pg_restore.sgml,v 1.46 2004/02/17 09:07:16 neilc Exp $ -->
<refentry id="APP-PGRESTORE">
<refmeta>
@@ -110,7 +110,7 @@
<para>
Create the database before restoring into it. (When this
option is used, the database named with <option>-d</option> is
- used only to issue the initial <literal>CREATE DATABASE</>
+ used only to issue the initial <command>CREATE DATABASE</>
command. All data is restored into the database name that
appears in the archive.)
</para>
@@ -454,7 +454,7 @@
internally executes <acronym>SQL</acronym> statements. If you have
problems running <application>pg_restore</application>, make sure
you are able to select information from the database using, for
- example, <application>psql</application>.
+ example, <xref linkend="app-psql">.
</para>
</refsect1>
diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
index 3a71bbe624a..0fda608285b 100644
--- a/doc/src/sgml/user-manag.sgml
+++ b/doc/src/sgml/user-manag.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/user-manag.sgml,v 1.24 2003/11/29 19:51:38 pgsql Exp $
+$PostgreSQL: pgsql/doc/src/sgml/user-manag.sgml,v 1.25 2004/02/17 09:07:16 neilc Exp $
-->
<chapter id="user-manag">
@@ -161,8 +161,9 @@ dropuser <replaceable>name</replaceable>
A user's attributes can be modified after creation with
<command>ALTER USER</command>.<indexterm><primary>ALTER USER</></>
- See the reference pages for <command>CREATE USER</command> and
- <command>ALTER USER</command> for details.
+ See the reference pages for the <xref linkend="sql-createuser"
+ endterm="sql-createuser-title"> and <xref linkend="sql-alteruser"
+ endterm="sql-alteruser-title"> commands for details.
</para>
<para>
--
GitLab