database/postgres
database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-05-02 11:44:50 +03:00
Code

Minor SGML improvements.

Browse Source
This commit is contained in:
Neil Conway 2004-03-23 13:21:41 +00:00
parent 9f894981da
commit 446b5476e5
4 changed files with 17 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
doc/src/sgml/ref/alter_domain.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.11 2003/11/29 19:51:38 pgsql Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/alter_domain.sgml,v 1.12 2004/03/23 13:21:41 neilc Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -139,7 +139,7 @@ ALTER DOMAIN <replaceable class="PARAMETER">name</replaceable>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>CASCADE</term> <term><literal>CASCADE</literal></term>
<listitem> <listitem>
<para> <para>
Automatically drop objects that depend on the constraint. Automatically drop objects that depend on the constraint.
@ -148,7 +148,7 @@ ALTER DOMAIN <replaceable class="PARAMETER">name</replaceable>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>RESTRICT</term> <term><literal>RESTRICT</literal></term>
<listitem> <listitem>
<para> <para>
Refuse to drop the constraint if there are any dependent Refuse to drop the constraint if there are any dependent
@ -174,11 +174,11 @@ ALTER DOMAIN <replaceable class="PARAMETER">name</replaceable>
<title>Examples</title> <title>Examples</title>
<para> <para>
To add a NOT NULL constraint to a domain: To add a <literal>NOT NULL</literal> constraint to a domain:
<programlisting> <programlisting>
ALTER DOMAIN zipcode SET NOT NULL; ALTER DOMAIN zipcode SET NOT NULL;
</programlisting> </programlisting>
To remove a NOT NULL constraint from a domain: To remove a <literal>NOT NULL</literal> constraint from a domain:
<programlisting> <programlisting>
ALTER DOMAIN zipcode DROP NOT NULL; ALTER DOMAIN zipcode DROP NOT NULL;
</programlisting> </programlisting>

11
doc/src/sgml/ref/cluster.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/cluster.sgml,v 1.31 2003/11/29 19:51:38 pgsql Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/cluster.sgml,v 1.32 2004/03/23 13:21:41 neilc Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -129,9 +129,10 @@ CLUSTER
</para> </para>
<para> <para>
Because the planner records statistics about the ordering of tables, it Because the planner records statistics about the ordering of
is advisable to run <command>ANALYZE</command> on the newly clustered tables, it is advisable to run <xref linkend="sql-analyze"
table. Otherwise, the planner may make poor choices of query plans. endterm="sql-analyze-title"> on the newly clustered table.
Otherwise, the planner may make poor choices of query plans.
</para> </para>
<para> <para>
@ -175,7 +176,7 @@ CLUSTER emp_ind ON emp;
</para> </para>
<para> <para>
Cluster the <literal>employees</literal> relation using the same Cluster the <literal>employees</literal> table using the same
index that was used before: index that was used before:
<programlisting> <programlisting>
CLUSTER emp; CLUSTER emp;

6
doc/src/sgml/ref/truncate.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/truncate.sgml,v 1.16 2003/11/29 19:51:39 pgsql Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/truncate.sgml,v 1.17 2004/03/23 13:21:41 neilc Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -60,8 +60,8 @@ TRUNCATE [ TABLE ] <replaceable class="PARAMETER">name</replaceable>
</para> </para>
<para> <para>
<command>TRUNCATE</> will not run any user-defined ON DELETE triggers <command>TRUNCATE</> will not run any user-defined <literal>ON
that might exist for the table. DELETE</literal> triggers that might exist for the table.
</para> </para>
</refsect1> </refsect1>

6
doc/src/sgml/ref/vacuum.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.34 2003/11/29 19:51:39 pgsql Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/vacuum.sgml,v 1.35 2004/03/23 13:21:41 neilc Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -64,14 +64,14 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ <replaceable class="PARAMETER">
</para> </para>
<para> <para>
<command>FREEZE</command> is a special-purpose option that <literal>FREEZE</literal> is a special-purpose option that
causes tuples to be marked <quote>frozen</quote> as soon as possible, causes tuples to be marked <quote>frozen</quote> as soon as possible,
rather than waiting until they are quite old. If this is done when there rather than waiting until they are quite old. If this is done when there
are no other open transactions in the same database, then it is guaranteed are no other open transactions in the same database, then it is guaranteed
that all tuples in the database are <quote>frozen</> and will not be that all tuples in the database are <quote>frozen</> and will not be
subject to transaction ID wraparound problems, no matter how long the subject to transaction ID wraparound problems, no matter how long the
database is left unvacuumed. database is left unvacuumed.
<command>FREEZE</command> is not recommended for routine use. Its only <literal>FREEZE</literal> is not recommended for routine use. Its only
intended usage is in connection with preparation of user-defined template intended usage is in connection with preparation of user-defined template
databases, or other databases that are completely read-only and will not databases, or other databases that are completely read-only and will not
receive routine maintenance <command>VACUUM</> operations. receive routine maintenance <command>VACUUM</> operations.