Commit 14c7a74b authored by Bruce Momjian's avatar Bruce Momjian

9.3 release notes: add markup for text

Still need to add links for new features.
parent c091c431
...@@ -73,15 +73,16 @@ ...@@ -73,15 +73,16 @@
<para> <para>
This improves concurrency and reduces the probability of deadlocks. This improves concurrency and reduces the probability of deadlocks.
UPDATEs on non-key columns use the new SELECT FOR NO KEY UPDATE lock <command>UPDATE</>s on non-key columns use the new <command>SELECT
type, and foreign key checks use the new SELECT FOR KEY SHARE lock mode. FOR NO KEY UPDATE</> lock type, and foreign key checks use the
new <command>SELECT FOR KEY SHARE</> lock mode.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add configuration variable lock_timeout to limit lock wait duration Add configuration variable <varname>lock_timeout</> to limit lock
(Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi) wait duration (Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi)
</para> </para>
</listitem> </listitem>
...@@ -91,8 +92,9 @@ ...@@ -91,8 +92,9 @@
</para> </para>
<para> <para>
This speeds lock release at statement completion in transactions This speeds lock release at statement completion in
that hold many locks; it is particularly useful for pg_dump. transactions that hold many locks; it is particularly useful
for <application>pg_dump</>.
</para> </para>
</listitem> </listitem>
...@@ -107,13 +109,13 @@ ...@@ -107,13 +109,13 @@
<listitem> <listitem>
<para> <para>
Add SP-GiST support for range data types (Alexander Korotkov) Add <type>SP-GiST</> support for range data types (Alexander Korotkov)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow unlogged GiST indexes (Jeevan Chalke) Allow unlogged <type>GiST</> indexes (Jeevan Chalke)
</para> </para>
</listitem> </listitem>
...@@ -162,26 +164,26 @@ ...@@ -162,26 +164,26 @@
<listitem> <listitem>
<para> <para>
Add COPY FREEZE option to avoid the overhead of later marking Add <command>COPY FREEZE</> option to avoid the overhead of later
tuples as committed (Simon Riggs, Jeff Davis) marking tuples as committed (Simon Riggs, Jeff Davis)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve performance of NUMERIC calculations (Kyotaro Horiguchi) Improve performance of <type>NUMERIC</> calculations (Kyotaro Horiguchi)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve grouping of sessions waiting for commit_delay (Peter Improve grouping of sessions waiting for <varname>commit_delay</>
Geoghegan) (Peter Geoghegan)
</para> </para>
<para> <para>
This improves the usefulness and behavior of commit_delay. This improves the usefulness and behavior of
BACKWARD COMPATIBILITY <varname>commit_delay</>. BACKWARD COMPATIBILITY
</para> </para>
</listitem> </listitem>
...@@ -191,8 +193,8 @@ ...@@ -191,8 +193,8 @@
</para> </para>
<para> <para>
Users who have set work_mem based on the previous behavior should Users who have set <varname>work_mem</> based on the previous
revisit that setting. behavior should revisit that setting.
</para> </para>
</listitem> </listitem>
...@@ -205,9 +207,9 @@ ...@@ -205,9 +207,9 @@
<listitem> <listitem>
<para> <para>
Improve performance of the CREATE TEMPORARY TABLE ... ON COMMIT Improve performance of the <command>CREATE TEMPORARY TABLE
DELETE ROWS clause by only issuing delete if the temporary table ... ON COMMIT DELETE ROWS</> clause by only issuing delete if
was accessed (Heikki Linnakangas) the temporary table was accessed (Heikki Linnakangas)
</para> </para>
</listitem> </listitem>
...@@ -254,8 +256,8 @@ ...@@ -254,8 +256,8 @@
<listitem> <listitem>
<para> <para>
Allow pg_terminate_backend() to terminate other backends with Allow <function>pg_terminate_backend()</> to terminate other
the same role (Dan Farina) backends with the same role (Dan Farina)
</para> </para>
<para> <para>
...@@ -286,36 +288,38 @@ ...@@ -286,36 +288,38 @@
<listitem> <listitem>
<para> <para>
Improve LDAP error reporting and documentation (Peter Eisentraut) Improve <acronym>LDAP</> error reporting and documentation
(Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add support for LDAP authentication to be specified in URL format Add support for <acronym>LDAP</> authentication to be specified
(Peter Eisentraut) in <acronym>URL</> format (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Change the ssl_ciphers parameter to start with DEFAULT, rather Change the <varname>ssl_ciphers</> parameter to start with
than ALL, then remove insecure ciphers (Magnus Hagander) <literal>DEFAULT</>, rather than <literal>ALL</>, then remove
insecure ciphers (Magnus Hagander)
</para> </para>
<para> <para>
It is assumed DEFAULT is more appropriate cipher set. It is assumed <literal>DEFAULT</> is more appropriate cipher set.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Parse/load pg_ident.conf once, not during each connection (Amit Parse/load <filename>pg_ident.conf</> once, not during each
Kapila) connection (Amit Kapila)
</para> </para>
<para> <para>
This is similar to how pg_hba.conf is processed. This is similar to how <filename>pg_hba.conf</> is processed.
</para> </para>
</listitem> </listitem>
...@@ -334,9 +338,9 @@ ...@@ -334,9 +338,9 @@
</para> </para>
<para> <para>
Instead, on Unix-like systems, mmap() is used for shared memory. Instead, on Unix-like systems, <function>mmap()</> is used for
This eliminates the requirement of increasing System V shared shared memory. This eliminates the requirement of increasing
memory kernel parameters. System V shared memory kernel parameters.
</para> </para>
</listitem> </listitem>
...@@ -347,8 +351,10 @@ ...@@ -347,8 +351,10 @@
</para> </para>
<para> <para>
This renames configuration parameter unix_socket_directory to This renames configuration parameter
unix_socket_directories, which accepts a list of directories. <varname>unix_socket_directory</> to
<varname>unix_socket_directories</>, which accepts a list of
directories.
</para> </para>
</listitem> </listitem>
...@@ -359,26 +365,27 @@ ...@@ -359,26 +365,27 @@
</para> </para>
<para> <para>
The directory is specified as include_dir in server configuration file. The directory is specified as <varname>include_dir</> in server
configuration file.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Increase the maximum initdb-configured value for shared_buffers Increase the maximum initdb-configured value for
to 128MB (Robert Haas) <varname>shared_buffers</> to 128MB (Robert Haas)
</para> </para>
<para> <para>
This is the maximum value initdb attempts to set in This is the maximum value initdb attempts to set in
postgresql.conf; the previous value was 32MB. <filename>postgresql.conf</>; the previous value was 32MB.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Require superuser privileges to set commit_delay because it Require superuser privileges to set <varname>commit_delay</>
can now potentially delay other sessions (Simon Riggs) because it can now potentially delay other sessions (Simon Riggs)
BACKWARD COMPATIBILITY BACKWARD COMPATIBILITY
</para> </para>
</listitem> </listitem>
...@@ -386,14 +393,16 @@ ...@@ -386,14 +393,16 @@
<listitem> <listitem>
<para> <para>
Remove the external PID file on postmaster exit (Peter Eisentraut) Remove the external <acronym>PID</> file on postmaster exit
(Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have "session id" in log_line_prefix (%c) always output four hex Have <quote>session id</> (<literal>%c</>) in
digits after the period (Bruce Momjian) COMPATIBILITY <varname>log_line_prefix</> always output four hex digits after
the period (Bruce Momjian) COMPATIBILITY
</para> </para>
</listitem> </listitem>
...@@ -410,19 +419,21 @@ ...@@ -410,19 +419,21 @@
<listitem> <listitem>
<para> <para>
Allow a streaming replication standbys to follow a timeline switch (Heikki Linnakangas) Allow a streaming replication standbys to follow a timeline switch
(Heikki Linnakangas)
</para> </para>
<para> <para>
This allows streaming standbys to feed from newly-promoted slaves. This allows streaming standbys to feed from newly-promoted slaves.
Previously slaves required access to a WAL archive directory to Previously slaves required access to a <acronym>WAL</> archive directory to
accomplish this. accomplish this.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add SQL functions pg_backup_in_progress() and pg_backup_start_time() (Gilles Darold) Add <acronym>SQL</> functions <function>pg_backup_in_progress()</>
and <function>pg_backup_start_time()</> (Gilles Darold)
</para> </para>
<para> <para>
...@@ -433,7 +444,7 @@ ...@@ -433,7 +444,7 @@
<listitem> <listitem>
<para> <para>
Improve performance of streaming log shipping with Improve performance of streaming log shipping with
synchronous_commit disabled (Andres Freund) <varname>synchronous_commit</> disabled (Andres Freund)
</para> </para>
</listitem> </listitem>
...@@ -446,27 +457,28 @@ ...@@ -446,27 +457,28 @@
<listitem> <listitem>
<para> <para>
Add the last checkpoint's redo location to pg_controldata's output Add the last checkpoint's redo location to
(Fujii Masao) <application>pg_controldata</>'s output (Fujii Masao)
</para> </para>
<para> <para>
This information is useful for determining the WAL files needed for This information is useful for determining the <acronym>WAL</>
restore. files needed for restore.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow tooling like pg_receivexlog to run on computers with different Allow tooling like <application>pg_receivexlog</> to run on computers with different
architectures (Heikki Linnakangas) architectures (Heikki Linnakangas)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have pg_basebackup --write-recovery-conf output a minimal Have <application>pg_basebackup</> <option>--write-recovery-conf</>
recovery.conf (Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi, Magnus Hagander) output a minimal <filename>recovery.conf</> (Zolt&aacute;n
B&ouml;sz&ouml;rm&eacute;nyi, Magnus Hagander)
</para> </para>
<para> <para>
...@@ -476,57 +488,59 @@ ...@@ -476,57 +488,59 @@
<listitem> <listitem>
<para> <para>
Allow pg_receivexlog and pg_basebackup -X to handle streaming Allow <application>pg_receivexlog</> and
timeline switches (Heikki Linnakangas) <application>pg_basebackup</> <option>--xlog-method</> to handle
streaming timeline switches (Heikki Linnakangas)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add wal_receiver_timeout parameter to control the WAL receiver Add <varname>wal_receiver_timeout</> parameter to control the <acronym>WAL</>
timeout (Amit Kapila) receiver timeout (Amit Kapila)
</para> </para>
<para> <para>
This allows more rapid detection of connection failure. No longer set This allows more rapid detection of connection failure. No longer set
wal_receiver_status_interval? <varname>wal_receiver_status_interval</>?
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Rename replication_timeout to wal_sender_timeout (Amit Kapila) Rename <varname>replication_timeout</> to <varname>wal_sender_timeout</> (Amit Kapila)
</para> </para>
<para> <para>
BACKWARD COMPATIBILITY BACKWARD COMPATIBILITY
This setting controls the WAL sender timeout. This setting controls the <acronym>WAL</> sender timeout.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<sect4> <sect4>
<title>Write-Ahead Log (WAL)</title> <title>Write-Ahead Log (<acronym>WAL</>)</title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
Store WAL in a continuous stream, rather than skipping the last Store <acronym>WAL</> in a continuous stream, rather than skipping
16MB segment every 4GB (Heikki Linnakangas) BACKWARD COMPATIBLE BREAK the last 16MB segment every 4GB (Heikki Linnakangas) BACKWARD
COMPATIBLE BREAK
</para> </para>
<para> <para>
Previously, WAL files ending in FF were not used. If you have Previously, <acronym>WAL</> files ending in <literal>FF</> were
WAL backup or restore scripts that took that skipping into account, not used. If you have <acronym>WAL</> backup or restore scripts
they need to be adjusted. that took that skipping into account, they need to be adjusted.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Change the WAL record format to allow splitting the record header Change the <acronym>WAL</> record format to allow splitting the record header
across pages (Heikki Linnakangas) across pages (Heikki Linnakangas)
</para> </para>
...@@ -548,21 +562,21 @@ ...@@ -548,21 +562,21 @@
<listitem> <listitem>
<para> <para>
Implement SQL-standard LATERAL for FROM-clause subqueries and Implement <acronym>SQL</>-standard <literal>LATERAL</> for
function calls (Tom Lane) <literal>FROM</>-clause subqueries and function calls (Tom Lane)
</para> </para>
<para> <para>
This is useful in allowing FROM subqueries and functions to reference This is useful in allowing <literal>FROM</> subqueries and
output from tables in the FROM clause. The LATERAL keyword is optional functions to reference output from tables in the <literal>FROM</>
for functions. clause. The <literal>LATERAL</> keyword is optional for functions.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add support for piping COPY and psql \copy to/from an external program (Etsuro Add support for piping <command>COPY</> and <application>psql</>
Fujita) <command>\copy</> to/from an external program (Etsuro Fujita)
</para> </para>
</listitem> </listitem>
...@@ -572,7 +586,7 @@ ...@@ -572,7 +586,7 @@
</para> </para>
<para> <para>
Only CREATE SCHEMA ... IF NOT EXISTS? If so, remove it. Only <command>CREATE SCHEMA ... IF NOT EXISTS</>? If so, remove it.
</para> </para>
</listitem> </listitem>
...@@ -598,13 +612,14 @@ ...@@ -598,13 +612,14 @@
<listitem> <listitem>
<para> <para>
Allow a multi-row VALUES clause in rules to reference OLD/NEW (Tom Lane) Allow a multi-row <literal>VALUES</> clause in rules to reference
<literal>OLD</>/<literal>NEW</> (Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add CREATE SCHEMA ... IF NOT EXISTS clause (Fabr&iacute;zio de Add <command>CREATE SCHEMA ... IF NOT EXISTS</> clause (Fabr&iacute;zio de
Royes Mello) Royes Mello)
</para> </para>
</listitem> </listitem>
...@@ -618,8 +633,8 @@ ...@@ -618,8 +633,8 @@
<listitem> <listitem>
<para> <para>
Have REASSIGN OWNED also change ownership of shared objects (&Aacute;lvaro Have <command>REASSIGN OWNED</> also change ownership of shared
Herrera) objects (&Aacute;lvaro Herrera)
</para> </para>
</listitem> </listitem>
...@@ -636,14 +651,14 @@ ...@@ -636,14 +651,14 @@
</para> </para>
<para> <para>
These messages now appear with DEBUG1-level output. These messages now appear with <literal>DEBUG1</>-level output.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow CREATE TABLE IF NOT EXISTS to succeed for a non-existent schema Allow <command>CREATE TABLE IF NOT EXISTS</> to succeed for a
(Bruce Momjian) non-existent schema (Bruce Momjian)
</para> </para>
<para> <para>
...@@ -662,14 +677,14 @@ ...@@ -662,14 +677,14 @@
<listitem> <listitem>
<para> <para>
Change ON UPDATE SET NULL/SET DEFAULT foreign key actions to affect Change <literal>ON UPDATE SET NULL/SET DEFAULT</> foreign key
all referenced columns, not just those referenced in the UPDATE actions to affect all referenced columns, not just those referenced
(Tom Lane) in the <command>UPDATE</> (Tom Lane)
</para> </para>
<para> <para>
Previously only columns referenced in the UPDATE were set to null or DEFAULT. Previously only columns referenced in the <command>UPDATE</> were
BACKWARD COMPATIBILITY CHANGE set to null or <literal>DEFAULT</>. BACKWARD COMPATIBILITY CHANGE
</para> </para>
</listitem> </listitem>
...@@ -689,13 +704,15 @@ ...@@ -689,13 +704,15 @@
<listitem> <listitem>
<para> <para>
Internally store default foreign key matches (non-FULL, non-PARTIAL) as "simple" (Tom Lane) Internally store default foreign key matches (non-<literal>FULL</>,
non-<literal>PARTIAL</>) as <quote>simple</> (Tom Lane)
</para> </para>
<para> <para>
These were previously stored as "&lt;unspecified&gt;". These were previously stored as "&lt;unspecified&gt;".
This changes the value stored in system column This changes the value stored in system column
pg_constraint.confmatchtype. BACKWARD COMPATIBILITY CHANGE <structname>pg_constraint.confmatchtype</>. BACKWARD COMPATIBILITY
CHANGE
</para> </para>
</listitem> </listitem>
...@@ -710,8 +727,8 @@ ...@@ -710,8 +727,8 @@
<listitem> <listitem>
<para> <para>
Add the ALTER TYPE ... IF NOT EXISTS clause when adding enumerated type labels (Andrew Add the <command>ALTER TYPE ... IF NOT EXISTS</> clause when
Dunstan) adding enumerated type labels (Andrew Dunstan)
</para> </para>
<para> <para>
...@@ -721,19 +738,21 @@ ...@@ -721,19 +738,21 @@
<listitem> <listitem>
<para> <para>
Add ALTER ROLE ALL SET to add settings to all users (Peter Eisentraut) Add <command>ALTER ROLE ALL SET</> to add settings to all users
(Peter Eisentraut)
</para> </para>
<para> <para>
This allows settings to apply to all users in all databases. ALTER This allows settings to apply to all users in all
DATABASE SET already allowed addition of settings for all users in a databases. <command>ALTER DATABASE SET</> already allowed
single database. postgresql.conf has a similar effect. addition of settings for all users in a single database.
<filename>postgresql.conf</> has a similar effect.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add support for ALTER RULE ... RENAME (Ali Dar) Add support for <command>ALTER RULE ... RENAME</> (Ali Dar)
</para> </para>
</listitem> </listitem>
...@@ -768,7 +787,7 @@ ...@@ -768,7 +787,7 @@
<para> <para>
Simple views that reference some or all columns from a single base table Simple views that reference some or all columns from a single base table
are now updatable by default. More complex views can be made updatable are now updatable by default. More complex views can be made updatable
using INSTEAD OF triggers or INSTEAD rules. using <literal>INSTEAD OF</> triggers or <literal>INSTEAD</> rules.
</para> </para>
</listitem> </listitem>
...@@ -782,11 +801,12 @@ ...@@ -782,11 +801,12 @@
<listitem> <listitem>
<para> <para>
Add CREATE RECURSIVE VIEW syntax (Peter Eisentraut) Add <command>CREATE RECURSIVE VIEW</> syntax (Peter Eisentraut)
</para> </para>
<para> <para>
Internally this is translated into CREATE VIEW ... WITH RECURSIVE. Internally this is translated into <command>CREATE VIEW ... WITH
RECURSIVE</>.
</para> </para>
</listitem> </listitem>
...@@ -821,34 +841,36 @@ ...@@ -821,34 +841,36 @@
<listitem> <listitem>
<para> <para>
Allow text timezone designations, e.g. "America/Chicago" when using the Allow text timezone designations, e.g. <quote>America/Chicago</>
ISO "T" timestamptz format (Bruce Momjian) when using the <acronym>ISO</> <quote>T</> timestamptz format (Bruce
Momjian)
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<sect4> <sect4>
<title>JSON</title> <title><type>JSON</></title>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
Add operators and functions to extract values from JSON data strings Add operators and functions to extract values from <type>JSON</> data strings
(Andrew Dunstan) (Andrew Dunstan)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow JSON data strings to be converted into records (Andrew Dunstan) Allow <type>JSON</> data strings to be converted into records (Andrew Dunstan)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add functions to convert values, records, and hstore data to JSON (Andrew Dunstan) Add functions to convert values, records, and hstore data to
<type>JSON</> (Andrew Dunstan)
</para> </para>
</listitem> </listitem>
...@@ -866,69 +888,75 @@ ...@@ -866,69 +888,75 @@
<listitem> <listitem>
<para> <para>
Add array_remove() and array_replace() functions (Marco Nenciarini, Gabriele Bartolini) Add <function>array_remove()</> and <function>array_replace()</>
functions (Marco Nenciarini, Gabriele Bartolini)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow concat() and format() to properly expand VARIADIC-labeled Allow <function>concat()</> and <function>format()</> to properly
arguments (Pavel Stehule) expand <literal>VARIADIC</>-labeled arguments (Pavel Stehule)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve format() to handle field width and left/right alignment Improve <function>format()</> to handle field width and left/right
(Pavel Stehule) alignment (Pavel Stehule)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have to_char(), to_date(), and to_timestamp() properly handle Have <function>to_char()</>, <function>to_date()</>, and
negative century designations (CC) (Bruce Momjian) <function>to_timestamp()</> properly handle negative century
designations (<literal>CC</>) (Bruce Momjian)
</para> </para>
<para> <para>
Previously the behavior was either wrong or inconsistent with Previously the behavior was either wrong or inconsistent
positive/AD handling, e.g. format mask 'IYYY-IW-DY'. with positive/<acronym>AD</> handling, e.g. format mask
<quote>IYYY-IW-DY</>.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have to_date() and to_timestamp() return proper results when mixing Have <function>to_date()</> and <function>to_timestamp()</>
ISO and Gregorian week/day designations (Bruce Momjian) return proper results when mixing <acronym>ISO</> and Gregorian
week/day designations (Bruce Momjian)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Cause pg_get_viewdef() to default to wrapping after every SELECT Cause <function>pg_get_viewdef()</> to default to wrapping after
target list and FROM entry (Marko Tiikkaja) every <command>SELECT</> target list and <literal>FROM</> entry
(Marko Tiikkaja)
</para> </para>
<para> <para>
This causes view output, like from pg_dump, to be more narrow. This causes view output, like from <application>pg_dump</>,
to be more narrow.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have map_sql_value_to_xml_value() properly expand domains (Pavel Have <function>map_sql_value_to_xml_value()</> properly expand
Stehule) domains (Pavel Stehule)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Force cached functions to be replanned if the search_path changes (Tom Lane) Force cached functions to be replanned if the <varname>search_path</> changes (Tom Lane)
</para> </para>
<para> <para>
Previously functions already run in the current session ignored Previously functions already run in the current session ignored
search_path changes. <varname>search_path</> changes.
(Bruce Momjian) (Bruce Momjian)
</para> </para>
</listitem> </listitem>
...@@ -944,8 +972,8 @@ ...@@ -944,8 +972,8 @@
<listitem> <listitem>
<para> <para>
Allow SPI functions to access the number of rows processed by COPY (Pavel Allow <acronym>SPI</> functions to access the number of rows
Stehule) processed by <command>COPY</> (Pavel Stehule)
</para> </para>
</listitem> </listitem>
...@@ -958,23 +986,23 @@ ...@@ -958,23 +986,23 @@
<listitem> <listitem>
<para> <para>
Allow PL/pgSQL to use RETURN with a composite-type expressions (Asif Allow PL/pgSQL to use <literal>RETURN</> with a composite-type
Rehman) expressions (Asif Rehman)
</para> </para>
<para> <para>
Previously RETURN could only reference composite-type variables. Previously <literal>RETURN</> could only reference composite-type variables.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow PL/pgSQL to access the number of rows processed by COPY (Pavel Allow PL/pgSQL to access the number of rows processed by
Stehule) <command>COPY</> (Pavel Stehule)
</para> </para>
<para> <para>
The command is GET DIAGNOSTICS x = ROW_COUNT. The command is <command>GET DIAGNOSTICS x = ROW_COUNT</>.
</para> </para>
</listitem> </listitem>
...@@ -1011,8 +1039,9 @@ ...@@ -1011,8 +1039,9 @@
<listitem> <listitem>
<para> <para>
Handle SPIErrors raised explicitly with PL/Python's RAISE the same as Handle <acronym>SPI</> errors raised explicitly with PL/Python's
as internal SPI errors (Oskari Saarenmaa and Jan Urbanski) <literal>RAISE</> the same as as internal <acronym>SPI</> errors
(Oskari Saarenmaa and Jan Urbanski)
</para> </para>
</listitem> </listitem>
...@@ -1029,33 +1058,38 @@ ...@@ -1029,33 +1058,38 @@
<listitem> <listitem>
<para> <para>
Add command-line utility pg_isready to check if the server is ready Add command-line utility <application>pg_isready</> to check if
to accept connections (Phil Sorber) the server is ready to accept connections (Phil Sorber)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Support multiple --table arguments for pg_restore, clusterdb, Support multiple <option>--table</> arguments for
reindexdb, and vacuumdb (Josh Kupershmidt) <application>pg_restore</>, <application>clusterdb</>,
<application>reindexdb</>, and <application>vacuumdb</> (Josh
Kupershmidt)
</para> </para>
<para> <para>
This is similar to the pg_dump --table support. This is similar to the <application>pg_dump</> <option>--table</>
support.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add -d option to pg_dumpall, pg_basebackup, pg_receivexlog to Add <option>--dbname</> option to <application>pg_dumpall</>,
specify the connection string (Amit Kapila) <application>pg_basebackup</>, <application>pg_receivexlog</>
to specify the connection string (Amit Kapila)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add libpq function PQconninfo() to return connection information Add libpq function <function>PQconninfo()</> to return connection
(Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi, Magnus Hagander) information (Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi, Magnus
Hagander)
</para> </para>
</listitem> </listitem>
...@@ -1068,21 +1102,21 @@ ...@@ -1068,21 +1102,21 @@
<listitem> <listitem>
<para> <para>
Adjust function cost settings so psql tab completion and pattern Adjust function cost settings so <application>psql</> tab
searching is more efficient (Tom Lane) completion and pattern searching is more efficient (Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve psql tab completion (Jeff Janes, Peter Eisentraut) Improve <application>psql</> tab completion (Jeff Janes, Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow the psql --single-transaction mode to work when reading from Allow the <application>psql</> <option>--single-transaction</> mode to work when
standard input (Fabien Coelho, Robert Haas) reading from standard input (Fabien Coelho, Robert Haas)
</para> </para>
<para> <para>
...@@ -1092,7 +1126,8 @@ ...@@ -1092,7 +1126,8 @@
<listitem> <listitem>
<para> <para>
Remove psql warning when connecting to an older server (Peter Eisentraut) Remove <application>psql</> warning when connecting to an older
server (Peter Eisentraut)
</para> </para>
<para> <para>
...@@ -1109,40 +1144,43 @@ ...@@ -1109,40 +1144,43 @@
<listitem> <listitem>
<para> <para>
Add psql \watch command to repeatedly execute commands (Will Add <application>psql</> <command>\watch</> command to repeatedly
Leinweber) execute commands (Will Leinweber)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add psql command \gset to store query results in psql variables Add <application>psql</> command <command>\gset</> to store query
(Pavel Stehule) results in <application>psql</> variables (Pavel Stehule)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add SSL information to psql's \conninfo command (Alastair Turner) Add <acronym>SSL</> information to <application>psql</>'s
<command>\conninfo</> command (Alastair Turner)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add "Security" label to psql \df+ output (Jon Erdman) Add "Security" label to <application>psql</> <command>\df+</>
output (Jon Erdman)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow psql \l to accept a database name pattern (Peter Eisentraut) Allow <application>psql</> <command>\l</> to accept a database
name pattern (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
In psql, do not allow \connect to use defaults if there is no active In <application>psql</>, do not allow <command>\connect</> to
connection (Bruce Momjian) use defaults if there is no active connection (Bruce Momjian)
</para> </para>
<para> <para>
...@@ -1152,7 +1190,8 @@ ...@@ -1152,7 +1190,8 @@
<listitem> <listitem>
<para> <para>
Properly reset state if psql's "\g file" command failed (Tom Lane) Properly reset state if <application>psql</>'s <quote>\g file</>
command failed (Tom Lane)
</para> </para>
<para> <para>
...@@ -1171,7 +1210,8 @@ ...@@ -1171,7 +1210,8 @@
<listitem> <listitem>
<para> <para>
Add a 'latex-longtable' output format to psql (Bruce Momjian) Add a <literal>latex-longtable</> output format to
<application>psql</> (Bruce Momjian)
</para> </para>
<para> <para>
...@@ -1181,21 +1221,22 @@ ...@@ -1181,21 +1221,22 @@
<listitem> <listitem>
<para> <para>
Add a border=3 output mode to the psql 'latex' format (Bruce Momjian) Add a <literal>border=3</> output mode to the <application>psql</>
<literal>latex</> format (Bruce Momjian)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
In psql tuples-only and expanded modes, no longer output "(No rows)" In <application>psql</> tuples-only and expanded modes, no longer
(Peter Eisentraut) output <quote>(No rows)</> (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
In psql, no longer print an empty line for unaligned, expanded In <application>psql</>, no longer print an empty line for
output for zero rows (Peter Eisentraut) unaligned, expanded output for zero rows (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
...@@ -1212,28 +1253,30 @@ ...@@ -1212,28 +1253,30 @@
<listitem> <listitem>
<para> <para>
Add pg_dump --jobs to dump in parallel when using directory Add <application>pg_dump</> <option>--jobs</> to dump in parallel
output format (Joachim Wieland) when using directory output format (Joachim Wieland)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have pg_dump output functions in a predictable order (Joel Jacobson) Have <application>pg_dump</> output functions in a predictable
order (Joel Jacobson)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Fix tar files emitted by pg_dump and pg_basebackup to be POSIX Fix tar files emitted by <application>pg_dump</> and
conformant (Brian Weaver, Tom Lane) <application>pg_basebackup</> to be <acronym>POSIX</> conformant
(Brian Weaver, Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add -d/--dbname option to pg_dump, for consistency with other client Add <option>--dbname</> option to <application>pg_dump</>, for
commands (Heikki Linnakangas) consistency with other client commands (Heikki Linnakangas)
</para> </para>
<para> <para>
...@@ -1256,18 +1299,18 @@ ...@@ -1256,18 +1299,18 @@
</para> </para>
<para> <para>
This can be disabled by using --nosync. This can be disabled by using <option>--nosync</>.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add initdb --sync-only option to sync the data directory to durable Add initdb <option>--sync-only</> option to sync the data directory to durable
storage (Bruce Momjian) storage (Bruce Momjian)
</para> </para>
<para> <para>
This is used by pg_upgrade. This is used by <application>pg_upgrade</>.
</para> </para>
</listitem> </listitem>
...@@ -1304,14 +1347,15 @@ ...@@ -1304,14 +1347,15 @@
<listitem> <listitem>
<para> <para>
Create a centralized timeout API (Zolt&aacute;n B&ouml;sz&ouml;rm&eacute;nyi) Create a centralized timeout <acronym>API</> (Zolt&aacute;n
B&ouml;sz&ouml;rm&eacute;nyi)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Create libpgcommon and move pg_malloc() and other functions there Create libpgcommon and move <function>pg_malloc()</> and other
(&Aacute;lvaro Herrera, Andres Freund) functions there (&Aacute;lvaro Herrera, Andres Freund)
</para> </para>
<para> <para>
...@@ -1327,22 +1371,22 @@ ...@@ -1327,22 +1371,22 @@
<listitem> <listitem>
<para> <para>
Add compiler designations to indicate some ereport() and elog() Add compiler designations to indicate some <function>ereport()</>
calls do not return (Peter Eisentraut, Andres Freund, Tom Lane, and <function>elog()</> calls do not return (Peter Eisentraut,
Heikki Linnakangas) Andres Freund, Tom Lane, Heikki Linnakangas)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Allow options to be passed to the regression test output comparison Allow options to be passed to the regression test output comparison
utility via PG_REGRESS_DIFF_OPTS (Peter Eisentraut) utility via <envar>PG_REGRESS_DIFF_OPTS</> (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add isolation tests for CREATE INDEX CONCURRENTLY (Abhijit Menon-Sen) Add isolation tests for <command>CREATE INDEX CONCURRENTLY</> (Abhijit Menon-Sen)
</para> </para>
</listitem> </listitem>
...@@ -1354,13 +1398,14 @@ ...@@ -1354,13 +1398,14 @@
<listitem> <listitem>
<para> <para>
Fix install-strip on Mac OS X (Peter Eisentraut) Fix install-strip on Mac <productname>OS X</> (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Remove configure flag --disable-shared, as it is no longer used (Bruce Momjian) Remove configure flag <option>--disable-shared</>, as it is no
longer used (Bruce Momjian)
</para> </para>
</listitem> </listitem>
...@@ -1372,8 +1417,8 @@ ...@@ -1372,8 +1417,8 @@
<listitem> <listitem>
<para> <para>
Add emacs macro to match Postgres perltidy formatting (Peter Add emacs macro to match <productname>PostgreSQL</> perltidy
Eisentraut) formatting (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
...@@ -1395,13 +1440,14 @@ ...@@ -1395,13 +1440,14 @@
<listitem> <listitem>
<para> <para>
Add Assert() functionality to client-side code for frontend code (Andrew Dunstan) Add <function>Assert()</> functionality to client-side code for
frontend code (Andrew Dunstan)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Change many internal many backend functions to return OIDs rather Change many internal many backend functions to return <type>OID</>s rather
than void (Dimitri Fontaine) than void (Dimitri Fontaine)
</para> </para>
...@@ -1424,14 +1470,14 @@ ...@@ -1424,14 +1470,14 @@
<listitem> <listitem>
<para> <para>
Add function pg_identify_object() to dump an object in Add function <function>pg_identify_object()</> to dump an object
machine-readable format (&Aacute;lvaro Herrera) in machine-readable format (&Aacute;lvaro Herrera)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add post-ALTER-object server hooks (KaiGai Kohei) Add post-<command>ALTER</>-object server hooks (KaiGai Kohei)
</para> </para>
</listitem> </listitem>
...@@ -1457,27 +1503,28 @@ ...@@ -1457,27 +1503,28 @@
<listitem> <listitem>
<para> <para>
Remove src/tool/backend, now that the content is on the Postgres Remove <filename>src/tool/backend</>, now that the content is on
wiki (Bruce Momjian) the <productname>PostgreSQL</> wiki (Bruce Momjian)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Split out WAL reading as an independent facility (Heikki Split out <acronym>WAL</> reading as an independent facility
Linnakangas, Andres Freund) (Heikki Linnakangas, Andres Freund)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Use a 64-bit integer to represent WAL positions (XLogRecPtr) Use a 64-bit integer to represent <acronym>WAL</> positions
instead of two 32-bit integers (Heikki Linnakangas) (<structname>XLogRecPtr</>) instead of two 32-bit integers (Heikki
Linnakangas)
</para> </para>
<para> <para>
Generally, tools that need to read the WAL format will need to Generally, tools that need to read the <acronym>WAL</> format
be adjusted. will need to be adjusted.
</para> </para>
</listitem> </listitem>
...@@ -1489,8 +1536,8 @@ ...@@ -1489,8 +1536,8 @@
<listitem> <listitem>
<para> <para>
Allow PL/Python on OS X to build against custom versions of Python Allow PL/Python on <productname>OS X</> to build against custom
(Peter Eisentraut) versions of Python (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
...@@ -1512,8 +1559,8 @@ ...@@ -1512,8 +1559,8 @@
<listitem> <listitem>
<para> <para>
Add a Postgres foreign data wrapper contrib module (Shigeru Add a <productname>Postgres</> foreign data wrapper contrib module
Hanada) (Shigeru Hanada)
</para> </para>
<para> <para>
...@@ -1523,49 +1570,49 @@ ...@@ -1523,49 +1570,49 @@
<listitem> <listitem>
<para> <para>
Add pg_xlogdump contrib program (Andres Freund) Add <application>pg_xlogdump</> contrib program (Andres Freund)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add support for indexing of regular-expression searches in Add support for indexing of regular-expression searches in
contrib/pg_trgm (Alexander Korotkov) extension <productname>pg_trgm</> (Alexander Korotkov)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve pg_trgm handling of multibyte characters (Tom Lane) Improve <productname>pg_trgm</> handling of multibyte characters (Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add function to report the size of the GIN pending index insertion Add function to report the size of the <type>GIN</> pending index
list (Fujii Masao) insertion list (Fujii Masao)
</para> </para>
<para> <para>
The function is pgstatginindex() in pgstattuple. The function is <function>pgstatginindex()</> in pgstattuple.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Have oid2name, pgbench, and vacuumlo set fallback_application_name (Amit Kapila) Have oid2name, pgbench, and vacuumlo set <varname>fallback_application_name</> (Amit Kapila)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve output of pg_test_timing (Bruce Momjian) Improve output of <application>pg_test_timing</> (Bruce Momjian)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve output of pg_test_fsync (Peter Geoghegan) Improve output of <application>pg_test_fsync</> (Peter Geoghegan)
</para> </para>
</listitem> </listitem>
...@@ -1588,7 +1635,8 @@ ...@@ -1588,7 +1635,8 @@
<listitem> <listitem>
<para> <para>
Allow pg_upgrade --jobs to do parallelism (Bruce Momjian) Allow <application>pg_upgrade</> <option>--jobs</> to do
parallelism (Bruce Momjian)
</para> </para>
<para> <para>
...@@ -1599,8 +1647,8 @@ ...@@ -1599,8 +1647,8 @@
<listitem> <listitem>
<para> <para>
Have pg_upgrade create unix-domain sockets in the current directory Have <application>pg_upgrade</> create unix-domain sockets in
(Bruce Momjian, Tom Lane) the current directory (Bruce Momjian, Tom Lane)
</para> </para>
<para> <para>
...@@ -1611,27 +1659,29 @@ ...@@ -1611,27 +1659,29 @@
<listitem> <listitem>
<para> <para>
Have pg_upgrade --check mode properly detect the location of Have <application>pg_upgrade</> <option>--check</> mode properly
non-default socket directories (Bruce Momjian, Tom Lane) detect the location of non-default socket directories (Bruce
Momjian, Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve performance of pg_upgrade for databases with many tables (Bruce Momjian) Improve performance of <application>pg_upgrade</> for databases
with many tables (Bruce Momjian)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Increase pg_upgrade logging content by showing executed command Increase <application>pg_upgrade</> logging content by showing executed command
(&Aacute;lvaro Herrera) (&Aacute;lvaro Herrera)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve pg_upgrade's status display during copy/link (Bruce Momjian) Improve <application>pg_upgrade</>'s status display during copy/link (Bruce Momjian)
</para> </para>
</listitem> </listitem>
...@@ -1646,7 +1696,7 @@ ...@@ -1646,7 +1696,7 @@
<listitem> <listitem>
<para> <para>
Add --foreign-keys option to pgbench (Jeff Janes) Add <option>--foreign-keys</> option to pgbench (Jeff Janes)
</para> </para>
<para> <para>
...@@ -1658,14 +1708,14 @@ ...@@ -1658,14 +1708,14 @@
<listitem> <listitem>
<para> <para>
Allow pgbench to aggregate performance statistics and produce output Allow pgbench to aggregate performance statistics and produce output
every --aggregate-interval specified seconds (Tomas Vondra) every <option>--aggregate-interval</> specified seconds (Tomas Vondra)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add pg_bench --sampling-rate option to control the percentage of Add <application>pg_bench</> <option>--sampling-rate</> option to control the
transactions logged (Tomas Vondra) percentage of transactions logged (Tomas Vondra)
</para> </para>
</listitem> </listitem>
...@@ -1678,7 +1728,8 @@ ...@@ -1678,7 +1728,8 @@
<listitem> <listitem>
<para> <para>
Add pgbench -q mode to print one output line every five seconds (Tomas Vondra) Add pgbench <option>-q</> mode to print one output line every
five seconds (Tomas Vondra)
</para> </para>
<para> <para>
...@@ -1706,32 +1757,33 @@ ...@@ -1706,32 +1757,33 @@
<listitem> <listitem>
<para> <para>
Allow EPUB-format documentation to be created (Peter Eisentraut) Allow <productname>EPUB</>-format documentation to be created
(Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Update FreeBSD kernel configuration documentation (Brad Davis) Update <productname>FreeBSD</> kernel configuration documentation (Brad Davis)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve WINDOW function documentation (Bruce Momjian, Tom Lane) Improve <literal>WINDOW</> function documentation (Bruce Momjian, Tom Lane)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Add instructions for setting up the documentation tool chain on Add instructions for setting up the documentation tool chain on
Mac OS X (Peter Eisentraut) Mac <productname>OS X</> (Peter Eisentraut)
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Improve commit_delay documentation (Peter Geoghegan) Improve <varname>commit_delay</> documentation (Peter Geoghegan)
</para> </para>
</listitem> </listitem>
......
...@@ -7,14 +7,14 @@ Typical markup: ...@@ -7,14 +7,14 @@ Typical markup:
PostgreSQL <productname> PostgreSQL <productname>
postgresql.conf, pg_hba.conf, postgresql.conf, pg_hba.conf,
recovery.conf <filename> recovery.conf <filename>
[A-Z][A-Z_ ]+[A-Z_] <command>, <literal>, <envar> [A-Z][A-Z_ ]+[A-Z_] <command>, <literal>, <envar>, <acronym>
[A-Za-z_][A-Za-z0-9_]+() <function> [A-Za-z_][A-Za-z0-9_]+() <function>
-[-A-Za-z_]+ <option> -[-A-Za-z_]+ <option>
[A-Za-z_]/[A-Za-z_]+ <filename> [A-Za-z_]/[A-Za-z_]+ <filename>
psql <application> psql <application>
pg_[A-Za-z0-9_]+ <application>, <structname> pg_[A-Za-z0-9_]+ <application>, <structname>
[A-Z][A-Z][A-Z_ ]* <type> [A-Z][A-Z][A-Z_ ]* <type>
[a-z]+_[a-z_]+ <varname> [a-z]+_[a-z_]+ <varname>
non-ASCII characters find using grep -P '[\x80-\xFF]' non-ASCII characters find using grep -P '[\x80-\xFF]'
convert to HTML4 named entity (&) escapes convert to HTML4 named entity (&) escapes
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment