mirror of https://github.com/postgres/postgres
Add SGML markup for on/off values in run-time section.
This commit is contained in:
parent
87e01d1eed
commit
9caeace71c
|
@ -1,5 +1,5 @@
|
|||
<!--
|
||||
$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.334 2005/07/02 18:29:03 momjian Exp $
|
||||
$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.335 2005/07/02 19:16:36 momjian Exp $
|
||||
-->
|
||||
|
||||
<chapter Id="runtime">
|
||||
|
@ -929,7 +929,8 @@ SET ENABLE_SEQSCAN TO OFF;
|
|||
<para>
|
||||
Enables <acronym>SSL</> connections. Please read
|
||||
<xref linkend="ssl-tcp"> before using this. The default
|
||||
is off. This parameter can only be set at server start.
|
||||
is <literal>off</>. This parameter can only be set at server
|
||||
start.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -946,8 +947,8 @@ SET ENABLE_SEQSCAN TO OFF;
|
|||
<xref linkend="sql-alteruser" endterm="sql-alteruser-title">
|
||||
without writing either <literal>ENCRYPTED</> or
|
||||
<literal>UNENCRYPTED</>, this option determines whether the
|
||||
password is to be encrypted. The default is on (encrypt the
|
||||
password).
|
||||
password is to be encrypted. The default is <literal>on</>
|
||||
(encrypt the password).
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -987,8 +988,8 @@ SET ENABLE_SEQSCAN TO OFF;
|
|||
<listitem>
|
||||
<para>
|
||||
Sets if Kerberos usernames should be treated case-insensitive.
|
||||
The default is off (case sensitive). This parameter can only be
|
||||
set at server start.
|
||||
The default is <literal>off</> (case sensitive). This parameter
|
||||
can only be set at server start.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1867,7 +1868,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of bitmap-scan plan
|
||||
types. The default is on.
|
||||
types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1880,7 +1881,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of hashed
|
||||
aggregation plan types. The default is on.
|
||||
aggregation plan types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1893,7 +1894,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of hash-join plan
|
||||
types. The default is on.
|
||||
types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1909,7 +1910,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of index-scan plan
|
||||
types. The default is on.
|
||||
types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1922,7 +1923,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of merge-join plan
|
||||
types. The default is on.
|
||||
types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1938,7 +1939,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
plans. It's not possible to suppress nested-loop joins entirely,
|
||||
but turning this variable off discourages the planner from using
|
||||
one if there are other methods available. The default is
|
||||
on.
|
||||
<literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1957,7 +1958,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
plan types. It's not possible to suppress sequential scans
|
||||
entirely, but turning this variable off discourages the planner
|
||||
from using one if there are other methods available. The
|
||||
default is on.
|
||||
default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1973,7 +1974,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
steps. It's not possible to suppress explicit sorts entirely,
|
||||
but turning this variable off discourages the planner from
|
||||
using one if there are other methods available. The default
|
||||
is on.
|
||||
is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -1986,7 +1987,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<listitem>
|
||||
<para>
|
||||
Enables or disables the query planner's use of <acronym>TID</>
|
||||
scan plan types. The default is on.
|
||||
scan plan types. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -2831,8 +2832,8 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
if you are not using <application>syslog</>, it is recommended
|
||||
that you log the PID or session ID using <varname>log_line_prefix</>
|
||||
so that you can link the statement to the
|
||||
duration using the process ID or session ID. The default is off.
|
||||
Only superusers can change this setting.
|
||||
duration using the process ID or session ID. The default is
|
||||
<literal>off</>. Only superusers can change this setting.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3137,8 +3138,8 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<para>
|
||||
If on, collected statistics are zeroed out whenever the server
|
||||
is restarted. If off, statistics are accumulated across server
|
||||
restarts. The default is on. This option can only be set at
|
||||
server start.
|
||||
restarts. The default is <literal>on</>. This option can only
|
||||
be set at server start.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3258,12 +3259,12 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
</indexterm>
|
||||
<listitem>
|
||||
<para>
|
||||
This parameter is normally on. When set to off, it disables
|
||||
validation of the function body string during <xref
|
||||
This parameter is normally on. When set to <literal>off</>, it
|
||||
disables validation of the function body string during <xref
|
||||
linkend="sql-createfunction"
|
||||
endterm="sql-createfunction-title">. Disabling validation is
|
||||
occasionally useful to avoid problems such as forward
|
||||
references when restoring function definitions from a dump.
|
||||
endterm="sql-createfunction-title">. Disabling validation is
|
||||
occasionally useful to avoid problems such as forward references
|
||||
when restoring function definitions from a dump.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3307,7 +3308,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<para>
|
||||
A read-only SQL transaction cannot alter non-temporary tables.
|
||||
This parameter controls the default read-only status of each new
|
||||
transaction. The default is off (read/write).
|
||||
transaction. The default is <literal>off</> (read/write).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
@ -3389,7 +3390,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<literal>CST</literal>, <literal>EST</literal>, and
|
||||
<literal>SAT</literal> are interpreted as Australian time
|
||||
zones rather than as North/South American time zones and
|
||||
Saturday. The default is off.
|
||||
Saturday. The default is <literal>off</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3530,7 +3531,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
|
|||
<para>
|
||||
Determines whether <command>EXPLAIN VERBOSE</> uses the
|
||||
indented or non-indented format for displaying detailed
|
||||
query-tree dumps. The default is on.
|
||||
query-tree dumps. The default is <literal>on</>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3670,15 +3671,15 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
|
|||
</indexterm>
|
||||
<listitem>
|
||||
<para>
|
||||
When <literal>on</>, tables that are referenced by a query
|
||||
will be automatically added to the <literal>FROM</> clause if
|
||||
not already present. This behavior does not comply with the
|
||||
SQL standard and many people dislike it because it can mask
|
||||
mistakes (such as referencing a table where you should have
|
||||
referenced its alias). The default is <literal>off</>. This
|
||||
variable can be enabled for compatibility with releases of
|
||||
<productname>PostgreSQL</> prior to 8.1, where this behavior
|
||||
was allowed by default.
|
||||
When on, tables that are referenced by a query will be
|
||||
automatically added to the <literal>FROM</> clause if not
|
||||
already present. This behavior does not comply with the SQL
|
||||
standard and many people dislike it because it can mask mistakes
|
||||
(such as referencing a table where you should have referenced
|
||||
its alias). The default is <literal>off</>. This variable can be
|
||||
enabled for compatibility with releases of
|
||||
<productname>PostgreSQL</> prior to 8.1, where this behavior was
|
||||
allowed by default.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
@ -3722,10 +3723,11 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
|
|||
This controls the inheritance semantics, in particular whether
|
||||
subtables are included by various commands by default. They were
|
||||
not included in versions prior to 7.1. If you need the old
|
||||
behavior you can set this variable to off, but in the long run
|
||||
you are encouraged to change your applications to use the
|
||||
<literal>ONLY</literal> key word to exclude subtables. See
|
||||
<xref linkend="ddl-inherit"> for more information about inheritance.
|
||||
behavior you can set this variable to <literal>off</>, but in
|
||||
the long run you are encouraged to change your applications to
|
||||
use the <literal>ONLY</literal> key word to exclude subtables.
|
||||
See <xref linkend="ddl-inherit"> for more information about
|
||||
inheritance.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
@ -3766,9 +3768,9 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
|
|||
</indexterm>
|
||||
<listitem>
|
||||
<para>
|
||||
When <literal>on</>, a warning is issued if a backslash
|
||||
(<literal>\</>) appears in an ordinary string literal
|
||||
(<literal>'...'</> syntax). The default is <literal>off</>.
|
||||
When on, a warning is issued if a backslash (<literal>\</>)
|
||||
appears in an ordinary string literal (<literal>'...'</>
|
||||
syntax). The default is <literal>off</>.
|
||||
</para>
|
||||
<para>
|
||||
Escape string syntax (<literal>E'...'</>) should be used for
|
||||
|
@ -3794,14 +3796,15 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
|
|||
</indexterm>
|
||||
<listitem>
|
||||
<para>
|
||||
When turned on, expressions of the form
|
||||
<literal><replaceable>expr</> = NULL</literal> (or <literal>NULL
|
||||
= <replaceable>expr</></literal>) are treated as
|
||||
When on, expressions of the form <literal><replaceable>expr</> =
|
||||
NULL</literal> (or <literal>NULL =
|
||||
<replaceable>expr</></literal>) are treated as
|
||||
<literal><replaceable>expr</> IS NULL</literal>, that is, they
|
||||
return true if <replaceable>expr</> evaluates to the null value,
|
||||
and false otherwise. The correct SQL-spec-compliant behavior of
|
||||
<literal><replaceable>expr</> = NULL</literal> is to always
|
||||
return null (unknown). Therefore this option defaults to off.
|
||||
return null (unknown). Therefore this option defaults to
|
||||
<literal>off</>.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
@ -4102,8 +4105,8 @@ plruby.bar = true # generates error, unknown class name
|
|||
must be defined when <productname>PostgreSQL</productname> is
|
||||
built (accomplished by the <command>configure</command> option
|
||||
<option>--enable-cassert</option>). Note that
|
||||
<varname>debug_assertions</varname> defaults to on if
|
||||
<productname>PostgreSQL</productname> has been built with
|
||||
<varname>debug_assertions</varname> defaults to <literal>on</>
|
||||
if <productname>PostgreSQL</productname> has been built with
|
||||
assertions enabled.
|
||||
</para>
|
||||
</listitem>
|
||||
|
@ -4190,7 +4193,8 @@ plruby.bar = true # generates error, unknown class name
|
|||
corruption has occurred due to hardware or software error. You should
|
||||
generally not set this on until you have given up hope of recovering
|
||||
data from the damaged page(s) of a table. The
|
||||
default setting is off, and it can only be changed by a superuser.
|
||||
default setting is <literal>off</>, and it can only be changed
|
||||
by a superuser.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
|
Loading…
Reference in New Issue