Skip to content

Commit cda1bd6

Browse files
author
Neil Conway
committed
Various minor improvements to the SGML documentation: fix some incorrect
SGML markup, add a "deprecated features" section to the 8.0 release notes, untabify release.sgml and runtime.sgml, and make some other minor improvements.
1 parent 4dbb880 commit cda1bd6

13 files changed

+385
-318
lines changed

doc/src/sgml/errcodes.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<!-- $PostgreSQL: pgsql/doc/src/sgml/errcodes.sgml,v 1.7 2004/07/31 23:04:54 tgl Exp $ -->
1+
<!-- $PostgreSQL: pgsql/doc/src/sgml/errcodes.sgml,v 1.8 2004/08/24 00:06:50 neilc Exp $ -->
22

33
<appendix id="errcodes-appendix">
44
<title><productname>PostgreSQL</productname> Error Codes</title>
@@ -1133,7 +1133,7 @@
11331133

11341134
<row>
11351135
<entry>Class 58</entry>
1136-
<entry>System Error (errors external to PostgreSQL itself)</entry>
1136+
<entry>System Error (errors external to <productname>PostgreSQL</> itself)</entry>
11371137
</row>
11381138

11391139
<row>

doc/src/sgml/problems.sgml

Lines changed: 5 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.19 2004/08/24 00:06:50 neilc Exp $
33
-->
44

55
<sect1 id="bug-reporting">
@@ -11,8 +11,7 @@ $PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc E
1111
<productname>PostgreSQL</productname> more reliable because even the utmost
1212
care cannot guarantee that every part of
1313
<productname>PostgreSQL</productname>
14-
will work on every
15-
platform under every circumstance.
14+
will work on every platform under every circumstance.
1615
</para>
1716

1817
<para>
@@ -241,9 +240,9 @@ $PostgreSQL: pgsql/doc/src/sgml/problems.sgml,v 2.18 2004/03/09 16:57:46 neilc E
241240
in each new release, so it is quite possible that a bug you have
242241
encountered in an older release of <productname>PostgreSQL</>
243242
has already been fixed. We can only provide limited support for
244-
sites using older releases of PostgreSQL; if you require more
245-
than we can provide, consider acquiring a commercial support
246-
contract.
243+
sites using older releases of <productname>PostgreSQL</>; if you
244+
require more than we can provide, consider acquiring a
245+
commercial support contract.
247246
</para>
248247
<para>
249248
</para>

doc/src/sgml/ref/alter_index.sgml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.3 2004/08/21 16:16:04 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_index.sgml,v 1.4 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -167,7 +167,8 @@ ALTER INDEX distributors SET TABLESPACE fasttablespace;
167167
<title>Compatibility</title>
168168

169169
<para>
170-
<literal>ALTER INDEX</> is a PostgreSQL extension.
170+
<command>ALTER INDEX</> is a <productname>PostgreSQL</productname>
171+
extension.
171172
</para>
172173
</refsect1>
173174
</refentry>

doc/src/sgml/ref/alter_sequence.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.7 2003/11/29 19:51:38 pgsql Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_sequence.sgml,v 1.8 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -14,7 +14,7 @@ PostgreSQL documentation
1414
ALTER SEQUENCE
1515
</refname>
1616
<refpurpose>
17-
alter the definition of a sequence generator
17+
change the definition of a sequence generator
1818
</refpurpose>
1919
</refnamediv>
2020

doc/src/sgml/ref/create_table_as.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.22 2004/08/04 21:33:42 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/create_table_as.sgml,v 1.23 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -11,7 +11,7 @@ PostgreSQL documentation
1111

1212
<refnamediv>
1313
<refname>CREATE TABLE AS</refname>
14-
<refpurpose>create a new table from the results of a query</refpurpose>
14+
<refpurpose>define a new table from the results of a query</refpurpose>
1515
</refnamediv>
1616

1717
<indexterm zone="sql-createtableas">

doc/src/sgml/ref/create_tablespace.sgml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.3 2004/08/02 04:25:37 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/create_tablespace.sgml,v 1.4 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -34,8 +34,8 @@ CREATE TABLESPACE <replaceable class="parameter">tablespacename</replaceable> [
3434
</para>
3535

3636
<para>
37-
A tablespace allows superusers to define an alternative location on the
38-
file system where the data files representing database objects
37+
A tablespace allows superusers to define an alternative location on
38+
the file system where the data files containing database objects
3939
(such as tables and indexes) may reside.
4040
</para>
4141

doc/src/sgml/ref/psql-ref.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.120 2004/08/14 23:49:07 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/psql-ref.sgml,v 1.121 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -771,7 +771,7 @@ testdb=>
771771
<listitem>
772772
<para>
773773
Shows the copyright and distribution terms of
774-
<application>PostgreSQL</application>.
774+
<productname>PostgreSQL</productname>.
775775
</para>
776776
</listitem>
777777
</varlistentry>

doc/src/sgml/ref/release_savepoint.sgml

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.1 2004/08/12 19:12:21 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/release_savepoint.sgml,v 1.2 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -77,7 +77,7 @@ RELEASE [ SAVEPOINT ] <replaceable>savepoint_name</replaceable>
7777

7878
<para>
7979
It is not possible to release a savepoint when the transaction is in
80-
aborted state.
80+
an aborted state.
8181
</para>
8282

8383
<para>
@@ -108,9 +108,11 @@ COMMIT;
108108
<title>Compatibility</title>
109109

110110
<para>
111-
The SQL2003 standard specifies that the keyword SAVEPOINT is mandatory.
112-
<productname>PostgreSQL</productname> allows the SAVEPOINT keyword to be
113-
omitted. Otherwise, this command is fully conforming.
111+
The SQL2003 standard specifies that the keyword
112+
<literal>SAVEPOINT</literal> is mandatory.
113+
<productname>PostgreSQL</productname> allows the
114+
<literal>SAVEPOINT</literal> keyword to be omitted. Otherwise, this
115+
command is fully conforming.
114116
</para>
115117
</refsect1>
116118

doc/src/sgml/ref/rollback_to.sgml

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.2 2004/08/12 19:12:21 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/rollback_to.sgml,v 1.3 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -128,13 +128,15 @@ COMMIT;
128128
<title>Compatibility</title>
129129

130130
<para>
131-
The SQL2003 standard specifies that the keyword SAVEPOINT is mandatory.
132-
<productname>PostgreSQL</productname> and <productname>Oracle</productname>
133-
allow the SAVEPOINT keyword to be omitted. SQL2003 allows only
134-
WORK, not TRANSACTION, as a noise word after ROLLBACK. Also, SQL2003
135-
has an optional clause AND [ NO ] CHAIN which is not currently supported
136-
by <productname>PostgreSQL</productname>. Otherwise, this command is
137-
fully conforming.
131+
The SQL2003 standard specifies that the keyword
132+
<literal>SAVEPOINT</> is mandatory. <productname>PostgreSQL</> and
133+
<productname>Oracle</> allow the <literal>SAVEPOINT</literal>
134+
keyword to be omitted. SQL2003 allows only <literal>WORK</>, not
135+
<literal>TRANSACTION</>, as a noise word after
136+
<literal>ROLLBACK</>. Also, SQL2003 has an optional clause
137+
<literal>AND [ NO ] CHAIN</> which is not currently supported by
138+
<productname>PostgreSQL</>. Otherwise, this command is fully
139+
conforming.
138140
</para>
139141
</refsect1>
140142

doc/src/sgml/ref/select_into.sgml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/select_into.sgml,v 1.29 2004/08/04 21:33:42 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/select_into.sgml,v 1.30 2004/08/24 00:06:51 neilc Exp $
33
PostgreSQL documentation
44
-->
55

@@ -11,7 +11,7 @@ PostgreSQL documentation
1111

1212
<refnamediv>
1313
<refname>SELECT INTO</refname>
14-
<refpurpose>create a new table from the results of a query</refpurpose>
14+
<refpurpose>define a new table from the results of a query</refpurpose>
1515
</refnamediv>
1616

1717
<indexterm zone="sql-selectinto">

0 commit comments

Comments
 (0)