aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorBruce Momjian <bruce@momjian.us>2005-07-02 18:29:04 +0000
committerBruce Momjian <bruce@momjian.us>2005-07-02 18:29:04 +0000
commit6aa0fdc4aa997adec21b7423e4e08a7ec2bab0ea (patch)
tree95600736244b9c3bbaafeedf537033e2cc67214d /doc/src
parent74b49a81294b2943179078272bc3413b33d16e6f (diff)
downloadpostgresql-6aa0fdc4aa997adec21b7423e4e08a7ec2bab0ea.tar.gz
postgresql-6aa0fdc4aa997adec21b7423e4e08a7ec2bab0ea.zip
Use on/off consistently for GUC variables in postgresql.conf and the
documentation, to match SHOW.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/runtime.sgml32
1 files changed, 16 insertions, 16 deletions
diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 42398529866..6b52942786a 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
<!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.333 2005/07/01 13:29:23 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.334 2005/07/02 18:29:03 momjian Exp $
-->
<chapter Id="runtime">
@@ -2461,7 +2461,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
rather than append to, any existing log file of the same name.
However, truncation will occur only when a new file is being opened
due to time-based rotation, not during server startup or size-based
- rotation. When false, pre-existing files will be appended to in
+ rotation. When off, pre-existing files will be appended to in
all cases. For example, using this option in combination with
a <varname>log_filename</varname> like <literal>postgresql-%H.log</literal>
would result in generating twenty-four hourly log files and then
@@ -2474,14 +2474,14 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
<literal>server_log.Mon</literal>, <literal>server_log.Tue</literal>,
etc, and automatically overwrite last week's log with this week's log,
set <varname>log_filename</varname> to <literal>server_log.%a</literal>,
- <varname>log_truncate_on_rotation</varname> to <literal>true</literal>, and
+ <varname>log_truncate_on_rotation</varname> to <literal>on</literal>, and
<varname>log_rotation_age</varname> to <literal>1440</literal>.
</para>
<para>
Example: To keep 24 hours of logs, one log file per hour, but
also rotate sooner if the log file size exceeds 1GB, set
<varname>log_filename</varname> to <literal>server_log.%H%M</literal>,
- <varname>log_truncate_on_rotation</varname> to <literal>true</literal>,
+ <varname>log_truncate_on_rotation</varname> to <literal>on</literal>,
<varname>log_rotation_age</varname> to <literal>60</literal>, and
<varname>log_rotation_size</varname> to <literal>1000000</literal>.
Including <literal>%M</> in <varname>log_filename</varname> allows
@@ -3258,7 +3258,7 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
</indexterm>
<listitem>
<para>
- This parameter is normally true. When set to false, it disables
+ This parameter is normally on. When set to off, it disables
validation of the function body string during <xref
linkend="sql-createfunction"
endterm="sql-createfunction-title">. Disabling validation is
@@ -3307,7 +3307,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 false (read/write).
+ transaction. The default is off (read/write).
</para>
<para>
@@ -3385,11 +3385,11 @@ archive_command = 'copy "%p" /mnt/server/archivedir/"%f"' # Windows
<indexterm><primary>time zone</><secondary>Australian</></>
<listitem>
<para>
- If set to true, <literal>ACST</literal>,
+ If set to on, <literal>ACST</literal>,
<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 false.
+ Saturday. The default is off.
</para>
</listitem>
</varlistentry>
@@ -3670,12 +3670,12 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
</indexterm>
<listitem>
<para>
- When <literal>true</>, tables that are referenced by a query
+ 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>false</>. This
+ 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.
@@ -3744,7 +3744,7 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
determines whether OIDs will be included in tables created by
<command>SELECT INTO</command>. In <productname>PostgreSQL</>
8.1 <varname>default_with_oids</> is disabled by default; in
- prior versions of PostgreSQL, it was true by default.
+ prior versions of PostgreSQL, it was on by default.
</para>
<para>
@@ -3997,9 +3997,9 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir'
<para>
Reports whether ordinary string literals
(<literal>'...'</>) treat backslashes literally, as specified in
- the SQL standard. The value is currently always <literal>false</>,
+ the SQL standard. The value is currently always <literal>off</>,
indicating that backslashes are treated as escapes. It is planned
- that this will change to <literal>true</> in a future
+ that this will change to <literal>on</> in a future
<productname>PostgreSQL</productname> release when string literal
syntax changes to meet the standard. Applications may check this
parameter to determine how string literals will be processed.
@@ -4164,7 +4164,7 @@ plruby.bar = true # generates error, unknown class name
</indexterm>
<listitem>
<para>
- If true, emit WAL-related debugging output. This option is
+ If on, emit WAL-related debugging output. This option is
only available if the <symbol>WAL_DEBUG</symbol> macro was
defined when <productname>PostgreSQL</productname> was
compiled.
@@ -4181,14 +4181,14 @@ plruby.bar = true # generates error, unknown class name
<para>
Detection of a damaged page header normally causes
<productname>PostgreSQL</> to report an error, aborting the current
- command. Setting <varname>zero_damaged_pages</> to true causes
+ command. Setting <varname>zero_damaged_pages</> to on causes
the system to instead report a warning, zero out the damaged page,
and continue processing. This behavior <emphasis>will destroy data</>,
namely all the rows on the damaged page. But it allows you to get
past the error and retrieve rows from any undamaged pages that may
be present in the table. So it is useful for recovering data if
corruption has occurred due to hardware or software error. You should
- generally not set this true until you have given up hope of recovering
+ 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.
</para>