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)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy