diff options
author | Peter Eisentraut | 2017-10-09 01:44:17 +0000 |
---|---|---|
committer | Peter Eisentraut | 2017-10-17 19:10:33 +0000 |
commit | c29c578908dc0271eeb13a4014e54bff07a29c05 (patch) | |
tree | 1aa03fb6f1864719f2f23d4b0b9d5e2865764082 /doc/src/sgml/ref/vacuum.sgml | |
parent | 6ecabead4b5993c42745f2802d857b1a79f48bf9 (diff) |
Don't use SGML empty tags
For DocBook XML compatibility, don't use SGML empty tags (</>) anymore,
replace by the full tag name. Add a warning option to catch future
occurrences.
Alexander Lakhin, Jürgen Purtz
Diffstat (limited to 'doc/src/sgml/ref/vacuum.sgml')
-rw-r--r-- | doc/src/sgml/ref/vacuum.sgml | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml index f5bc87e2903..2e205668c1c 100644 --- a/doc/src/sgml/ref/vacuum.sgml +++ b/doc/src/sgml/ref/vacuum.sgml @@ -66,7 +66,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet </para> <para> - Plain <command>VACUUM</command> (without <literal>FULL</>) simply reclaims + Plain <command>VACUUM</command> (without <literal>FULL</literal>) simply reclaims space and makes it available for re-use. This form of the command can operate in parallel with normal reading and writing of the table, as an exclusive lock @@ -116,7 +116,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet <xref linkend="guc-vacuum-freeze-min-age"> and <xref linkend="guc-vacuum-freeze-table-age"> parameters set to zero. Aggressive freezing is always performed when the - table is rewritten, so this option is redundant when <literal>FULL</> + table is rewritten, so this option is redundant when <literal>FULL</literal> is specified. </para> </listitem> @@ -145,8 +145,8 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet <term><literal>DISABLE_PAGE_SKIPPING</literal></term> <listitem> <para> - Normally, <command>VACUUM</> will skip pages based on the <link - linkend="vacuum-for-visibility-map">visibility map</>. Pages where + Normally, <command>VACUUM</command> will skip pages based on the <link + linkend="vacuum-for-visibility-map">visibility map</link>. Pages where all tuples are known to be frozen can always be skipped, and those where all tuples are known to be visible to all transactions may be skipped except when performing an aggressive vacuum. Furthermore, @@ -176,7 +176,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet <listitem> <para> The name of a specific column to analyze. Defaults to all columns. - If a column list is specified, <literal>ANALYZE</> must also be + If a column list is specified, <literal>ANALYZE</literal> must also be specified. </para> </listitem> @@ -188,7 +188,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet <title>Outputs</title> <para> - When <literal>VERBOSE</> is specified, <command>VACUUM</> emits + When <literal>VERBOSE</literal> is specified, <command>VACUUM</command> emits progress messages to indicate which table is currently being processed. Various statistics about the tables are printed as well. </para> @@ -202,19 +202,19 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet superuser. However, database owners are allowed to vacuum all tables in their databases, except shared catalogs. (The restriction for shared catalogs means that a true database-wide - <command>VACUUM</> can only be performed by a superuser.) - <command>VACUUM</> will skip over any tables that the calling user + <command>VACUUM</command> can only be performed by a superuser.) + <command>VACUUM</command> will skip over any tables that the calling user does not have permission to vacuum. </para> <para> - <command>VACUUM</> cannot be executed inside a transaction block. + <command>VACUUM</command> cannot be executed inside a transaction block. </para> <para> - For tables with <acronym>GIN</> indexes, <command>VACUUM</command> (in + For tables with <acronym>GIN</acronym> indexes, <command>VACUUM</command> (in any form) also completes any pending index insertions, by moving pending - index entries to the appropriate places in the main <acronym>GIN</> index + index entries to the appropriate places in the main <acronym>GIN</acronym> index structure. See <xref linkend="gin-fast-update"> for details. </para> @@ -247,7 +247,7 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ <replaceable class="paramet </para> <para> - <productname>PostgreSQL</productname> includes an <quote>autovacuum</> + <productname>PostgreSQL</productname> includes an <quote>autovacuum</quote> facility which can automate routine vacuum maintenance. For more information about automatic and manual vacuuming, see <xref linkend="routine-vacuuming">. |