From 4073c307ce676d1d0196848ec791bb8c5aa1414c Mon Sep 17 00:00:00 2001 From: Douglas Domingues <53982450+DominguesDouglas@users.noreply.github.com> Date: Fri, 5 Jun 2026 15:58:15 -0300 Subject: [PATCH] N.N.N to section name --- doc/src/sgml/advanced.sgml | 6 +- doc/src/sgml/amcheck.sgml | 2 +- .../sgml/appendix-obsolete-default-roles.sgml | 4 +- doc/src/sgml/arch-dev.sgml | 8 +- doc/src/sgml/archive-modules.sgml | 10 +- doc/src/sgml/array.sgml | 8 +- doc/src/sgml/backup.sgml | 32 +- doc/src/sgml/basic-archive.sgml | 6 +- doc/src/sgml/bki.sgml | 4 +- doc/src/sgml/btree.sgml | 7 +- doc/src/sgml/catalogs.sgml | 65 +- doc/src/sgml/charset.sgml | 45 +- doc/src/sgml/citext.sgml | 4 +- doc/src/sgml/client-auth.sgml | 81 +- doc/src/sgml/config.sgml | 294 +++--- doc/src/sgml/contrib.sgml | 4 +- doc/src/sgml/custom-scan.sgml | 2 +- doc/src/sgml/datatype.sgml | 130 ++- doc/src/sgml/datetime.sgml | 8 +- doc/src/sgml/dblink.sgml | 4 +- doc/src/sgml/ddl.sgml | 71 +- doc/src/sgml/dict-int.sgml | 4 +- doc/src/sgml/dict-xsyn.sgml | 3 +- doc/src/sgml/dml.sgml | 18 +- doc/src/sgml/docguide.sgml | 3 +- doc/src/sgml/ecpg.sgml | 101 +- doc/src/sgml/event-trigger.sgml | 4 +- doc/src/sgml/extend.sgml | 70 +- doc/src/sgml/external-projects.sgml | 2 +- doc/src/sgml/fdwhandler.sgml | 10 +- doc/src/sgml/features.sgml | 4 +- doc/src/sgml/func/func-admin.sgml | 30 +- doc/src/sgml/func/func-aggregate.sgml | 34 +- doc/src/sgml/func/func-array.sgml | 11 +- doc/src/sgml/func/func-binarystring.sgml | 11 +- doc/src/sgml/func/func-comparisons.sgml | 16 +- doc/src/sgml/func/func-datetime.sgml | 63 +- doc/src/sgml/func/func-enum.sgml | 2 +- doc/src/sgml/func/func-event-triggers.sgml | 3 +- doc/src/sgml/func/func-info.sgml | 35 +- doc/src/sgml/func/func-json.sgml | 32 +- doc/src/sgml/func/func-logical.sgml | 3 +- doc/src/sgml/func/func-matching.sgml | 8 +- doc/src/sgml/func/func-math.sgml | 6 +- doc/src/sgml/func/func-range.sgml | 2 +- doc/src/sgml/func/func-srf.sgml | 4 +- doc/src/sgml/func/func-string.sgml | 17 +- doc/src/sgml/func/func-subquery.sgml | 19 +- doc/src/sgml/func/func-textsearch.sgml | 4 +- doc/src/sgml/func/func-uuid.sgml | 3 +- doc/src/sgml/func/func-window.sgml | 9 +- doc/src/sgml/func/func-xml.sgml | 17 +- doc/src/sgml/fuzzystrmatch.sgml | 12 +- doc/src/sgml/gin.sgml | 9 +- doc/src/sgml/gist.sgml | 8 +- doc/src/sgml/glossary.sgml | 8 +- doc/src/sgml/high-availability.sgml | 72 +- doc/src/sgml/hstore.sgml | 3 +- doc/src/sgml/indexam.sgml | 12 +- doc/src/sgml/indices.sgml | 21 +- doc/src/sgml/information_schema.sgml | 37 +- doc/src/sgml/install-binaries.sgml | 4 +- doc/src/sgml/installation.sgml | 88 +- doc/src/sgml/json.sgml | 30 +- doc/src/sgml/keywords.sgml | 5 +- doc/src/sgml/libpq.sgml | 79 +- doc/src/sgml/logical-replication.sgml | 86 +- doc/src/sgml/logicaldecoding.sgml | 39 +- doc/src/sgml/maintenance.sgml | 17 +- doc/src/sgml/manage-ag.sgml | 23 +- doc/src/sgml/monitoring.sgml | 64 +- doc/src/sgml/mvcc.sgml | 23 +- doc/src/sgml/oauth-validators.sgml | 11 +- doc/src/sgml/oid2name.sgml | 4 +- doc/src/sgml/pageinspect.sgml | 6 +- doc/src/sgml/parallel.sgml | 7 +- doc/src/sgml/passwordcheck.sgml | 6 +- doc/src/sgml/perform.sgml | 15 +- doc/src/sgml/pgstatstatements.sgml | 3 +- doc/src/sgml/planstats.sgml | 18 +- doc/src/sgml/plhandler.sgml | 3 +- doc/src/sgml/plperl.sgml | 14 +- doc/src/sgml/plpgsql.sgml | 133 ++- doc/src/sgml/plpython.sgml | 16 +- doc/src/sgml/pltcl.sgml | 6 +- doc/src/sgml/postgres-fdw.sgml | 3 +- doc/src/sgml/protocol.sgml | 85 +- doc/src/sgml/queries.sgml | 34 +- doc/src/sgml/query.sgml | 4 +- doc/src/sgml/rangetypes.sgml | 7 +- .../sgml/ref/alter_default_privileges.sgml | 3 +- doc/src/sgml/ref/alter_index.sgml | 4 +- doc/src/sgml/ref/alter_statistics.sgml | 4 +- doc/src/sgml/ref/alter_subscription.sgml | 15 +- doc/src/sgml/ref/alter_system.sgml | 2 +- doc/src/sgml/ref/alter_table.sgml | 23 +- doc/src/sgml/ref/analyze.sgml | 4 +- doc/src/sgml/ref/call.sgml | 2 +- doc/src/sgml/ref/checkpoint.sgml | 6 +- doc/src/sgml/ref/cluster.sgml | 2 +- doc/src/sgml/ref/clusterdb.sgml | 3 +- doc/src/sgml/ref/copy.sgml | 2 +- doc/src/sgml/ref/create_access_method.sgml | 5 +- doc/src/sgml/ref/create_aggregate.sgml | 12 +- doc/src/sgml/ref/create_collation.sgml | 9 +- doc/src/sgml/ref/create_database.sgml | 11 +- doc/src/sgml/ref/create_domain.sgml | 3 +- doc/src/sgml/ref/create_event_trigger.sgml | 4 +- doc/src/sgml/ref/create_extension.sgml | 3 +- doc/src/sgml/ref/create_foreign_table.sgml | 4 +- doc/src/sgml/ref/create_function.sgml | 12 +- doc/src/sgml/ref/create_index.sgml | 32 +- doc/src/sgml/ref/create_language.sgml | 4 +- .../sgml/ref/create_materialized_view.sgml | 10 +- doc/src/sgml/ref/create_opclass.sgml | 4 +- doc/src/sgml/ref/create_operator.sgml | 4 +- doc/src/sgml/ref/create_procedure.sgml | 4 +- doc/src/sgml/ref/create_publication.sgml | 12 +- doc/src/sgml/ref/create_role.sgml | 5 +- doc/src/sgml/ref/create_rule.sgml | 2 +- doc/src/sgml/ref/create_sequence.sgml | 3 +- doc/src/sgml/ref/create_server.sgml | 2 +- doc/src/sgml/ref/create_subscription.sgml | 10 +- doc/src/sgml/ref/create_table.sgml | 37 +- doc/src/sgml/ref/create_table_as.sgml | 9 +- doc/src/sgml/ref/create_tablespace.sgml | 5 +- doc/src/sgml/ref/create_trigger.sgml | 11 +- doc/src/sgml/ref/create_type.sgml | 16 +- doc/src/sgml/ref/createdb.sgml | 11 +- doc/src/sgml/ref/createuser.sgml | 3 +- doc/src/sgml/ref/declare.sgml | 10 +- doc/src/sgml/ref/delete.sgml | 4 +- doc/src/sgml/ref/drop_role.sgml | 3 +- doc/src/sgml/ref/dropdb.sgml | 3 +- doc/src/sgml/ref/dropuser.sgml | 3 +- doc/src/sgml/ref/fetch.sgml | 6 +- doc/src/sgml/ref/grant.sgml | 9 +- doc/src/sgml/ref/initdb.sgml | 34 +- doc/src/sgml/ref/insert.sgml | 10 +- doc/src/sgml/ref/lock.sgml | 7 +- doc/src/sgml/ref/merge.sgml | 8 +- doc/src/sgml/ref/pg_amcheck.sgml | 3 +- doc/src/sgml/ref/pg_basebackup.sgml | 15 +- doc/src/sgml/ref/pg_checksums.sgml | 15 +- doc/src/sgml/ref/pg_combinebackup.sgml | 3 +- doc/src/sgml/ref/pg_createsubscriber.sgml | 4 +- doc/src/sgml/ref/pg_dump.sgml | 18 +- doc/src/sgml/ref/pg_dumpall.sgml | 7 +- doc/src/sgml/ref/pg_isready.sgml | 3 +- doc/src/sgml/ref/pg_receivewal.sgml | 9 +- doc/src/sgml/ref/pg_recvlogical.sgml | 8 +- doc/src/sgml/ref/pg_restore.sgml | 8 +- doc/src/sgml/ref/pg_rewind.sgml | 4 +- doc/src/sgml/ref/pgarchivecleanup.sgml | 2 +- doc/src/sgml/ref/pgbench.sgml | 35 +- doc/src/sgml/ref/pgupgrade.sgml | 3 +- doc/src/sgml/ref/postgres-ref.sgml | 21 +- doc/src/sgml/ref/prepare_transaction.sgml | 5 +- doc/src/sgml/ref/psql-ref.sgml | 53 +- doc/src/sgml/ref/reindex.sgml | 4 +- doc/src/sgml/ref/reindexdb.sgml | 3 +- doc/src/sgml/ref/revoke.sgml | 3 +- doc/src/sgml/ref/select.sgml | 47 +- doc/src/sgml/ref/select_into.sgml | 4 +- doc/src/sgml/ref/set.sgml | 3 +- doc/src/sgml/ref/set_transaction.sgml | 7 +- doc/src/sgml/ref/vacuum.sgml | 10 +- doc/src/sgml/ref/vacuumdb.sgml | 10 +- doc/src/sgml/ref/values.sgml | 4 +- doc/src/sgml/regress.sgml | 13 +- doc/src/sgml/release-19.sgml | 907 ++++++++++-------- doc/src/sgml/replication-origins.sgml | 2 +- doc/src/sgml/rowtypes.sgml | 6 +- doc/src/sgml/rules.sgml | 7 +- doc/src/sgml/runtime.sgml | 44 +- doc/src/sgml/sepgsql.sgml | 6 +- doc/src/sgml/sources.sgml | 3 +- doc/src/sgml/spgist.sgml | 10 +- doc/src/sgml/start.sgml | 2 +- doc/src/sgml/storage.sgml | 30 +- doc/src/sgml/stylesheet-common.xsl | 2 +- doc/src/sgml/stylesheet-html-common.xsl | 15 + doc/src/sgml/syntax.sgml | 57 +- doc/src/sgml/system-views.sgml | 33 +- doc/src/sgml/tableam.sgml | 3 +- doc/src/sgml/tablesample-method.sgml | 8 +- doc/src/sgml/textsearch.sgml | 31 +- doc/src/sgml/trigger.sgml | 10 +- doc/src/sgml/typeconv.sgml | 14 +- doc/src/sgml/user-manag.sgml | 21 +- doc/src/sgml/uuid-ossp.sgml | 2 +- doc/src/sgml/vacuumlo.sgml | 4 +- doc/src/sgml/wal.sgml | 11 +- doc/src/sgml/xact.sgml | 4 +- doc/src/sgml/xaggr.sgml | 10 +- doc/src/sgml/xfunc.sgml | 66 +- doc/src/sgml/xindex.sgml | 31 +- doc/src/sgml/xplang.sgml | 8 +- doc/src/sgml/xtypes.sgml | 4 +- 199 files changed, 2120 insertions(+), 2327 deletions(-) diff --git a/doc/src/sgml/advanced.sgml b/doc/src/sgml/advanced.sgml index 3286c2cf0b2..0eab9ca2c18 100644 --- a/doc/src/sgml/advanced.sgml +++ b/doc/src/sgml/advanced.sgml @@ -571 +571 @@ SELECT sum(salary) OVER w, avg(salary) OVER w - More details about window functions can be found in + More details can be found in @@ -710 +710,2 @@ SELECT name, elevation - Although inheritance is frequently useful, it has not been integrated + Although is frequently useful, it has not + been integrated @@ -712 +712,0 @@ SELECT name, elevation - See for more detail. diff --git a/doc/src/sgml/amcheck.sgml b/doc/src/sgml/amcheck.sgml index 08006856579..1d26dfc0593 100644 --- a/doc/src/sgml/amcheck.sgml +++ b/doc/src/sgml/amcheck.sgml @@ -484 +484 @@ SET client_min_messages = DEBUG1; - linkend="regress-run"/> for details on running the tests. + linkend="regress-run"/> for details. diff --git a/doc/src/sgml/appendix-obsolete-default-roles.sgml b/doc/src/sgml/appendix-obsolete-default-roles.sgml index f5133f95760..f7179307ead 100644 --- a/doc/src/sgml/appendix-obsolete-default-roles.sgml +++ b/doc/src/sgml/appendix-obsolete-default-roles.sgml @@ -17,2 +17,2 @@ - See for current documentation regarding - Predefined Roles, and the release notes for + See for current documentation, and + the release notes for diff --git a/doc/src/sgml/arch-dev.sgml b/doc/src/sgml/arch-dev.sgml index 06b6e2a8493..18bbd249663 100644 --- a/doc/src/sgml/arch-dev.sgml +++ b/doc/src/sgml/arch-dev.sgml @@ -140,2 +140,2 @@ - PostgreSQL protocol described in - . Many clients are based on the + PostgreSQL . Many + clients are based on the @@ -351,2 +351,2 @@ - of time, PostgreSQL uses a Genetic - Query Optimizer (see ) when the number of joins + of time, PostgreSQL uses a + when the number of joins diff --git a/doc/src/sgml/archive-modules.sgml b/doc/src/sgml/archive-modules.sgml index 10ec96eae96..1edd8a47f25 100644 --- a/doc/src/sgml/archive-modules.sgml +++ b/doc/src/sgml/archive-modules.sgml @@ -10,2 +10,2 @@ - PostgreSQL provides infrastructure to create custom modules for continuous - archiving (see ). While archiving via + PostgreSQL provides infrastructure to create custom modules for + . While archiving via @@ -27,3 +27,3 @@ - Archiving modules must at least consist of an initialization function (see - ) and the required callbacks (see - ). However, archive modules are + Archiving modules must at least consist of + and the required + . However, archive modules are diff --git a/doc/src/sgml/array.sgml b/doc/src/sgml/array.sgml index ce338c770c9..8e850a82568 100644 --- a/doc/src/sgml/array.sgml +++ b/doc/src/sgml/array.sgml @@ -194,2 +194 @@ INSERT INTO sal_emp - double quoted as they would be in an array literal. The ARRAY - constructor syntax is discussed in more detail in + double quoted as they would be in an array literal. For more details, see @@ -660 +659 @@ SELECT * FROM sal_emp WHERE pay_by_quarter && ARRAY[10000]; - This and other array operators are further described in + For more information, see @@ -789,2 +788 @@ SELECT f1[1][-2][3] AS e1, f1[1][-1][5] AS e2 - The ARRAY constructor syntax (see - ) is often easier to work + is often easier to work diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index 168444eccc5..61478f724d1 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -81,2 +81 @@ pg_dump dbname > ). + mechanisms. @@ -386,2 +385 @@ tar -cf backup.tar /usr/local/pgsql/data - Information about stopping the server can be found in - . Needless to say, you + See for details. Needless to say, you @@ -445,2 +443,2 @@ tar -cf backup.tar /usr/local/pgsql/data - Another option is to perform a continuous archiving base backup () because such backups are immune to file + Another option is to perform a continuous archiving base backup + because such backups are immune to file @@ -449 +447,3 @@ tar -cf backup.tar /usr/local/pgsql/data - continuous archive recovery (). + continuous archive recovery. See + and + for more information. @@ -668 +668 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0 - useful server resources. For more information about archive modules, see + useful server resources. For more information, see @@ -813,2 +813,2 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0 - required, you can also make a base backup using the low level API - (see ). + required, you can also make a base backup as described in + . @@ -914,2 +914,2 @@ test ! -f /mnt/server/archivedir/00000001000000A900000065 && cp pg_wal/0 - and perform recovery, as described in - . The requirement to have earlier + and perform recovery. See for more + information. The requirement to have earlier @@ -1007,2 +1007 @@ SELECT pg_backup_start(label => 'label', fast => false); - for things to - consider during this backup. + for more information. @@ -1251,3 +1250,2 @@ SELECT * FROM pg_backup_stop(wait_for_archive => true); - Set recovery configuration settings in - postgresql.conf (see ) and create a file + Set in + postgresql.conf and create a file diff --git a/doc/src/sgml/basic-archive.sgml b/doc/src/sgml/basic-archive.sgml index b4d43ced203..8ab8790390b 100644 --- a/doc/src/sgml/basic-archive.sgml +++ b/doc/src/sgml/basic-archive.sgml @@ -11 +11,2 @@ - basic_archive is an example of an archive module. This + basic_archive is an example of + . This @@ -14,2 +15 @@ - developing your own archive module. For more information about archive - modules, see . + developing your own archive module. diff --git a/doc/src/sgml/bki.sgml b/doc/src/sgml/bki.sgml index 087a6827b00..ea9f6833a95 100644 --- a/doc/src/sgml/bki.sgml +++ b/doc/src/sgml/bki.sgml @@ -239,2 +239,2 @@ - the bootstrap scanner, according to the same rules as for escape string - constants (see ); for + the bootstrap scanner, according to the same rules as for + ; for diff --git a/doc/src/sgml/btree.sgml b/doc/src/sgml/btree.sgml index 027361f20bb..cd2e0e9c4df 100644 --- a/doc/src/sgml/btree.sgml +++ b/doc/src/sgml/btree.sgml @@ -642,2 +642 @@ options(relopts local_relopts *) returns - pages use the standard page format described in . + pages use the standard . @@ -704 +703 @@ options(relopts local_relopts *) returns - index cleanup performed by autovacuum workers, which is triggered + index cleanup performed by , which is triggered @@ -706 +705 @@ options(relopts local_relopts *) returns - thresholds are exceeded (see ). + thresholds are exceeded. diff --git a/doc/src/sgml/catalogs.sgml b/doc/src/sgml/catalogs.sgml index 4b474c13917..c0dce5fc28d 100644 --- a/doc/src/sgml/catalogs.sgml +++ b/doc/src/sgml/catalogs.sgml @@ -701,2 +701,2 @@ - Currently, only tables and indexes have access methods. The requirements for table - and index access methods are discussed in detail in and + Currently, only tables and indexes have access methods. The requirements for + these are discussed in detail in and @@ -1593,2 +1593 @@ - Role bypasses every row-level security policy, see - for more information. + Role bypasses all . @@ -2323 +2322 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -2370 +2369,2 @@ SCRAM-SHA-256$<iteration count>:&l - available collations, which are essentially mappings from an SQL + available , which are essentially mappings from an + SQL @@ -2372 +2371,0 @@ SCRAM-SHA-256$<iteration count>:&l - See for more information. @@ -3241 +3240 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -3885,2 +3884,2 @@ SCRAM-SHA-256$<iteration count>:&l - The catalog pg_event_trigger stores event triggers. - See for more information. + The catalog pg_event_trigger stores + . @@ -4202 +4201 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -4310 +4309 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -4840,2 +4839 @@ SCRAM-SHA-256$<iteration count>:&l - The initial access privileges; see - for details + The initial access @@ -4976 +4974 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -5125 +5123 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -5196 +5194 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -5686 +5684 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -6324 +6322 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -6851 +6849 @@ SCRAM-SHA-256$<iteration count>:&l - publications created in the database. For more on publications see + publications created in the database. For more information, see @@ -8526,2 +8524,2 @@ SCRAM-SHA-256$<iteration count>:&l - logical replication subscriptions. For more information about logical - replication see . + logical replication subscriptions. For more information, see + . @@ -8786,2 +8784,2 @@ SCRAM-SHA-256$<iteration count>:&l - publications defined in the upstream database. For more on publications - see . + publications defined in the upstream database. For more information, see + . @@ -8972 +8970 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access @@ -9351,2 +9349 @@ SCRAM-SHA-256$<iteration count>:&l - PostgreSQL's text search features are - described at length in . + For details, see . @@ -9438,2 +9435 @@ SCRAM-SHA-256$<iteration count>:&l - PostgreSQL's text search features are - described at length in . + For details, see . @@ -9520,2 +9516 @@ SCRAM-SHA-256$<iteration count>:&l - PostgreSQL's text search features are - described at length in . + For details, see . @@ -9617,2 +9612 @@ SCRAM-SHA-256$<iteration count>:&l - PostgreSQL's text search features are - described at length in . + For details, see . @@ -9735,2 +9729 @@ SCRAM-SHA-256$<iteration count>:&l - PostgreSQL's text search features are - described at length in . + For details, see . @@ -10274 +10267 @@ SCRAM-SHA-256$<iteration count>:&l - Access privileges; see for details + Access diff --git a/doc/src/sgml/charset.sgml b/doc/src/sgml/charset.sgml index 746e40bb9d2..ba4f8ac4295 100644 --- a/doc/src/sgml/charset.sgml +++ b/doc/src/sgml/charset.sgml @@ -15,2 +15,2 @@ - Using the locale features of the operating system to provide - locale-specific collation order, number formatting, translated + Using of the operating system to provide + locale-specific , number formatting, translated @@ -18,2 +17,0 @@ - This is covered in and - . @@ -25 +23 @@ - Providing a number of different character sets to support storing text + Providing to support storing text @@ -28 +25,0 @@ - This is covered in . @@ -150,2 +147 @@ initdb --locale=sv_SE - (But you can alleviate this restriction using collations, as discussed - in .) + (But you can alleviate this restriction using .) @@ -270 +266,2 @@ initdb --locale=sv_SE - operator classes exist. These allow the creation of an index that + exist. These allow the creation of an + index that @@ -272,2 +269 @@ initdb --locale=sv_SE - locale comparison rules. Refer to - for more information. Another approach is to create indexes using + locale comparison rules. Another approach is to create indexes using @@ -325,2 +321,2 @@ initdb --locale=sv_SE - SQL object called collation and is explained in - . Use this for example to sort data in + SQL object called . Use this for example to + sort data in @@ -846 +842,2 @@ SELECT * FROM test1 ORDER BY a || b COLLATE "fr_FR"; - is tied to a character set encoding (see ). + is tied to a character set encoding. See for + more information. @@ -1158,3 +1155,3 @@ CREATE COLLATION german (provider = icu, locale = 'de-DE'); - New ICU collations can customize collation behavior extensively by - including collation attributes in the language tag. See for details and examples. + New can customize collation + behavior extensively by + including collation attributes in the language tag. @@ -1246 +1243,2 @@ CREATE COLLATION ignore_accents (provider = icu, locale = 'und-u-ks-level1-kc-tr - collations with collation settings as a part of the language tag. These + collations with as a part of the + language tag. These @@ -1266,2 +1264 @@ SELECT 'w;x*y-z' = 'wxyz' COLLATE num_ignore_punct; -- true - Many of the available options are described in , or see ) is only a brief + is only a brief @@ -2313,2 +2310 @@ $ psql -l - character sets ( - shows which ones). + character sets; see . @@ -2340 +2336,2 @@ $ psql -l - libpq () has functions to control the client encoding. + libpq provides + for the client encoding. diff --git a/doc/src/sgml/citext.sgml b/doc/src/sgml/citext.sgml index 8322885661e..48ca797c16d 100644 --- a/doc/src/sgml/citext.sgml +++ b/doc/src/sgml/citext.sgml @@ -19,2 +19,2 @@ - Consider using nondeterministic collations (see - ) instead of this module. They + Consider using instead of this + module. They diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml index e4e65f8feb1..0d162268cfb 100644 --- a/doc/src/sgml/client-auth.sgml +++ b/doc/src/sgml/client-auth.sgml @@ -291 +291 @@ include_dir directory - (See for details of + (See for @@ -324 +324 @@ include_dir directory - (See for details of + (See for @@ -482,3 +482,3 @@ include_dir directory - Specifies the authentication method to use when a connection matches - this record. The possible choices are summarized here; details - are in . All the options + Specifies which to use when a connection + matches + this record. The possible choices are summarized here. All the options @@ -520,2 +520,3 @@ include_dir directory - Perform SCRAM-SHA-256 authentication to verify the user's - password. See for details. + Perform SCRAM-SHA-256 to verify the + user's + password. @@ -530,3 +531,3 @@ include_dir directory - Perform SCRAM-SHA-256 or MD5 authentication to verify the - user's password. See - for details. + Perform SCRAM-SHA-256 or MD5 to verify + the + user's password. @@ -551 +552 @@ include_dir directory - authentication. + . @@ -554 +554,0 @@ include_dir directory - See for details. @@ -563,3 +563,3 @@ include_dir directory - Use GSSAPI to authenticate the user. This is only - available for TCP/IP connections. See for details. It can be used in conjunction + Use to authenticate the user. This is + only + available for TCP/IP connections. It can be used in conjunction @@ -575,3 +575,2 @@ include_dir directory - Use SSPI to authenticate the user. This is only - available on Windows. See for details. + Use to authenticate the user. This is only + available on Windows. @@ -589 +588 @@ include_dir directory - Ident authentication can only be used on TCP/IP + can only be used on TCP/IP @@ -592 +590,0 @@ include_dir directory - See for details. @@ -613,2 +611,2 @@ include_dir directory - Authenticate using an LDAP server. See for details. + Authenticate using an LDAP server, as described + in . @@ -623,2 +621,2 @@ include_dir directory - Authenticate using SSL client certificates. See - for details. + Authenticate using SSL client certificates, as described in + . @@ -634,2 +632,2 @@ include_dir directory - (PAM) service provided by the operating system. See for details. + (PAM) service provided by the operating system, as described + in . @@ -644,2 +642,3 @@ include_dir directory - Authenticate using the BSD Authentication service provided by the - operating system. See for details. + Authenticate using the service provided by + the + operating system. @@ -654,2 +653,3 @@ include_dir directory - Authorize and optionally authenticate using a third-party OAuth 2.0 - identity provider. See for details. + Authorize and optionally authenticate using a third-party + + identity provider. @@ -685,2 +685,2 @@ include_dir directory - This behavior is similar to the cert authentication - method (see ) but enables pairing + This behavior is similar to but enables + pairing @@ -994 +994 @@ local db1,db2,@demodbs all scram-sha-256 - (See for details of + (See for @@ -1457,2 +1457,2 @@ omicron bryanh guest1 - stripped off before being passed through the user name mapping - (). This is discouraged and is + stripped off before being passed through + . This is discouraged and is @@ -1536,2 +1536 @@ omicron bryanh guest1 - GSSAPI does; see - for details. + does. @@ -1549,2 +1548,2 @@ omicron bryanh guest1 - stripped off before being passed through the user name mapping - (). This is discouraged and is + stripped off before being passed through + . This is discouraged and is @@ -1648 +1647 @@ omicron bryanh guest1 - peer authentication (see ) will be + will be @@ -2389 +2388 @@ host ... ldap ldapbasedn="dc=example,dc=net" - information on validators). This parameter is required. + information). This parameter is required. diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index 9275cfa1b10..29d4cceb93e 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -511,2 +511 @@ include_dir 'conf.d' - client authentication (their use is discussed in ) and SSL host configuration. + and SSL host configuration. @@ -575 +574,2 @@ include_dir 'conf.d' - Specifies the configuration file for user name mapping + Specifies the configuration file for + @@ -578 +577,0 @@ include_dir 'conf.d' - See also . @@ -689,2 +688,2 @@ include_dir 'conf.d' - While client authentication () allows fine-grained control + While allows fine-grained control @@ -1292,2 +1291,2 @@ include_dir 'conf.d' - implementations. For more information on implementing OAuth validators, - see . + implementations. For more information, see + . @@ -1861,2 +1860,2 @@ include_dir 'conf.d' - spent on memory management, increasing performance. For more details about - using huge pages on Linux, see . + spent on memory management, increasing performance. For more details, + see . @@ -2341 +2340 @@ include_dir 'conf.d' - Specifies the shared memory implementation that the server + Specifies the implementation that the server @@ -2352,2 +2351 @@ include_dir 'conf.d' - non-default kernel settings to allow for large allocations (see ). + non-default kernel settings to allow for large allocations. @@ -3132 +3130 @@ include_dir 'conf.d' - For more information on parallel query, see + For more information, see @@ -3615,2 +3613 @@ include_dir 'conf.d' - WAL archiving for point-in-time recovery (PITR) - (see ). + WAL archiving for . @@ -4052,4 +4049,5 @@ include_dir 'conf.d' - the WAL archiver is enabled also during archive recovery or standby - mode. In always mode, all files restored from the archive - or streamed with streaming physical replication will be archived (again). See - for details. + the WAL archiver is enabled also during + . + In always mode, all files restored from the archive + or streamed with streaming physical replication will be archived + (again). @@ -4087,2 +4085,2 @@ include_dir 'conf.d' - exit status only if it succeeds. For more information see - . + exit status only if it succeeds; see + for more details. @@ -4119 +4117,2 @@ include_dir 'conf.d' - The library to use for archiving completed WAL file segments. If set to + The library to use for . If set + to @@ -4124,4 +4123,4 @@ include_dir 'conf.d' - shared library is used for archiving. The WAL archiver process is - restarted by the postmaster when this parameter changes. For more - information, see and - . + shared library is used for archiving; see + for the API. + The WAL archiver process is + restarted by the postmaster when this parameter changes. @@ -4268,2 +4267,3 @@ include_dir 'conf.d' - parameters from this section and are of interest. + parameters from are of interest, as well as + those in this section. @@ -4281,2 +4281,3 @@ include_dir 'conf.d' - In this mode, the parameters from both this section and will be used. + In this mode, the parameters from and this section will be + used. @@ -4308,2 +4309 @@ include_dir 'conf.d' - used by warm-standby configurations - (see ). + used by . @@ -4362,2 +4362,2 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - archive_cleanup_command would typically be used in a - warm-standby configuration (see ). + archive_cleanup_command would typically be used in + . @@ -4738,5 +4738,3 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - streaming replication, - both physical replication - (see ) and - logical replication (see - ). + , + both physical replication and + . @@ -4748,2 +4746,2 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - are always receivers of replicated data. When cascading replication - (see ) is used, standby servers + are always receivers of replicated data. When + is used, standby servers @@ -4762,3 +4760,2 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - the following sections refer to publishers as "senders". For more details - about logical replication configuration settings refer to - . + the following sections refer to publishers as "senders". For more details, + refer to . @@ -4833,2 +4830,2 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - Specifies the maximum number of replication slots - (see ) that the server + Specifies the maximum number of + that the server @@ -5046,2 +5043,3 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - server, and optionally WAL archiving can be enabled as - well (see ). + server, and optionally WAL + can be enabled as + well. @@ -5064 +5061,0 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows - synchronous replication, as described in @@ -5249,4 +5246,4 @@ ANY num_sync ( . If any option is - unspecified in this string, then the corresponding environment - variable (see ) is checked. If the + to connect with a sending server. This string uses the format of + . If any option is + unspecified in this string, then the corresponding + are checked. If the @@ -5270,2 +5267,2 @@ ANY num_sync ( ), + For + , @@ -5298 +5295,2 @@ ANY num_sync ( ). + See for more + information. @@ -5339,2 +5337,2 @@ ANY num_sync ( . + conflict with about-to-be-applied WAL entries; see + for details. @@ -5371,2 +5369,2 @@ ANY num_sync ( . + conflict with about-to-be-applied WAL entries; see + for details. @@ -5760,2 +5758,2 @@ ANY num_sync ( ), + plans chosen by the optimizer include adjusting + , @@ -5932,2 +5930,2 @@ ANY num_sync ( ). + Enables or disables the query planner's use of + . @@ -6475,2 +6473 @@ ANY num_sync ( ). + Sets the query cost above which is activated. @@ -6530 +6527 @@ ANY num_sync ( (GEQO) is an algorithm that does query @@ -6535 +6531,0 @@ ANY num_sync ( . @@ -6697,3 +6693,2 @@ ANY num_sync ( . + planner's estimates. The default is 100. For more information, + refer to . @@ -6759,2 +6754 @@ SELECT * FROM parent WHERE key = 2400; - more information on using constraint exclusion to implement - partitioning. + more information. @@ -6803,2 +6797,3 @@ SELECT * FROM parent WHERE key = 2400; - may trigger use of the GEQO planner, resulting in non-optimal - plans. See . + may trigger use of , + resulting in non-optimal + plans. @@ -6849,2 +6844,2 @@ SELECT * FROM parent WHERE key = 2400; - order they desire explicitly. - For more information see . + order they desire explicitly; see for + more information. @@ -6855,2 +6850,3 @@ SELECT * FROM parent WHERE key = 2400; - may trigger use of the GEQO planner, resulting in non-optimal - plans. See . + may trigger use of , + resulting in non-optimal + plans. @@ -7019 +7015,2 @@ local0.* /var/log/postgresql - system so that the Windows Event Viewer can display event + system, as described in , + so that the Windows Event Viewer can display event @@ -7021 +7017,0 @@ local0.* /var/log/postgresql - See for details. @@ -7784 +7780 @@ local0.* /var/log/postgresql - + @@ -8092,2 +8088,3 @@ local0.* /var/log/postgresql - VERBOSE output includes the SQLSTATE error - code (see also ) and the source code file name, function name, + VERBOSE output includes the + and the source code file name, + function name, @@ -8248 +8245 @@ local0.* /var/log/postgresql - Virtual transaction ID (procNumber/localXID); see + Virtual transaction ID (procNumber/localXID) @@ -8254 +8251 @@ local0.* /var/log/postgresql - Transaction ID (0 if none is assigned); see + Transaction ID (0 if none is assigned) @@ -8563 +8560,2 @@ log_line_prefix = '%m [%p] %q%u@%d/%a ' - Sets the time zone used for timestamps written in the server log. + Sets the used for timestamps + written in the server log. @@ -8569 +8566,0 @@ log_line_prefix = '%m [%p] %q%u@%d/%a ' - See for more information. @@ -9033,2 +9030,2 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - Enables timing of cost-based vacuum delay (see - ). This parameter + Enables timing of . + This parameter @@ -9270,2 +9267 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - These parameters control vacuuming behavior. For more information on the - purpose and responsibilities of vacuum, see . + These parameters control behavior. @@ -9278,2 +9274 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - These settings control the behavior of the autovacuum - feature. Refer to for more information. + These settings control the behavior of . @@ -9574 +9569,2 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - For more information see . + see for more + information. @@ -9930 +9926 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - information on transaction ID wraparound and tuning these parameters. + information. @@ -10247 +10243 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - For more information on schema handling, see + For more information, see @@ -10257 +10253 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - (see ). + in . @@ -10354 +10350 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - For more information on tablespaces, + For more information, @@ -10818 +10814 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - Sets the output format for values of type bytea. + Sets the output format for values of . @@ -10821,2 +10817 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - format). See for more - information. The bytea type always + format). The bytea type always @@ -10842,2 +10837,2 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - base64. For further information about - XML-related functions, see . + base64. For further information, + see . @@ -10872,2 +10867,2 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv; - XML and character string values. See for a description of this. Valid + and character string values. + Valid @@ -10899 +10894 @@ SET XML OPTION { DOCUMENT | CONTENT }; - when fastupdate is enabled. If the list grows + when is enabled. If the list grows @@ -10906 +10901 @@ SET XML OPTION { DOCUMENT | CONTENT }; - See and + See @@ -10997 +10992,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Sets the display format for date and time values, as well as the + Sets the display format for values, + as well as the @@ -11007,3 +11003,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - NonEuropean are synonyms for MDY. See - for more information. The - built-in default is ISO, MDY, but + NonEuropean are synonyms for MDY. + The built-in default is ISO, MDY, but @@ -11042,2 +11037 @@ SET XML OPTION { DOCUMENT | CONTENT }; - interpretation of ambiguous interval input. See - for more information. + interpretation of ambiguous . @@ -11057 +11051,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Sets the time zone for displaying and interpreting time stamps. + Sets the for displaying and + interpreting time stamps. @@ -11061 +11055,0 @@ SET XML OPTION { DOCUMENT | CONTENT }; - See for more information. @@ -11107,2 +11101,3 @@ SET XML OPTION { DOCUMENT | CONTENT }; - If the value is 1 (the default) or above, float values are output in - shortest-precise format; see . The + If the value is 1 (the default) or above, + values are output in + shortest-precise format. The @@ -11147,3 +11142,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - The default is to use the database encoding. - The character sets supported by the PostgreSQL - server are described in . + The default is to use the database encoding; see + for available options. @@ -11192 +11186,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Sets the locale to use for formatting monetary amounts, for + Sets the to use for formatting monetary + amounts, for @@ -11194,2 +11189,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - functions. Acceptable values are system-dependent; see for more information. If this variable is + functions. Acceptable values are system-dependent. + If this variable is @@ -11211 +11206,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Sets the locale to use for formatting numbers, for example + Sets the to use for formatting numbers, for + example @@ -11213,2 +11209,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - functions. Acceptable values are system-dependent; see for more information. If this variable is + functions. Acceptable values are system-dependent. + If this variable is @@ -11230 +11226,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Sets the locale to use for formatting dates and times, for example + Sets the to use for formatting dates and times, + for example @@ -11232,2 +11229,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - functions. Acceptable values are system-dependent; see for more information. If this variable is + functions. Acceptable values are system-dependent. + If this variable is @@ -11275 +11272,2 @@ SET XML OPTION { DOCUMENT | CONTENT }; - Selects the text search configuration that is used by those variants + Selects the configuration that is used by + those variants @@ -11278 +11275,0 @@ SET XML OPTION { DOCUMENT | CONTENT }; - See for further information. @@ -11484,2 +11481 @@ SET XML OPTION { DOCUMENT | CONTENT }; - This variable is the name of the JIT provider library to be used - (see ). + This variable is the name of to be used. @@ -11570 +11566,2 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' - A path to search for extensions, specifically extension control files + A path to search for extensions, specifically + @@ -11574 +11570,0 @@ dynamic_library_path = 'C:\tools\postgresql;H:\my_project\lib;$libdir' - See for details. @@ -11930 +11926 @@ dynamic_library_path = '/usr/local/lib/postgresql:$libdir' - Escape string syntax () + @@ -12368 +12364,2 @@ dynamic_library_path = '/usr/local/lib/postgresql:$libdir' - Reports whether the server is currently in hot standby mode. When + Reports whether the server is currently in + . When @@ -12371,2 +12368 @@ dynamic_library_path = '/usr/local/lib/postgresql:$libdir' - promoted to be primary. See for more - information. + promoted to be primary. @@ -12534,2 +12530 @@ dynamic_library_path = '/usr/local/lib/postgresql:$libdir' - details about using huge pages on Linux, see - . + details, see . @@ -12579,2 +12574,3 @@ dynamic_library_path = '/usr/local/lib/postgresql:$libdir' - Reports the size of write ahead log segments. The default value is - 16MB. See for more information. + Reports the size of segments. The + default value is + 16MB. @@ -13299,2 +13295,2 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1) - Determines whether expressions are JIT compiled, when JIT compilation - is activated (see ). The default is + Determines whether expressions are JIT compiled; see + . The default is @@ -13334,2 +13330,2 @@ LOG: CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1) - Determines whether tuple deforming is JIT compiled, when JIT - compilation is activated (see ). + Determines whether tuple deforming is JIT compiled; see + . diff --git a/doc/src/sgml/contrib.sgml b/doc/src/sgml/contrib.sgml index b9b03654aad..eda7a9ffbc0 100644 --- a/doc/src/sgml/contrib.sgml +++ b/doc/src/sgml/contrib.sgml @@ -199,3 +199 @@ pages. - more information about the contrib section in general and - server extensions and plug-ins found in contrib - specifically. + more information about server extensions and plug-ins found there. diff --git a/doc/src/sgml/custom-scan.sgml b/doc/src/sgml/custom-scan.sgml index a200d502cdd..0a5384c2dc7 100644 --- a/doc/src/sgml/custom-scan.sgml +++ b/doc/src/sgml/custom-scan.sgml @@ -148 +148 @@ Plan *(*PlanCustomPath) (PlannerInfo *root, - initialize. See for more details. + initialize, as described in . diff --git a/doc/src/sgml/datatype.sgml b/doc/src/sgml/datatype.sgml index d8d91678e86..061a2600822 100644 --- a/doc/src/sgml/datatype.sgml +++ b/doc/src/sgml/datatype.sgml @@ -440,5 +440,3 @@ - The syntax of constants for the numeric types is described in - . The numeric types have a - full set of corresponding arithmetic operators and - functions. Refer to for more - information. The following sections describe the types in detail. + The numeric types use as literals + and support a full set of arithmetic . + The following sections describe the types in detail. @@ -958,2 +956,2 @@ FROM generate_series(-3.5, 3.5, 1) AS x; - autoincrementing column. Another way is to use the SQL-standard - identity column feature, described at . + autoincrementing column. Another way is to use + . @@ -1000 +998,2 @@ ALTER SEQUENCE tablename_bigserial are implemented using sequences, there may + bigserial are implemented using + , there may @@ -1006,2 +1005 @@ ALTER SEQUENCE tablename_nextval() in - for details. + See nextval() for details. @@ -1276 +1274,2 @@ SELECT '52093.89'::money::numeric::float8; - determined by the database character set, which is selected when + determined by the database's , which is selected + when @@ -1279 +1277,0 @@ SELECT '52093.89'::money::numeric::float8; - For more information refer to . @@ -1319 +1317 @@ SELECT '52093.89'::money::numeric::float8; - for information about available operators and functions. + for operators and functions. @@ -1746,3 +1744,2 @@ SELECT 'abc \153\154\155 \052\251\124'::bytea; - linkend="datatype-datetime-table"/>. The operations available - on these data types are described in - . + linkend="datatype-datetime-table"/>. + are available for these data types. @@ -1895 +1892 @@ MINUTE TO SECOND - for the exact parsing rules of date/time input and for the + for exact parsing rules and @@ -2176,2 +2173 @@ MINUTE TO SECOND - Refer to for more information on how - to specify time zones. + Refer to for more information. @@ -2275,2 +2271,2 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - timezone or use the AT TIME ZONE construct - (see ). + timezone or use + . @@ -2371 +2367 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - The following SQL-compatible functions can also + The following can also @@ -2376,2 +2372 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - LOCALTIMESTAMP. (See .) Note that these are + LOCALTIMESTAMP. Note that these are @@ -2486 +2481 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - for how this setting also affects interpretation of input values.) + for how this setting affects input interpretation.) @@ -2555,2 +2550,3 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - The formatting function to_char - (see ) is also available as + The to_char function from + + is also available as @@ -2637,3 +2633,2 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - The recognized time zone names are listed in the - pg_timezone_names view (see ). + The recognized time zone names are listed in + . @@ -2651,2 +2646,2 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - are listed in the pg_timezone_abbrevs view (see ). You cannot set the + are listed in . You cannot + set the @@ -2663,2 +2658 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - PostgreSQL will accept POSIX-style time zone - specifications, as described in + PostgreSQL will also accept @@ -2711 +2705 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - they are obtained from configuration files stored under + they are obtained from stored under @@ -2713,2 +2707 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - of the installation directory - (see ). + of the installation directory. @@ -2720 +2713 @@ TIMESTAMP WITH TIME ZONE '2004-10-19 10:23:54+02' - other standard ways described in . + other ways described in . @@ -3173,3 +3166,2 @@ SELECT * FROM test1 WHERE a; - representations by following the generic string-literal constant syntax - described in , for - example 'yes'::boolean. + representations by following , + for example 'yes'::boolean. @@ -3436 +3428,2 @@ SELECT person.name, holidays.num_weeks FROM person, holidays - A rich set of functions and operators is available to perform various geometric + A rich set of is available to perform + various geometric @@ -3438 +3431 @@ SELECT person.name, holidays.num_weeks FROM person, holidays - intersections. They are explained in . + intersections. @@ -3702,2 +3695,2 @@ SELECT person.name, holidays.num_weeks FROM person, holidays - these types offer input error checking and specialized - operators and functions (see ). + these types offer input error checking and . @@ -4106,4 +4099,3 @@ SELECT macaddr8_set7bit('08:00:2b:01:02:03'); - linkend="sql-syntax-bit-strings"/> for information about the syntax - of bit string constants. Bit-logical operators and string - manipulation functions are available; see . + linkend="sql-syntax-bit-strings"/> for the syntax + of bit-string constants. are available. @@ -4137 +4129 @@ SELECT * FROM test; - in for character strings). + in ). @@ -4156 +4148,2 @@ SELECT * FROM test; - are designed to support full text search, which is the activity of + are designed to support , which is the activity + of @@ -4162,3 +4155,2 @@ SELECT * FROM test; - provides a detailed explanation of this - facility, and summarizes the - related functions and operators. + See for related functions and + operators. @@ -4263 +4255 @@ SELECT 'The Fat Rats'::tsvector; - for searching: + for : @@ -4272 +4263,0 @@ SELECT to_tsvector('english', 'The Fat Rats'); - Again, see for more detail. @@ -4469,3 +4460,3 @@ decode('HqPWTLxATMOEu2sR7jHlwg==', 'base64')::uuid - checks the input values for well-formedness, and there are support - functions to perform type-safe operations on it; see . Use of this data type requires the + checks the input values for well-formedness, and there are to perform type-safe operations on it. Use of + this data type requires the @@ -4491,2 +4482,3 @@ decode('HqPWTLxATMOEu2sR7jHlwg==', 'base64')::uuid - Limits and compatibility notes for the xml data type - can be found in . + See for limits and compatibility + notes + on the xml data type. @@ -4580,2 +4572,2 @@ SET xmloption TO { DOCUMENT | CONTENT }; - server and vice versa to the character encoding of the respective - end; see . This includes string + server and vice versa to the of the respective + end. This includes string @@ -5114,2 +5106 @@ WHERE ... - (The system columns are further explained in .) + (See .) @@ -5305 +5296 @@ WHERE ... - Indicates that a function accepts any enum data type + Indicates that a function accepts any enum type @@ -5312 +5303 @@ WHERE ... - Indicates that a function accepts any range data type + Indicates that a function accepts any range type @@ -5347 +5338 @@ WHERE ... - Indicates that a function accepts any range data type, + Indicates that a function accepts any range type, @@ -5445,2 +5436 @@ WHERE ... - using the polymorphic pseudo-types, which are shown above and discussed - in detail in . + using , which are shown above. diff --git a/doc/src/sgml/datetime.sgml b/doc/src/sgml/datetime.sgml index 5905f5fa550..9d6991fc1a9 100644 --- a/doc/src/sgml/datetime.sgml +++ b/doc/src/sgml/datetime.sgml @@ -83,2 +83,2 @@ - These abbreviations are determined by the configuration settings - described in . + These abbreviations are determined by + . @@ -658,2 +658,2 @@ - abbreviations recognized in timestamp input are determined as explained - in . + abbreviations recognized in timestamp input are listed in + . diff --git a/doc/src/sgml/dblink.sgml b/doc/src/sgml/dblink.sgml index fc496b74288..e999aa2e57e 100644 --- a/doc/src/sgml/dblink.sgml +++ b/doc/src/sgml/dblink.sgml @@ -119 +119,2 @@ dblink_connect(text connname, text connstr) returns text - libpq-style connection info string, for example + libpq-style , +for example @@ -122 +122,0 @@ dblink_connect(text connname, text connstr) returns text - For details see . diff --git a/doc/src/sgml/ddl.sgml b/doc/src/sgml/ddl.sgml index 747f929aee3..05e06b1f908 100644 --- a/doc/src/sgml/ddl.sgml +++ b/doc/src/sgml/ddl.sgml @@ -64 +64,2 @@ - built-in data types that fit many applications. Users can also + built-in that fit many applications. Users can + also @@ -66,2 +67 @@ - names and semantics, so we defer a detailed explanation to . Some of the frequently used data types are + names and semantics. Some of the frequently used data types are @@ -157 +157 @@ DROP TABLE products; - If you need to modify a table that already exists, see .) + (See .) @@ -222,2 +222,2 @@ CREATE TABLE products ( - from a sequence object (see ). This arrangement is sufficiently common + from . This arrangement is sufficiently common @@ -231 +231 @@ CREATE TABLE products ( - The SERIAL shorthand is discussed further in SERIAL shorthand is described in ) or inheritance - hierarchies (see ), since without it, + particularly handy for queries that select from + or + hierarchies, since without it, @@ -1580,2 +1580,2 @@ CREATE TABLE circles ( - around. This is not a fatal problem given appropriate maintenance - procedures; see for details. It is + around. This is not a fatal problem given appropriate + ; see that section for details. It is @@ -1677 +1677 @@ CREATE TABLE products ( - linkend="rangetypes"/> for more information about range types. + linkend="rangetypes"/> for more information. @@ -1751,2 +1751,3 @@ CREATE TABLE products ( - Temporal primary keys and unique constraints are backed by GiST indexes - (see ) rather than B-Tree indexes. In practice, + Temporal primary keys and unique constraints are backed by + + rather than B-Tree indexes. In practice, @@ -1760 +1761 @@ CREATE TABLE products ( - exclusion constraints (see ), + , @@ -2020,2 +2021 @@ ALTER TABLE products DROP COLUMN description CASCADE; - See for a description of the general - mechanism behind this. + See for the general mechanism behind this. @@ -2250 +2250 @@ ALTER TABLE products RENAME TO items; - members of the owning role; see .) + .) @@ -2281,3 +2281,2 @@ GRANT UPDATE ON accounts TO joe; - group roles can be set up to help manage privileges when - there are many users of a database — for details see - . + can be set up to help manage privileges when + there are many users of a database. @@ -3723,2 +3722,2 @@ REVOKE CREATE ON SCHEMA public FROM PUBLIC; - key word, hence the different capitalization; recall the - guidelines from .) + key word, hence the different capitalization; recall + .) @@ -4110,2 +4109,2 @@ VALUES ('Albany', NULL, NULL, 'NY'); - when the inheritance relationship is being used for table - partitioning (see ). + when the inheritance relationship is being used for + . @@ -4152,2 +4151,2 @@ VALUES ('Albany', NULL, NULL, 'NY'); - without an additional grant. In a similar way, the parent table's row - security policies (see ) are applied to + without an additional grant. In a similar way, the parent table's + are applied to @@ -4161 +4160 @@ VALUES ('Albany', NULL, NULL, 'NY'); - Foreign tables (see ) can also + can also @@ -4863 +4862 @@ ALTER TABLE measurement SPLIT PARTITION measurement_y2006q1 INTO - inheritance apply as described in , with + apply, with @@ -5665,2 +5664,2 @@ EXPLAIN SELECT count(*) FROM measurement WHERE logdate >= DATE '2008-01-01'; - There are some foreign data wrappers available as contrib - modules; see . Other kinds of foreign data + There are some foreign data wrappers available as . + Other kinds of foreign data @@ -6080,2 +6079,2 @@ CREATE FUNCTION get_color_note (rainbow) RETURNS text AS - (See for an explanation of SQL-language - functions.) PostgreSQL will be aware that + (See .) PostgreSQL + will be aware that diff --git a/doc/src/sgml/dict-int.sgml b/doc/src/sgml/dict-int.sgml index b4ce5484823..20c74ab7641 100644 --- a/doc/src/sgml/dict-int.sgml +++ b/doc/src/sgml/dict-int.sgml @@ -89,2 +89,2 @@ mydb# SELECT ts_lexize('intdict', '12345678'); - but real-world usage will involve including it in a text search - configuration as described in . + but real-world usage will involve including it in a + . diff --git a/doc/src/sgml/dict-xsyn.sgml b/doc/src/sgml/dict-xsyn.sgml index a94c6430ed4..de47dc753bf 100644 --- a/doc/src/sgml/dict-xsyn.sgml +++ b/doc/src/sgml/dict-xsyn.sgml @@ -137,2 +137 @@ mydb=# SELECT ts_lexize('xsyn', 'syn1'); - Real-world usage will involve including it in a text search - configuration as described in . + Real-world usage will involve including it in a . diff --git a/doc/src/sgml/dml.sgml b/doc/src/sgml/dml.sgml index 429aae9bd7b..965909659a9 100644 --- a/doc/src/sgml/dml.sgml +++ b/doc/src/sgml/dml.sgml @@ -109,2 +109,2 @@ INSERT INTO products (product_no, name, price) - This provides the full power of the SQL query mechanism () for computing the rows to be inserted. + This provides the full power of for computing the rows to be inserted. @@ -119,2 +119 @@ INSERT INTO products (product_no, name, price) - to for more information on improving - bulk loading performance. + to for more information. @@ -205,2 +204,3 @@ UPDATE products SET price = price * 1.10; - not have to be an equality test. Many other operators are - available (see ). But the expression + not have to be an equality test. Many other are + available. But the expression @@ -476,2 +476,2 @@ DELETE FROM products - a SELECT command's output list - (see ). It can contain column + a SELECT command's . + It can contain column @@ -569 +569 @@ UPDATE products SET price = price * 1.10 - If there are triggers () on the target table, + If there are on the target table, diff --git a/doc/src/sgml/docguide.sgml b/doc/src/sgml/docguide.sgml index 7b61b4841aa..05d268b64f3 100644 --- a/doc/src/sgml/docguide.sgml +++ b/doc/src/sgml/docguide.sgml @@ -268,2 +268 @@ checking for dbtoepub... dbtoepub - Meson, instead run meson setup as described in - , and then see + Meson, instead follow , and then see diff --git a/doc/src/sgml/ecpg.sgml b/doc/src/sgml/ecpg.sgml index 6203b2518cf..4e8fc5dbf5a 100644 --- a/doc/src/sgml/ecpg.sgml +++ b/doc/src/sgml/ecpg.sgml @@ -76,3 +76,2 @@ EXEC SQL ...; - C rules, for parsing quoted strings and identifiers. - (See and - respectively.) + C rules, for parsing and + respectively. @@ -203,3 +202,3 @@ EXEC SQL CONNECT TO target AS - The allowed key words are the same ones recognized - by libpq (see - ). Spaces are ignored before + The allowed are the same ones + recognized + by libpq. Spaces are ignored before @@ -489,3 +488,3 @@ EXEC SQL COMMIT; - see below. (As a special case, an - application can fetch multiple rows at once into an array host - variable; see .) + (see for details). (As a special case, an + application can fetch multiple rows at once into an + .) @@ -512,3 +511,3 @@ EXEC SQL SHOW search_path INTO :var; - host variables, that is, they refer to - variables in the C program. They are explained in . + , that is, they refer to + variables in the C program. @@ -736,2 +735 @@ EXEC SQL DEALLOCATE PREPARE name; - applications is the use of SQL descriptors, described - in . + applications is through . @@ -902 +900 @@ do - accessed through special library functions; see + accessed through special library functions, as described in @@ -1092,2 +1090,2 @@ struct varchar_var { int len; char arr[180]; } var; - the pgtypes library. The pgtypes library, described in detail - in contains basic functions to deal + the pgtypes library. contains basic + functions to deal @@ -1101,2 +1099 @@ struct varchar_var { int len; char arr[180]; } var; - more details about pgtypes library functions, - see . + more details, see . @@ -1152,2 +1149,2 @@ ts = 2010-06-27 18:03:56.949343 - PGTYPESdate_to_asc() function. For more details about the - pgtypes library functions, see . + PGTYPESdate_to_asc() function. For more details, + see . @@ -1207,2 +1204 @@ EXEC SQL END DECLARE SECTION; - variable using the pgtypes library functions. For more details - about the pgtypes library functions, + variable using the pgtypes library functions. For more details, @@ -1314,3 +1310,2 @@ struct bytea_var { int len; char arr[180]; } var; - is a way to store some text string in char[] - or VARCHAR[], as - explained in . The second use case is to + is a way to store some text string with . The + second use case is to @@ -2037,2 +2032 @@ EXEC SQL EXECUTE mystmt INTO :v1, :v2, :v3 USING 37; - (See for more details about the - cursor.) + (See .) @@ -2115,3 +2109,3 @@ PGTYPESchar_free(out); - The numeric type offers to do calculations with arbitrary precision. See - for the equivalent type in the - PostgreSQL server. Because of the arbitrary precision this + offers calculations with arbitrary + precision. + Because of the arbitrary precision this @@ -2441 +2435 @@ int PGTYPESnumeric_from_decimal(decimal *src, numeric *dst); - date. See for the equivalent type in the + date; see for equivalent types in the @@ -2919,2 +2913,3 @@ int PGTYPESdate_defmt_asc(date *d, char *fmt, char *str); - type timestamp. See for the equivalent - type in the PostgreSQL server. + type timestamp; see for equivalent types + in the + PostgreSQL server. @@ -3449,2 +3444,3 @@ int PGTYPEStimestamp_sub_interval(timestamp *tin, interval *span, timestamp *tou - type interval. See for the equivalent - type in the PostgreSQL server. + type interval; see for equivalent types + in the + PostgreSQL server. @@ -3542,2 +3538,2 @@ int PGTYPESinterval_copy(interval *intvlsrc, interval *intvldest); - There are a lot of other functions that deal with the decimal type in the - Informix compatibility mode described in SQL keyword produces SQLDA Descriptor Areas, - see . + the SQL keyword produces + . @@ -5197 +5193 @@ sqlstate: 42P01 - SQLSTATE error codes; therefore a high degree + ; therefore a high degree @@ -5199,2 +5195 @@ sqlstate: 42P01 - throughout all applications. For further information see - . + throughout all applications. @@ -5220,2 +5215,2 @@ sqlstate: 42P01 - it is many-to-many), so you should consult the global - SQLSTATE listing in + it is many-to-many), so you should consult + @@ -6045 +6040,2 @@ ECPG = ecpg - See and libpq's for details about the returned status codes. + See and libpq's + for details. @@ -6077,2 +6073,2 @@ ECPG = ecpg - . For information about the large - object function interface, see . + . For more information, see + . @@ -6205,5 +6201,4 @@ main(void) - A safe way to use the embedded SQL code in a C++ application is - hiding the ECPG calls in a C module, which the C++ application code - calls into to access the database, and linking that together with - the rest of the C++ code. See - about that. + describes a safe way to use embedded SQL + code in a C++ application: hiding the ECPG calls in a C module, which the + C++ application code calls into to access the database, and linking that + together with the rest of the C++ code. diff --git a/doc/src/sgml/event-trigger.sgml b/doc/src/sgml/event-trigger.sgml index c10627554bd..07ccb4d8af1 100644 --- a/doc/src/sgml/event-trigger.sgml +++ b/doc/src/sgml/event-trigger.sgml @@ -61,2 +61,2 @@ - For an example on how to use the login event trigger, - see . + For an example, see + . diff --git a/doc/src/sgml/extend.sgml b/doc/src/sgml/extend.sgml index 63c5ec6d1eb..e60c3e6af30 100644 --- a/doc/src/sgml/extend.sgml +++ b/doc/src/sgml/extend.sgml @@ -43 +43 @@ - packages of related objects (starting in ) + @@ -139 +139 @@ - Enumerated (enum) types can be considered as a subcategory of base + can be considered as a subcategory of base @@ -142 +141,0 @@ - Refer to for more information. @@ -156 +155,2 @@ - Arrays can hold multiple values that are all of the same type. An array + can hold multiple values that are all of the same + type. An array @@ -160,2 +160 @@ - one-dimensional arrays. Refer to for more - information. + one-dimensional arrays. @@ -165 +164 @@ - Composite types, or row types, are created whenever the user + , or row types, are created whenever the user @@ -171,2 +170 @@ - record of field values. Refer to - for more information. + record of field values. @@ -178,2 +176,2 @@ - a few built-in ones exist. Refer to - for more information. + a few built-in ones exist. For more information, see + . @@ -190 +188 @@ - underlying type would allow. Domains are created using + underlying type would allow. are created using @@ -192 +189,0 @@ - Refer to for more information. @@ -233,2 +230,3 @@ - types, which are used to declare polymorphic - functions. This powerful feature allows a single function + types, which are used to declare + . This powerful feature + allows a single function @@ -238,2 +236 @@ - . Some examples of - their use appear in . + . @@ -278,2 +275 @@ - Indicates that a function accepts any enum data type - (see ) + Indicates that a function accepts any @@ -286,2 +282 @@ - Indicates that a function accepts any range data type - (see ) + Indicates that a function accepts any @@ -445,2 +440,2 @@ - selected following the same rules as for UNION and - related constructs (see ). + selected following the same rules as for + . @@ -497,3 +492,3 @@ RETURNS anycompatible AS ... - A variadic function (one taking a variable number of arguments, as in - ) can be - polymorphic: this is accomplished by declaring its last parameter as + A variadic function (as in + ) + can be polymorphic: this is accomplished by declaring its last parameter as @@ -808 +803,2 @@ RETURNS anycompatible AS ... - An extension is relocatable if it is possible to move + An extension supports if + it is possible to move @@ -812 +807,0 @@ RETURNS anycompatible AS ... - See for more information. @@ -821 +816,2 @@ RETURNS anycompatible AS ... - This parameter can only be set for non-relocatable extensions. + This parameter can only be set for non-relocatable extensions + (see ). @@ -826 +821,0 @@ RETURNS anycompatible AS ... - See for more information. @@ -858,2 +853,2 @@ RETURNS anycompatible AS ... - rather than being loaded via CREATE EXTENSION (see example - script in ). + rather than being loaded via CREATE EXTENSION (see + ). @@ -1261,4 +1256,3 @@ SELECT * FROM pg_extension_update_paths('extension_name below, and advice - about writing installation scripts securely is provided in - . + and + provide advice on + writing extension code and installation scripts securely, respectively. @@ -1913 +1907,2 @@ make VPATH=/path/to/extension/source/tree install - TAP_TESTS enables the use of TAP tests. Data from each + TAP_TESTS enables the use of + . Data from each @@ -1915 +1909,0 @@ make VPATH=/path/to/extension/source/tree install - See also for more details. diff --git a/doc/src/sgml/external-projects.sgml b/doc/src/sgml/external-projects.sgml index 50872dfd88e..de11d575cf5 100644 --- a/doc/src/sgml/external-projects.sgml +++ b/doc/src/sgml/external-projects.sgml @@ -118 +118 @@ - contains several extensions, which are described in + contains several modules described in diff --git a/doc/src/sgml/fdwhandler.sgml b/doc/src/sgml/fdwhandler.sgml index 8685a078c52..a2e1e082c56 100644 --- a/doc/src/sgml/fdwhandler.sgml +++ b/doc/src/sgml/fdwhandler.sgml @@ -59,2 +59,2 @@ - callable at the SQL level. The callback functions are described in - . + callable at the SQL level. See for + details. @@ -1154,2 +1154,2 @@ ExecForeignTruncate(List *rels, - If an FDW wishes to support late row locking (as described - in ), it must provide the following + If an FDW wishes to support , it must + provide the following @@ -2063 +2063 @@ GetForeignServerByName(const char *name, bool missing_ok); - rather than using the row locking callbacks described in + rather than using the callbacks described in diff --git a/doc/src/sgml/features.sgml b/doc/src/sgml/features.sgml index 1abe6ccd3d5..d886e41e40c 100644 --- a/doc/src/sgml/features.sgml +++ b/doc/src/sgml/features.sgml @@ -424,2 +424,2 @@ - types, it may be necessary to use data type formatting functions (such - as those in ) explicitly to + types, it may be necessary to use the functions in + explicitly to diff --git a/doc/src/sgml/func/func-admin.sgml b/doc/src/sgml/func/func-admin.sgml index 0eae1c1f616..3f7e360f47e 100644 --- a/doc/src/sgml/func/func-admin.sgml +++ b/doc/src/sgml/func/func-admin.sgml @@ -993,2 +993 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - - for information about the underlying features. + . @@ -1049,2 +1048 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - possible with the streaming-replication protocol — - see . The optional third + possible with . The optional third @@ -1500,2 +1498,3 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - primary at the start of the function call are synchronized. See - for details. + primary at the start of the function call are synchronized, + as described in + . @@ -1599,2 +1598 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - for more information about - TOAST. + for more information. @@ -1665,2 +1663,2 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - fsm returns the size of the Free Space Map - (see ) associated with the relation. + fsm returns the size of the + associated with the relation. @@ -1671,2 +1669,2 @@ postgres=# SELECT '0/0'::pg_lsn + pd.segment_number * ps.setting::int + :offset - vm returns the size of the Visibility Map - (see ) associated with the relation. + vm returns the size of the + associated with the relation. @@ -2498,3 +2496 @@ SELECT pg_size_pretty(sum(pg_relation_size(relid))) AS total_size - See and - for details about the pending list and fastupdate - option. + See and . @@ -2878,2 +2874,2 @@ SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8'); - The functions shown in - manage advisory locks. For details about proper use of these functions, + shows the available + functions. For details about proper use of these functions, diff --git a/doc/src/sgml/func/func-aggregate.sgml b/doc/src/sgml/func/func-aggregate.sgml index 8b5eaeb2e94..d035d76dc6e 100644 --- a/doc/src/sgml/func/func-aggregate.sgml +++ b/doc/src/sgml/func/func-aggregate.sgml @@ -11,12 +11,10 @@ - from a set of input values. The built-in general-purpose aggregate - functions are listed in - while statistical aggregates are in . - The built-in within-group ordered-set aggregate functions - are listed in - while the built-in within-group hypothetical-set ones are in . Grouping operations, - which are closely related to aggregate functions, are listed in - . - The special syntax considerations for aggregate - functions are explained in . + from a set of input values. Built-in aggregate functions are + listed in ; statistical + ones in ; + within-group ordered-set ones in ; and within-group + hypothetical-set ones in . + covers operations + closely related to aggregate functions. + See for syntax details. @@ -684,2 +682,2 @@ - ORDER BY clause within the aggregate call, as shown in - . + ORDER BY clause within the aggregate call (see + ). @@ -1240,3 +1238,3 @@ SELECT count(*) FROM sometable; - is associated with a - window function of the same name defined in - . In each case, the aggregate's result + is associated with a window + function of the same name in . In each + case, the aggregate's result @@ -1381 +1379 @@ SELECT count(*) FROM sometable; - grouping sets (see ) to distinguish + to distinguish diff --git a/doc/src/sgml/func/func-array.sgml b/doc/src/sgml/func/func-array.sgml index 7f162bd7670..dc7cae84760 100644 --- a/doc/src/sgml/func/func-array.sgml +++ b/doc/src/sgml/func/func-array.sgml @@ -140,2 +140,2 @@ - See for more details about array operator - behavior. See for more details about + See . See for more + details about @@ -147,2 +147 @@ - available for use with array types. See - for more information and examples of the use of these functions. + available for use with array types. See . @@ -643,2 +642,2 @@ - See also about the aggregate - function array_agg for use with arrays. + See also , including + array_agg, for use with arrays. diff --git a/doc/src/sgml/func/func-binarystring.sgml b/doc/src/sgml/func/func-binarystring.sgml index dc6b7e57ea7..b2840d7d029 100644 --- a/doc/src/sgml/func/func-binarystring.sgml +++ b/doc/src/sgml/func/func-binarystring.sgml @@ -666,2 +666 @@ - (see for - available conversions). + (see ). @@ -688,2 +687 @@ - (see for - available conversions). + (see ). @@ -709,2 +707 @@ - (see for - available conversions). + (see ). @@ -904 +901 @@ cast(-1234 AS bytea) \xfffffb2e - See also the aggregate function string_agg in + See also string_agg in diff --git a/doc/src/sgml/func/func-comparisons.sgml b/doc/src/sgml/func/func-comparisons.sgml index 6a6e0bd4019..c534e3ddb19 100644 --- a/doc/src/sgml/func/func-comparisons.sgml +++ b/doc/src/sgml/func/func-comparisons.sgml @@ -213 +213 @@ AND - as described in . + See . @@ -289,3 +289,3 @@ AND - results of two row constructors (as in - ) or comparing a row constructor - to the output of a subquery (as in ). + results of two row constructors (see ) + or comparing a row constructor + to the output of a subquery (see ). @@ -311,2 +311,2 @@ AND - IS [ NOT ] DISTINCT FROM for row constructors (see - ). + IS [ NOT ] DISTINCT FROM for + . @@ -331,2 +331,2 @@ AND - purposes such as replication and B-Tree deduplication (see ). They are not intended to be + purposes such as replication and . They + are not intended to be diff --git a/doc/src/sgml/func/func-datetime.sgml b/doc/src/sgml/func/func-datetime.sgml index 39dddde4fe1..e6956a49f98 100644 --- a/doc/src/sgml/func/func-datetime.sgml +++ b/doc/src/sgml/func/func-datetime.sgml @@ -10 +10 @@ - *, etc.). For formatting functions, refer to + *, etc.). For more information, refer to @@ -12,2 +12 @@ - the background information on date/time data types from . + the background information on . @@ -371,2 +370,2 @@ - Current date and time (changes during statement execution); - see + (changes during statement + execution) @@ -389 +388 @@ - Current date; see + @@ -420,2 +419 @@ - Current time of day, with limited precision; - see + , with limited precision @@ -438,2 +436,2 @@ - Current date and time (start of current transaction); - see + (start of current + transaction) @@ -453,2 +451,2 @@ - Current date and time (start of current transaction), with limited precision; - see + (start of current + transaction), with limited precision @@ -507,2 +505,2 @@ - Get timestamp subfield (equivalent to extract); - see + Get timestamp subfield (equivalent to + ) @@ -522,2 +520,2 @@ - Get interval subfield (equivalent to extract); - see + Get interval subfield (equivalent to + ) @@ -753,2 +751 @@ - Current time of day, with limited precision; - see + , with limited precision @@ -771,2 +768,2 @@ - Current date and time (start of current transaction); - see + (start of current + transaction) @@ -922,2 +919,2 @@ - Current date and time (start of current transaction); - see + (start of current + transaction) @@ -976,2 +973,2 @@ - Current date and time (start of current statement); - see + (start of current + statement) @@ -994,3 +991,3 @@ - Current date and time - (like clock_timestamp, but as a text string); - see + + (like clock_timestamp, but as a text + string) @@ -1013,2 +1010,2 @@ - Current date and time (start of current transaction); - see + (start of current + transaction) @@ -1388 +1385 @@ SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); - The Julian Date corresponding to the + The corresponding to the @@ -1390,2 +1387 @@ SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02'); - that are not local midnight result in a fractional value. See - for more information. + that are not local midnight result in a fractional value. @@ -1636,2 +1632 @@ SELECT EXTRACT(MINUTES FROM INTERVAL '80 minutes'); - for computational processing. For formatting date/time values for - display, see . + for computational processing. See . diff --git a/doc/src/sgml/func/func-enum.sgml b/doc/src/sgml/func/func-enum.sgml index 6227afe4057..5709c2f95c6 100644 --- a/doc/src/sgml/func/func-enum.sgml +++ b/doc/src/sgml/func/func-enum.sgml @@ -5 +5 @@ - For enum types (described in ), + For , diff --git a/doc/src/sgml/func/func-event-triggers.sgml b/doc/src/sgml/func/func-event-triggers.sgml index 9f3f51e9f51..9adce923803 100644 --- a/doc/src/sgml/func/func-event-triggers.sgml +++ b/doc/src/sgml/func/func-event-triggers.sgml @@ -10,2 +10 @@ - For more information about event triggers, - see . + For more information, see . diff --git a/doc/src/sgml/func/func-info.sgml b/doc/src/sgml/func/func-info.sgml index 00f64f50ceb..44f133a1c00 100644 --- a/doc/src/sgml/func/func-info.sgml +++ b/doc/src/sgml/func/func-info.sgml @@ -387,2 +387 @@ - Returns true if a JIT compiler extension is - available (see ) and the + Returns true if is available and the @@ -470,2 +469 @@ - for more information about - serializable and deferrable transactions. + . @@ -589,2 +587 @@ - (See for more information about - privileges.) + (See for more information.) @@ -964,2 +961 @@ SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute'); - representation of access privileges. See - for information about how to read access privilege values. + representation of access privileges. See . @@ -1077,2 +1073,2 @@ SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute'); - ACL entry is null. (The default access privileges - are described in .) + ACL entry is null. (The defaults are described in + .) @@ -1737,2 +1733 @@ SELECT pg_type_is_visible('myschema.widget'::regtype); - for passing to the sequence functions (see - ). + for passing to . @@ -2858,3 +2853,3 @@ acl | {postgres=arwdDxtm/postgres,foo=r/postgres} - linkend="transaction-id"/> for details. If executed in a - subtransaction, this will return the top-level transaction ID; - see for details. + linkend="transaction-id"/> for details. If executed in + , this will return the top-level transaction + ID. @@ -2923,2 +2918 @@ acl | {postgres=arwdDxtm/postgres,foo=r/postgres} - subtransaction IDs are not shown; see - for details. + are not shown. @@ -2979,2 +2973 @@ acl | {postgres=arwdDxtm/postgres,foo=r/postgres} - a subtransaction ID (subxid); see for - details. + (subxid). @@ -2998 +2991 @@ acl | {postgres=arwdDxtm/postgres,foo=r/postgres} - keysh correspond to the row-level locks + keysh correspond to @@ -3001 +2994 @@ acl | {postgres=arwdDxtm/postgres,foo=r/postgres} - respectively, as described in . Two + respectively. Two diff --git a/doc/src/sgml/func/func-json.sgml b/doc/src/sgml/func/func-json.sgml index 3d97e2b5375..aa60819a6bd 100644 --- a/doc/src/sgml/func/func-json.sgml +++ b/doc/src/sgml/func/func-json.sgml @@ -73,3 +73,2 @@ - . For details on JSON types - supported in PostgreSQL, - see . + . For more information, see + . @@ -83,2 +82 @@ - are available for use with JSON data types (see ). + are available for use with . @@ -90,6 +88,6 @@ - See also for the aggregate - function json_agg which aggregates record - values as JSON, the aggregate function - json_object_agg which aggregates pairs of values - into a JSON object, and their jsonb equivalents, - jsonb_agg and jsonb_object_agg. + See also for + json_agg, which aggregates record + values as JSON, json_object_agg, which aggregates + pairs of values into a JSON object, and their jsonb + equivalents, jsonb_agg and + jsonb_object_agg. @@ -244,2 +242,2 @@ - Some further operators exist only for jsonb, as shown - in . + exist only for + jsonb. @@ -276 +274 @@ - (See for details about containment.) + (See .) @@ -1994,3 +1992 @@ SELECT '{ - More examples of using jsonpath operators - and methods within path expressions appear below in - . + More examples appear in . @@ -3318 +3314 @@ $.* ? (@ like_regex "^\\d+$") - SQL/JSON functions JSON_EXISTS(), + JSON_EXISTS(), diff --git a/doc/src/sgml/func/func-logical.sgml b/doc/src/sgml/func/func-logical.sgml index 65e50e65a81..0375bb782ed 100644 --- a/doc/src/sgml/func/func-logical.sgml +++ b/doc/src/sgml/func/func-logical.sgml @@ -143,2 +143 @@ - linkend="syntax-express-eval"/> for more information about the - order of evaluation of subexpressions.) + linkend="syntax-express-eval"/>.) diff --git a/doc/src/sgml/func/func-matching.sgml b/doc/src/sgml/func/func-matching.sgml index ae1dff66722..29d495e3744 100644 --- a/doc/src/sgml/func/func-matching.sgml +++ b/doc/src/sgml/func/func-matching.sgml @@ -100,2 +100,2 @@ - LIKE pattern matching supports nondeterministic - collations (see ), such as + LIKE pattern matching supports +, such as @@ -1165 +1165 @@ regexp_substr('ABCDEFGHI', '(c..)(...)', 1, 1, 'i', 2) - a bracket expression, + a bracket expression, @@ -1181 +1181 @@ regexp_substr('ABCDEFGHI', '(c..)(...)', 1, 1, 'i', 2) - is an escape, see + is diff --git a/doc/src/sgml/func/func-math.sgml b/doc/src/sgml/func/func-math.sgml index 9dcf97e7c9e..0cf595222cb 100644 --- a/doc/src/sgml/func/func-math.sgml +++ b/doc/src/sgml/func/func-math.sgml @@ -1153,3 +1153,3 @@ - The random() and random_normal() - functions listed in and - use a + random() and random_normal() + (listed in and + ) use a diff --git a/doc/src/sgml/func/func-range.sgml b/doc/src/sgml/func/func-range.sgml index 3c5a34796a1..a6a49542cd3 100644 --- a/doc/src/sgml/func/func-range.sgml +++ b/doc/src/sgml/func/func-range.sgml @@ -5 +5 @@ - See for an overview of range types. + See . diff --git a/doc/src/sgml/func/func-srf.sgml b/doc/src/sgml/func/func-srf.sgml index 34a45971aad..cf76e1641e9 100644 --- a/doc/src/sgml/func/func-srf.sgml +++ b/doc/src/sgml/func/func-srf.sgml @@ -11,2 +11,2 @@ - The most widely used functions in this class are series generating - functions, as detailed in and + The most widely used functions in this class are + and diff --git a/doc/src/sgml/func/func-string.sgml b/doc/src/sgml/func/func-string.sgml index 0786573d7be..c43b27b8e32 100644 --- a/doc/src/sgml/func/func-string.sgml +++ b/doc/src/sgml/func/func-string.sgml @@ -544,3 +544,3 @@ - There are also pattern-matching operators, which are described in - , and operators for full-text - search, which are described in . + There are also operators, and operators + for + . @@ -677,2 +677,2 @@ - Formats arguments according to a format string; - see . + Formats arguments according to a + string. @@ -1580,3 +1580,2 @@ - This function provides a (non-standard) alternative to string - constants with Unicode escapes (see ). + This function provides a (non-standard) alternative to + . @@ -1612 +1611 @@ - See also the aggregate function string_agg in + See also string_agg in diff --git a/doc/src/sgml/func/func-subquery.sgml b/doc/src/sgml/func/func-subquery.sgml index f954f3bf133..3fab45374ff 100644 --- a/doc/src/sgml/func/func-subquery.sgml +++ b/doc/src/sgml/func/func-subquery.sgml @@ -130 +130 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - as described in . + See . @@ -186 +186 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - as described in . + See . @@ -251 +251 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - as described in . + See . @@ -267,2 +267 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - See for details about the meaning - of a row constructor comparison. + See . @@ -307 +306 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - as described in . + See . @@ -323,2 +322 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - See for details about the meaning - of a row constructor comparison. + See . @@ -342 +340 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - as described in . + See . @@ -351,2 +349 @@ WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2); - See for details about the meaning - of a row constructor comparison. + See . diff --git a/doc/src/sgml/func/func-textsearch.sgml b/doc/src/sgml/func/func-textsearch.sgml index 290ad81d697..3ac2769bd13 100644 --- a/doc/src/sgml/func/func-textsearch.sgml +++ b/doc/src/sgml/func/func-textsearch.sgml @@ -19,3 +19 @@ - for full text searching. See for a detailed - explanation of PostgreSQL's text search - facility. + for full text searching. See . diff --git a/doc/src/sgml/func/func-uuid.sgml b/doc/src/sgml/func/func-uuid.sgml index 2638e2bf855..7d5e301448f 100644 --- a/doc/src/sgml/func/func-uuid.sgml +++ b/doc/src/sgml/func/func-uuid.sgml @@ -176,2 +176 @@ - See for details on the data type - uuid in PostgreSQL. + See . diff --git a/doc/src/sgml/func/func-window.sgml b/doc/src/sgml/func/func-window.sgml index bb41387f873..adeb5b0be6f 100644 --- a/doc/src/sgml/func/func-window.sgml +++ b/doc/src/sgml/func/func-window.sgml @@ -10 +10 @@ - Window functions provide the ability to perform + provide the ability to perform @@ -12,3 +12 @@ - row. See for an introduction to this - feature, and for syntax - details. + row; see for syntax details. @@ -27,2 +25 @@ - can be used as a window function; see - for a list of the built-in aggregates. + can be used as a window function; see . diff --git a/doc/src/sgml/func/func-xml.sgml b/doc/src/sgml/func/func-xml.sgml index 511bc90852a..8d1f4702e8c 100644 --- a/doc/src/sgml/func/func-xml.sgml +++ b/doc/src/sgml/func/func-xml.sgml @@ -12,2 +12,2 @@ - linkend="datatype-xml"/> for information about the xml - type. The function-like expressions xmlparse + linkend="datatype-xml"/> for more information. The function-like expressions + xmlparse @@ -402,2 +402 @@ SELECT xmlroot(xmlparse(document 'abc'), - See for additional information - about aggregate functions. + See . @@ -536,2 +535 @@ SELECT xmlexists('//town[text() = ''Toronto'']' PASSING BY VALUE 'T - expression, as discussed in - . + expression (see ). @@ -794,3 +792,2 @@ SELECT xpath_exists('/my:a/text()', 'testPostgreSQL allows only XPath 1.0 - expressions, as discussed in - . + but PostgreSQL allows only XPath 1.0 expressions + (see ). @@ -888 +885 @@ SELECT xpath_exists('/my:a/text()', 'test. + standard (see ). diff --git a/doc/src/sgml/fuzzystrmatch.sgml b/doc/src/sgml/fuzzystrmatch.sgml index bcadc440e39..b22c0fd394d 100644 --- a/doc/src/sgml/fuzzystrmatch.sgml +++ b/doc/src/sgml/fuzzystrmatch.sgml @@ -181,2 +181,2 @@ SELECT daitch_mokotoff('Schwartzenegger'); - can be considered a match. A GIN index may - be used for efficiency, see and this example: + can be considered a match. A may + be used for efficiency, as shown in this example: @@ -202,2 +202,2 @@ SELECT * FROM s WHERE daitch_mokotoff(nm) && daitch_mokotoff('Jens'); - For indexing and matching of any number of names in any order, Full Text - Search features can be used. See and this + For indexing and matching of any number of names in any order, use + , as shown in this @@ -241,2 +241,2 @@ SELECT * FROM s WHERE soundex_tsvector(nm) @@ soundex_tsquery('Jameson John'); - an expression. A stored generated column can be used for this; see - . + an expression. A stored generated column can be used for this. + See for more information. diff --git a/doc/src/sgml/gin.sgml b/doc/src/sgml/gin.sgml index 82410b1fbdf..27a8a16739f 100644 --- a/doc/src/sgml/gin.sgml +++ b/doc/src/sgml/gin.sgml @@ -72 +72 @@ - (Some of the optional modules described in + (Some of the optional modules in @@ -195 +195 @@ - operator class (see ). + operator class, as defined in . @@ -443 +443 @@ - To support partial match queries, an operator class must + To support , an operator class must @@ -446,2 +446 @@ - parameter when a partial-match query is encountered. See - for details. + parameter when a partial-match query is encountered. diff --git a/doc/src/sgml/gist.sgml b/doc/src/sgml/gist.sgml index 3f1a01f381f..3a51555c000 100644 --- a/doc/src/sgml/gist.sgml +++ b/doc/src/sgml/gist.sgml @@ -50 +50 @@ - (Some of the optional modules described in + (Some of the optional modules in @@ -1211,3 +1211,3 @@ my_sortsupport(PG_FUNCTION_ARGS) - This support function corresponds to the index access method callback - function amtranslatecmptype (see ). The + This support function corresponds to the + amtranslatecmptype + callback function in . The diff --git a/doc/src/sgml/glossary.sgml b/doc/src/sgml/glossary.sgml index b881ae71198..6c77a697963 100644 --- a/doc/src/sgml/glossary.sgml +++ b/doc/src/sgml/glossary.sgml @@ -1894,2 +1894,2 @@ - exist in schema information_schema - (see ) that expose some + exist in + that expose some @@ -2060,2 +2060,2 @@ - considered together as a single 64-bit value; see for more details. + considered together as a single 64-bit value; see + . diff --git a/doc/src/sgml/high-availability.sgml b/doc/src/sgml/high-availability.sgml index 6d9636bd125..dcf3b34a124 100644 --- a/doc/src/sgml/high-availability.sgml +++ b/doc/src/sgml/high-availability.sgml @@ -101,3 +101,4 @@ - Using a network file system is also possible, though care must be - taken that the file system has full POSIX behavior (see ). One significant limitation of this + Using is also possible, though care + must be + taken that the file system has full POSIX behavior. One + significant limitation of this @@ -153,4 +154,3 @@ protocol to make nodes agree on a serializable transactional order. - A standby server can be implemented using file-based log shipping - () or streaming physical replication (see - ), or a combination of both. For - information on hot standby, see . + A standby server can be implemented using or + , or a combination of both. For + more information, see . @@ -171,3 +171,3 @@ protocol to make nodes agree on a serializable transactional order. - to flow in multiple directions. For more information on logical - replication, see . Through the - logical decoding interface (), + to flow in multiple directions. For more information, see + . Through + , @@ -524,3 +524,3 @@ protocol to make nodes agree on a serializable transactional order. - Record-based log shipping is more granular and streams WAL changes - incrementally over a network connection (see ). + Record-based is more granular and + transfers WAL changes + incrementally over a network connection. @@ -538 +538 @@ protocol to make nodes agree on a serializable transactional order. - Streaming replication (see ) + @@ -551,2 +551,2 @@ protocol to make nodes agree on a serializable transactional order. - it is called a hot standby server. See - for more information. + it is called a hot standby server (see + ). @@ -667,3 +667,3 @@ protocol to make nodes agree on a serializable transactional order. - Set up continuous archiving on the primary to an archive directory - accessible from the standby, as described - in . The archive location should be + Set up on the primary to an archive + directory + accessible from the standby. The archive location should be @@ -688 +688 @@ protocol to make nodes agree on a serializable transactional order. - Take a base backup as described in + Use @@ -807,2 +807,2 @@ archive_cleanup_command = 'pg_archivecleanup /path/to/archive "%r"' - To use streaming replication, set up a file-based log-shipping standby - server as described in . The step that + To use streaming replication, set up . The + step that @@ -812 +812,2 @@ archive_cleanup_command = 'pg_archivecleanup /path/to/archive "%r"' - and authentication options + and + options @@ -815 +816 @@ archive_cleanup_command = 'pg_archivecleanup /path/to/archive "%r"' - server (see ). + server. @@ -981,3 +982,3 @@ primary_conninfo = 'host=192.168.1.50 port=5432 user=foo password=foopass' - Slots can be created and dropped either via the streaming replication - protocol (see ) or via SQL - functions (see ). + Slots can be created and dropped either via + or via + . @@ -1043,2 +1044,2 @@ primary_slot_name = 'node_a_slot' - Cascading replication is currently asynchronous. Synchronous replication - (see ) settings have no effect on + Cascading replication is currently asynchronous. + settings have no effect on @@ -1555,2 +1556,2 @@ postgres=# WAIT FOR LSN '0/306EE20'; - If you have opted for logical replication slot synchronization (see - ), + If you have opted for + , @@ -1616,2 +1617,2 @@ postgres=# WAIT FOR LSN '0/306EE20'; - start of each transaction, depending on the current transaction isolation - level. For more details, see . + start of each transaction, depending on the current + . @@ -2400,3 +2401,2 @@ HINT: You can then restart the server after making the necessary configuration - The Serializable transaction isolation level is not yet available in hot - standby. (See and - for details.) + is not yet available in hot + standby (see also for details). diff --git a/doc/src/sgml/hstore.sgml b/doc/src/sgml/hstore.sgml index 780ee224dce..c8c807436b8 100644 --- a/doc/src/sgml/hstore.sgml +++ b/doc/src/sgml/hstore.sgml @@ -77,2 +77 @@ key => NULL - for more on the handling of string - constants. + for more information. diff --git a/doc/src/sgml/indexam.sgml b/doc/src/sgml/indexam.sgml index f48da318530..723cfe3d00a 100644 --- a/doc/src/sgml/indexam.sgml +++ b/doc/src/sgml/indexam.sgml @@ -32,2 +32,2 @@ - furthermore use the standard page layout described in , and most use the same format for index + furthermore use the standard , and most + use the same format for index @@ -88,2 +88,2 @@ - visible or callable at the SQL level. The support functions are described - in . + visible or callable at the SQL level. See + for details. @@ -657,2 +657,2 @@ amadjustmembers (Oid opfamilyoid, - index scanning are described more fully in , - below. An index access method can support plain index scans, + are described more fully below. An index + access method can support plain index scans, diff --git a/doc/src/sgml/indices.sgml b/doc/src/sgml/indices.sgml index 55f39b0df2f..7e09a1e9e6b 100644 --- a/doc/src/sgml/indices.sgml +++ b/doc/src/sgml/indices.sgml @@ -259 +259,2 @@ CREATE INDEX name ON table - GiST indexes are not a single kind of index, but rather an infrastructure + are not a single kind of index, but rather an + infrastructure @@ -278 +279 @@ CREATE INDEX name ON table - projects. For more information see . + projects. @@ -308 +309,2 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - SP-GiST indexes, like GiST indexes, offer an infrastructure that supports + , like GiST indexes, offer an infrastructure that + supports @@ -324 +325,0 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - For more information see . @@ -356 +357 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - Like GiST and SP-GiST, GIN can support + Like GiST and SP-GiST, can support @@ -374 +375 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - projects. For more information see . + projects. @@ -391 +392,2 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - BRIN indexes (a shorthand for Block Range INdexes) store summaries about + (a shorthand for Block Range INdexes) store summaries + about @@ -410 +411,0 @@ SELECT * FROM places ORDER BY location <-> point '(101,456)' LIMIT 10; - For more information see . @@ -1106,2 +1107,2 @@ CREATE INDEX mytable_cat_data ON mytable (category, data); - you should look into using partitioning instead (see - ). With that mechanism, the system + you should look into using instead. With + that mechanism, the system diff --git a/doc/src/sgml/information_schema.sgml b/doc/src/sgml/information_schema.sgml index 4be4f1ef1ef..e07f386f2c1 100644 --- a/doc/src/sgml/information_schema.sgml +++ b/doc/src/sgml/information_schema.sgml @@ -902 +902,2 @@ - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -3242,4 +3243,2 @@ ORDER BY c.ordinal_position; - generally, it is better to use the view - applicable_roles instead of this one; See - for details on - applicable_roles view. + generally, it is better to use the + view instead of this one. @@ -3889 +3888,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -5567 +5567,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -5987 +5988,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -6125 +6127,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -6327 +6330,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -6438 +6442,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -8342 +8347,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . @@ -8941,2 +8947,2 @@ ORDER BY c.ordinal_position; - extensions, are not shown here. For domains, - see instead. + extensions, are not shown here. For domain data types, + see . @@ -9545 +9551,2 @@ ORDER BY c.ordinal_position; - The specific name of the function. See for more information. + The specific name of the function, as documented in + . diff --git a/doc/src/sgml/install-binaries.sgml b/doc/src/sgml/install-binaries.sgml index 001c3c7be01..6dd13804772 100644 --- a/doc/src/sgml/install-binaries.sgml +++ b/doc/src/sgml/install-binaries.sgml @@ -13,2 +13,2 @@ - the recommended way to install PostgreSQL for users of the system. Building - from source (see ) is only recommended for + the recommended way to install PostgreSQL for users of the system. + is only recommended for diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index b345a105674..40a89049317 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -24,3 +24,3 @@ - The platforms that had received specific testing at the - time of release are described in - below. + The that had received specific testing + at the + time of release are described below. @@ -171 +171,4 @@ - The ICU library is used by default. If you don't want to use it then you must specify the option to configure. Using this option disables support for ICU collation features (see ). + The ICU library is used by default. If you don't want to use it then you + must specify the option to + configure. Using this option disables ICU + . @@ -466,2 +469 @@ su - postgres - has a large number of options, which are described in - . + accepts a large number of options; see . @@ -471,3 +473,2 @@ su - postgres - Also, configure responds to certain environment - variables, as described in . - These provide additional ways to customize the configuration. + Also, provide additional ways to + customize the configuration. @@ -551,3 +552 @@ build-postgresql: - , - which has instructions about upgrading a - cluster. + . @@ -951 +950 @@ build-postgresql: - JIT compilation (see ). This + . This @@ -1273,2 +1272 @@ build-postgresql: - library, disabling the use of ICU collation features (see ). + library, disabling ICU . @@ -1601,3 +1599,2 @@ build-postgresql: - Enable tests using the Perl TAP tools. This requires a Perl - installation and the Perl module IPC::Run. - See for more information. + Enable (requires a Perl + installation and the Perl module IPC::Run). @@ -1627 +1624 @@ build-postgresql: - code coverage testing instrumentation. When run, they + instrumentation. When run, they @@ -1630,2 +1627 @@ build-postgresql: - See - for more information. This option is for use only with GCC + This option is for use only with GCC @@ -1658,2 +1654 @@ build-postgresql: - dynamic tracing tool DTrace. - See for more information. + tool DTrace. @@ -1689 +1684,2 @@ build-postgresql: - injection points in the server. Injection points allow to run + in the server. Injection + points allow to run @@ -1692,3 +1688,2 @@ build-postgresql: - in a controlled fashion. This option is disabled by default. See - for more details. This - option is intended to be used only by developers for testing. + in a controlled fashion. This option is disabled by default. + This option is intended to be used only by developers for testing. @@ -2153,3 +2148 @@ ninja - , - which has instructions about upgrading a - cluster. + . @@ -2436,2 +2429,2 @@ ninja install - library, enabling use of ICU collation features (see ). Defaults to auto and requires the + library, enabling ICU . Defaults to auto and + requires the @@ -2449 +2442 @@ ninja install - JIT compilation (see ). + . @@ -3171 +3164 @@ ninja install - Enable tests using the Perl TAP tools. Defaults to auto and requires + Enable . Defaults to auto and requires @@ -3173 +3165,0 @@ ninja install - See for more information. @@ -3182 +3174,2 @@ ninja install - Enable additional test suites, which are not run by default because + Enable , which are not run by + default because @@ -3185,2 +3178 @@ ninja install - whitespace-separated list of tests to enable. See - for details. If the + whitespace-separated list of tests to enable. If the @@ -3198 +3190 @@ ninja install - code coverage testing instrumentation. When run, they + instrumentation. When run, they @@ -3201,2 +3193 @@ ninja install - See - for more information. This option is for use only with GCC + This option is for use only with GCC @@ -3216,2 +3207 @@ ninja install - dynamic tracing tool DTrace. - See for more information. + tool DTrace. @@ -3235 +3225,2 @@ ninja install - injection points in the server. Injection points allow to run + in the server. Injection + points allow to run @@ -3238,3 +3229,2 @@ ninja install - in a controlled fashion. This option is disabled by default. See - for more details. This - option is intended to be used only by developers for testing. + in a controlled fashion. This option is disabled by default. + This option is intended to be used only by developers for testing. @@ -3816,2 +3806,2 @@ configure ... LDFLAGS="-R /usr/sfw/lib:/opt/sfw/lib:/usr/local/lib" - PostgreSQL for Windows with Visual Studio can be built using Meson, as - described in . + PostgreSQL for Windows with Visual Studio can be built following + . diff --git a/doc/src/sgml/json.sgml b/doc/src/sgml/json.sgml index 8a2aad5935e..fd6d39146cf 100644 --- a/doc/src/sgml/json.sgml +++ b/doc/src/sgml/json.sgml @@ -20,2 +20,2 @@ - assorted JSON-specific functions and operators available for data stored - in these data types; see . + assorted available for data stored + in these data types. @@ -28,2 +28 @@ - also provides the jsonpath data type described in - . + also provides the . @@ -92,2 +91 @@ - Many of the JSON processing functions described - in will convert Unicode escapes to + Many of the will convert Unicode escapes to @@ -232,2 +230,2 @@ SELECT '{"reading": 1.230e-5}'::json, '{"reading": 1.230e-5}'::jsonb; - For the list of built-in functions and operators available for - constructing and processing JSON values, see . + lists the built-in functions and operators + for constructing and processing JSON values. @@ -396,3 +394,3 @@ SELECT doc->'site_name' FROM websites - The various containment and existence operators, along with all other - JSON operators and functions are documented - in . + covers the various containment and + existence + operators, along with all other JSON operators and functions. @@ -484,2 +482 @@ CREATE INDEX idxgintags ON api USING GIN ((jdoc -> 'tags')); - (More information on expression indexes can be found in .) + (See for more information.) @@ -845,2 +842 @@ UPDATE table_name SET jsonb_field[1]['a'] = '1'; - jsonpath operators and methods listed - in . + @@ -885,2 +881,2 @@ UPDATE table_name SET jsonb_field[1]['a'] = '1'; - vars of several JSON processing functions - (see ), or by + vars of + , or by diff --git a/doc/src/sgml/keywords.sgml b/doc/src/sgml/keywords.sgml index a7bf30c5046..e67ac027c85 100644 --- a/doc/src/sgml/keywords.sgml +++ b/doc/src/sgml/keywords.sgml @@ -68,2 +68,3 @@ - column labels without writing AS before them (as - described in ), there are a few + without writing AS + before them, + there are a few diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml index 7d3c3bb66d8..fef61cdf359 100644 --- a/doc/src/sgml/libpq.sgml +++ b/doc/src/sgml/libpq.sgml @@ -36 +36 @@ - Some short programs are included at the end of this chapter () to show how + at the end of this chapter show how @@ -121,2 +121 @@ PGconn *PQconnectdbParams(const char * const *keywords, - The currently recognized parameter key words are listed in - . + See for recognized parameters. @@ -144,2 +143,2 @@ PGconn *PQconnectdbParams(const char * const *keywords, - URI scheme designator. (More details on connection string formats - appear in .) Only the first + URI scheme designator. (See for + details on formats.) Only the first @@ -169,2 +168,2 @@ PGconn *PQconnectdbParams(const char * const *keywords, - default values. If an unset parameter's corresponding environment - variable (see ) is set, its value is + default values. If an unset parameter's corresponding + is set, its value is @@ -980,2 +979 @@ host=localhost port=5432 dbname=mydb connect_timeout=10 - The recognized parameter key words are listed in . + See for recognized parameters. @@ -1028,2 +1026,3 @@ postgresql:///mydb?host=localhost&port=5433 - All named parameters must match key words listed in - , except that for compatibility + All named parameters must match , + except that + for compatibility @@ -1216,2 +1215 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - is used to identify the connection in a password file (see - ). + is used to identify the connection in . @@ -1290,2 +1288 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - Specifies the name of the file used to store passwords - (see ). + Specifies the name of . @@ -2149,2 +2146 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - peer authentication method is implemented; see - . + method is implemented. @@ -2258 +2254 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - Kerberos service name to use when authenticating with GSSAPI. + Kerberos service name to use for . @@ -2260,2 +2256 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - configuration for Kerberos authentication to succeed. (See also - .) + configuration for Kerberos authentication to succeed. @@ -2344,2 +2339 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname - This option specifies the name of the per-user connection service file - (see ). + This option specifies the name of . @@ -4025,3 +4019,2 @@ ExecStatusType PQresultStatus(const PGresult *res); - query execution functions; results of this kind are instead passed - to the notice processor (see ). + query execution functions; results of this kind are instead passed to + . @@ -5629,3 +5622 @@ PGresult *PQgetResult(PGconn *conn); - is retrieving large query results a limited number of rows at a time. - This is discussed - in . + is . @@ -5720,2 +5711 @@ int PQisBusy(PGconn *conn); - can also attempt to cancel a command that is still being processed - by the server; see . But regardless of + can also attempt . But regardless of @@ -5991 +5981,2 @@ int PQflush(PGconn *conn); - queries in the pipeline; see . + queries in the pipeline. See + for more information. @@ -6412 +6403,2 @@ UPDATE mytable SET x = x + 1 WHERE id = 42; - When using pipeline mode, single-row or chunked mode needs to be + When using , single-row or chunked mode + needs to be @@ -6415 +6406,0 @@ UPDATE mytable SET x = x + 1 WHERE id = 42; - See for more information. @@ -9140,2 +9131,2 @@ myEventProc(PGEventId evtId, void *evtInfo, void *passThrough) - ps; instead consider using a password file - (see ). + ps; instead consider using + . @@ -9692,3 +9683,2 @@ user=admin - LDAP connection parameter lookup uses the connection service file - pg_service.conf (see ). A line in a + LDAP connection parameter lookup uses + (pg_service.conf). A line in a @@ -9766,5 +9756,5 @@ ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*) - PostgreSQL has native support for using SSL - connections to encrypt client/server communications using - TLS protocols for increased security. - See for details about the server-side - SSL functionality. + PostgreSQL has native support for + + using TLS protocols to encrypt client/server + communications + for increased security. @@ -9954,2 +9944 @@ ldap://ldap.acme.com/cn=dbserver,cn=hosts?pgconnectinfo?base?(objectclass=*) - For instructions on creating certificates, see . + See for instructions. diff --git a/doc/src/sgml/logical-replication.sgml b/doc/src/sgml/logical-replication.sgml index 9e7868487de..145e7407e2a 100644 --- a/doc/src/sgml/logical-replication.sgml +++ b/doc/src/sgml/logical-replication.sgml @@ -132,2 +132,3 @@ - data synchronization copy. (Row filters have no effect for - TRUNCATE. See ). + data synchronization copy. ( + have no effect for + TRUNCATE.) @@ -234,2 +235,3 @@ - activity and preserve necessary WAL (see ). Additional replication + activity and preserve necessary WAL. See for more information. Additional + replication @@ -242,2 +244,2 @@ - A logical replication subscription can be a standby for synchronous - replication (see ). The standby + A logical replication subscription can be a standby for + . The standby @@ -555,3 +557,3 @@ - These examples specify the standard logical decoding output plugin - (), - which is what the built-in logical replication uses. + These examples specify , + the standard logical decoding output plugin used by the built-in logical + replication. @@ -703,3 +705,4 @@ HINT: To initiate replication, you must manually create the replication slot, e - corresponding to the subscriptions can be synchronized to the standby server by - specifying failover = true when creating subscriptions. See - for details. + corresponding to the subscriptions can be synchronized via + to the + standby server by + specifying failover = true when creating subscriptions. @@ -1414 +1417,2 @@ Included in publications: - generated columns to be published, regardless of the publication parameter + to be published, regardless of + the publication parameter @@ -1416,2 +1420 @@ Included in publications: - publish_generated_columns. See - for details. + publish_generated_columns. @@ -1737,2 +1740,2 @@ Included in publications: - publications where the same table has been published with different column - lists. See . + publications where the same table has been published with different + . @@ -2376 +2379 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - Large objects (see ) are not replicated. + are not replicated. @@ -2426 +2429 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - streaming replication (see ). It is + . It is @@ -2428,2 +2431,2 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - processes. The walsender process starts logical decoding (described - in ) of the WAL and loads the standard + processes. The walsender process starts of + the WAL and loads the standard @@ -2432,2 +2435,2 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - from WAL to the logical replication protocol - (see ) and filters the data + from WAL to and filters the + data @@ -2504,3 +2507,3 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - the monitoring on a publication node is similar to monitoring of a - physical replication primary - (see ). + the monitoring on a publication node is similar to + of a physical replication + primary. @@ -2891,3 +2894,3 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - The logical replication restrictions apply to logical replication cluster - upgrades also. See for - details. + The apply to logical + replication cluster + upgrades also. @@ -2896,3 +2899,3 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - The prerequisites of publisher upgrade apply to logical replication - cluster upgrades also. See - for details. + The prerequisites of also + apply to logical replication cluster + upgrades. @@ -2901,3 +2904,3 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - The prerequisites of subscriber upgrade apply to logical replication - cluster upgrades also. See - for details. + The prerequisites of also + apply to logical replication cluster + upgrades. @@ -2922,3 +2925 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - Follow the steps specified in - to upgrade - a two-node logical replication cluster. + Follow . @@ -2929,3 +2930 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - Follow the steps specified in - to upgrade - a cascaded logical replication cluster. + Follow . @@ -2936,3 +2935,2 @@ CONTEXT: processing remote data for replication origin "pg_16395" during "INSER - Follow the steps specified in - - to upgrade a two-node circular logical replication cluster. + Follow + . diff --git a/doc/src/sgml/logicaldecoding.sgml b/doc/src/sgml/logicaldecoding.sgml index 6dc49108997..7246f7b8d3c 100644 --- a/doc/src/sgml/logicaldecoding.sgml +++ b/doc/src/sgml/logicaldecoding.sgml @@ -31,3 +31,3 @@ - Changes can be consumed either using the streaming replication protocol - (see and - ), or by calling functions + Changes can be consumed either using + (see also ), or by calling + functions @@ -150 +150,2 @@ postgres=# SELECT pg_drop_replication_slot('regression_slot'); - distribution. This requires that client authentication is set up to allow + distribution. This requires that + is set up to allow @@ -152,2 +153,2 @@ postgres=# SELECT pg_drop_replication_slot('regression_slot'); - (see ) and - that max_wal_senders is set sufficiently high to allow + and that max_wal_senders is set sufficiently high to + allow @@ -319,2 +320,3 @@ postgres=# SELECT * from pg_logical_slot_get_changes('regression_slot', NULL, NU - PostgreSQL can also use streaming replication slots - to maintain a standby server (see ), but + PostgreSQL can also use + slots + to maintain a standby server, but @@ -398 +400,2 @@ postgres=# SELECT * from pg_logical_slot_get_changes('regression_slot', NULL, NU - transaction ID wraparound (see ). + transaction ID wraparound. See for + more information. @@ -590 +593 @@ DETAIL: Synchronization could lead to data loss, because the remote slot needs - Synchronous replication (see ) is + is @@ -621 +624 @@ DETAIL: Synchronization could lead to data loss, because the remote slot needs - (see for details). + see . @@ -1433,2 +1436,2 @@ OutputPluginWrite(ctx, true); - prepare writing output, and one to write the output - (see ). + prepare writing output, and one for + . @@ -1448,2 +1451,2 @@ OutputPluginWrite(ctx, true); - replication. To do this, the streaming replication interface - (see ) must be used to stream out + replication. To do this, + must be used to stream out @@ -1553,3 +1556,3 @@ OutputPluginWrite(ctx, true); - Also, if streaming of two-phase commands is to be supported, then additional - callbacks must be provided. (See - for details). + Also, if is to be + supported, then additional + callbacks must be provided. diff --git a/doc/src/sgml/maintenance.sgml b/doc/src/sgml/maintenance.sgml index 4a21bdb5de7..fc9b25935ee 100644 --- a/doc/src/sgml/maintenance.sgml +++ b/doc/src/sgml/maintenance.sgml @@ -29,3 +29,2 @@ - table, etc.). The backup and recovery mechanisms available in - PostgreSQL are discussed at length in - . + table, etc.). in + PostgreSQL is discussed at length in that chapter. @@ -43,2 +42,2 @@ - Another task that might need periodic attention is log file management. - This is discussed in . + Another task that might need periodic attention is + . @@ -1024,2 +1023,2 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu - (and many other autovacuum control parameters) on a per-table basis; see - for more information. + (and many other autovacuum control parameters) via + . @@ -1033,2 +1032,2 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu - When multiple workers are running, the autovacuum cost delay parameters - (see ) are + When multiple workers are running, the autovacuum + parameters are diff --git a/doc/src/sgml/manage-ag.sgml b/doc/src/sgml/manage-ag.sgml index fe4cb4410cd..c4721cdfea3 100644 --- a/doc/src/sgml/manage-ag.sgml +++ b/doc/src/sgml/manage-ag.sgml @@ -48 +48 @@ - The older dblink module (see ) provides a similar capability. + The older provides a similar capability. @@ -59 +59,2 @@ - into separate schemas; this provides a modular structure with namespace + into separate ; this provides a modular + structure with namespace @@ -61 +61,0 @@ - More information about managing schemas is in . @@ -67,2 +67,3 @@ - In particular, the impact that having a shared WAL (see ) - has on backup and recovery options. While individual databases in the cluster + In particular, the impact that having a shared WAL has on backup and recovery + options (see ). While individual databases in the + cluster @@ -74,4 +75,3 @@ - Databases are created with the CREATE DATABASE command - (see ) and destroyed with the - DROP DATABASE command - (see ). + Databases are created with and destroyed + with + . @@ -139 +139 @@ CREATE DATABASE name; - Two additional databases, + Two , @@ -153,2 +153 @@ CREATE DATABASE name; - without any such site-local additions. More details - appear in . + without any such site-local additions. diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 08d5b824552..d49d11091b3 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -31,2 +31,2 @@ - discusses EXPLAIN - and other methods for understanding the behavior of an individual + discusses this and other methods for + understanding the behavior of an individual @@ -163 +163 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - details about setting configuration parameters.) + details.) @@ -230,2 +230,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - build custom views using the underlying cumulative statistics functions, as - discussed in . + build custom views using the underlying cumulative + . @@ -387,2 +387,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - ANALYZE, showing current progress. - See . + ANALYZE, showing current progress, as reported in + . @@ -395,2 +395,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - current progress. - See . + current progress, as reported in + . @@ -403,2 +403,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - VACUUM, showing current progress. - See . + VACUUM, showing current progress, as reported in + . @@ -411,2 +411,3 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - CLUSTER or VACUUM FULL, showing current progress. - See . + CLUSTER or VACUUM FULL, + showing current progress, as reported in + . @@ -427,2 +428,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - showing current progress. - See . + showing current progress, as reported in + . @@ -1115,2 +1116,2 @@ postgres 27093 0.0 0.0 30096 2752 ? Ss 11:34 0:00 postgres: ser - outcome defined in a test. See - for more details. This + outcome defined in a test (see + ). This @@ -4848,3 +4849,3 @@ description | Waiting for a newly initialized WAL file to reach durable storage - This can happen with queries that use certain SQL - constructs to search for rows matching any value out of a list or array of - multiple scalar values (see ). It + This can happen with queries that use + to search for rows matching any + value out of a list or array of scalar values. It @@ -4865,4 +4866,2 @@ description | Waiting for a newly initialized WAL file to reach durable storage - EXPLAIN ANALYZE outputs the total number of index - searches performed by each index scan node. See - for an example demonstrating how - this works. + outputs the total number of index + searches performed by each index scan node. @@ -6107 +6106 @@ FROM pg_stat_get_backend_idset() AS backendid; - Details of the pg_locks view appear in + Details of this view appear in @@ -6109,2 +6108 @@ FROM pg_stat_get_backend_idset() AS backendid; - For more information on locking and managing concurrency with - PostgreSQL, refer to . + For more information, refer to . @@ -6277,2 +6275,2 @@ FROM pg_stat_get_backend_idset() AS backendid; - Total time spent sleeping due to cost-based delay (see - ), in milliseconds + Total time spent sleeping due to + , in milliseconds @@ -8826 +8824,2 @@ if (TRACE_POSTGRESQL_TRANSACTION_START_ENABLED()) - there also might be a TOAST file associated with the table, + there also might be a file + associated with the table, @@ -8828 +8827 @@ if (TRACE_POSTGRESQL_TRANSACTION_START_ENABLED()) - table (see ). There will be one valid index + table. There will be one valid index @@ -8931,2 +8930 @@ ORDER BY relpages DESC; - systems by making use of tablespaces. See for more information about that. + systems by making use of . diff --git a/doc/src/sgml/mvcc.sgml b/doc/src/sgml/mvcc.sgml index 241caeb3593..94417be21e2 100644 --- a/doc/src/sgml/mvcc.sgml +++ b/doc/src/sgml/mvcc.sgml @@ -297,2 +297,4 @@ - made to a sequence (and therefore the counter of a - column declared using serial) are immediately visible + made using (and therefore the + counter of a + column declared using ) are immediately + visible @@ -300,2 +302 @@ - that made the changes aborts. See - and . + that made the changes aborts. @@ -887,2 +888 @@ ERROR: could not serialize access due to read/write dependencies among transact - system view. For more information on monitoring the status of the lock - manager subsystem, refer to . + system view. For more information, refer to . @@ -1621,2 +1621 @@ SELECT pg_advisory_lock(q.id) FROM - The functions provided to manipulate advisory locks are described in - . + See . @@ -1658 +1657 @@ SELECT pg_advisory_lock(q.id) FROM - As mentioned in , Serializable + As described in , these @@ -1698 +1697 @@ SELECT pg_advisory_lock(q.id) FROM - does not yet extend to hot standby mode () + does not yet extend to @@ -1867,2 +1866,2 @@ SELECT pg_advisory_lock(q.id) FROM - been added to hot standby replication targets (described in - ). The strictest isolation level currently + been added to replication targets. The + strictest isolation level currently diff --git a/doc/src/sgml/oauth-validators.sgml b/doc/src/sgml/oauth-validators.sgml index 8aad470a464..2dd68a94df2 100644 --- a/doc/src/sgml/oauth-validators.sgml +++ b/doc/src/sgml/oauth-validators.sgml @@ -17,3 +17,3 @@ - OAuth validator modules must at least consist of an initialization function - (see ) and the required callback for - performing validation (see ). + OAuth validator modules must at least consist of + + and . @@ -158,3 +158,2 @@ - Note that anonymous/pseudonymous login is possible as well, by enabling - usermap delegation; see - . + Note that anonymous/pseudonymous login is possible as well; + see . diff --git a/doc/src/sgml/oid2name.sgml b/doc/src/sgml/oid2name.sgml index 9340d7376aa..6c43caa8c31 100644 --- a/doc/src/sgml/oid2name.sgml +++ b/doc/src/sgml/oid2name.sgml @@ -223,2 +223,2 @@ - utilities, also uses the environment variables supported by - libpq (see ). + utilities, also uses the supported by + libpq. diff --git a/doc/src/sgml/pageinspect.sgml b/doc/src/sgml/pageinspect.sgml index 3a113439e1d..2ede38b8ed5 100644 --- a/doc/src/sgml/pageinspect.sgml +++ b/doc/src/sgml/pageinspect.sgml @@ -475,3 +475,3 @@ test=# SELECT itemoffset, ctid, itemlen, nulls, vars, data, dead, htid, tids[0:2 - For more details about the structure of B-tree indexes, see - . For more details about - deduplication and posting lists, see . For deduplication and posting lists, + see by default. See the discussion of + UNSAFE by default. See @@ -463 +463 @@ EXPLAIN SELECT * FROM pgbench_accounts WHERE filler LIKE '%x%'; - unable to generate a parallel plan for your query. See + unable to generate a parallel plan for your query, as discussed in @@ -465,2 +465 @@ EXPLAIN SELECT * FROM pgbench_accounts WHERE filler LIKE '%x%'; - for information on why this may be - the case. + . diff --git a/doc/src/sgml/passwordcheck.sgml b/doc/src/sgml/passwordcheck.sgml index 7ea32410463..fb7a70cfaf8 100644 --- a/doc/src/sgml/passwordcheck.sgml +++ b/doc/src/sgml/passwordcheck.sgml @@ -51,3 +51,3 @@ - It is more secure to use an external authentication method such as GSSAPI - (see ) than to rely on - passwords within the database. + It is more secure to use an external + method such as GSSAPI + than to rely on passwords within the database. diff --git a/doc/src/sgml/perform.sgml b/doc/src/sgml/perform.sgml index 604e8578a8d..509330e522c 100644 --- a/doc/src/sgml/perform.sgml +++ b/doc/src/sgml/perform.sgml @@ -134,2 +134,2 @@ EXPLAIN SELECT * FROM tenk1; - The costs are measured in arbitrary units determined by the planner's - cost parameters (see ). + The costs are measured in arbitrary units determined by + . @@ -937 +937 @@ EXPLAIN ANALYZE SELECT four, unique1 FROM tenk1 WHERE four BETWEEN 1 AND 3 AND u - tenk1_four_unique1_idx, a multi-column index on the + tenk1_four_unique1_idx, a composite index on the @@ -1422 +1422 @@ WHERE tablename = 'road'; - Further details about the planner's use of statistics can be found in + Further details can be found in @@ -2144 +2144 @@ SELECT * FROM x, y, a, b, c WHERE something AND somethingelse; - statistics. Note that if the autovacuum daemon is enabled, it might + statistics. Note that if is enabled, it might @@ -2146,2 +2146 @@ SELECT * FROM x, y, a, b, c WHERE something AND somethingelse; - - and for more information. + for more information. @@ -2249 +2248 @@ SELECT * FROM x, y, a, b, c WHERE something AND somethingelse; - and for more information. + and . diff --git a/doc/src/sgml/pgstatstatements.sgml b/doc/src/sgml/pgstatstatements.sgml index d753de5836e..d1442fe03d8 100644 --- a/doc/src/sgml/pgstatstatements.sgml +++ b/doc/src/sgml/pgstatstatements.sgml @@ -644,2 +644 @@ - The pg_stat_statements_info view, discussed below - in , + , discussed below, diff --git a/doc/src/sgml/planstats.sgml b/doc/src/sgml/planstats.sgml index e57867ba617..7e679f3a200 100644 --- a/doc/src/sgml/planstats.sgml +++ b/doc/src/sgml/planstats.sgml @@ -8,4 +8,3 @@ - linkend="using-explain"/> and to show some - additional details about how the planner uses the - system statistics to estimate the number of rows each part of a query might - return. This is a significant part of the planning process, + linkend="using-explain"/> and to show + how row count estimates are computed for each part of a query. + This is a significant part of the planning process, @@ -49,2 +48 @@ EXPLAIN SELECT * FROM tenk1; - How the planner determines the cardinality of tenk1 - is covered in , but is repeated here for + This is covered in , but is repeated here for @@ -471,2 +469,2 @@ ANALYZE t; - As explained in , the planner can determine - cardinality of t using the number of pages and + As explained in , cardinality of + t can be determined using the number of pages and @@ -593,2 +591,2 @@ EXPLAIN (ANALYZE, TIMING OFF, BUFFERS OFF) SELECT COUNT(*) FROM t GROUP BY a, b; - As explained in , functional - dependencies are very cheap and efficient type of statistics, but their + As explained in , these + are a very cheap and efficient type of statistic, but their diff --git a/doc/src/sgml/plhandler.sgml b/doc/src/sgml/plhandler.sgml index 980c95ecf39..6f58d07ccfa 100644 --- a/doc/src/sgml/plhandler.sgml +++ b/doc/src/sgml/plhandler.sgml @@ -30,2 +30 @@ - For more details on C language calling conventions and dynamic loading, - see . + For more details, see . diff --git a/doc/src/sgml/plperl.sgml b/doc/src/sgml/plperl.sgml index 6f018645f11..818fea2855a 100644 --- a/doc/src/sgml/plperl.sgml +++ b/doc/src/sgml/plperl.sgml @@ -43,2 +43 @@ - PL/Perl during the installation process. (Refer to for more information.) Users of + PL/Perl during . Users of @@ -108,2 +107 @@ $$ LANGUAGE plperl; - most convenient to use dollar quoting (see ) for the string constant. + most convenient to use . @@ -915,2 +913,2 @@ CALL transaction_test1(); - Returns the contents of the referenced array as a string in array literal format - (see ). + Returns the contents of the referenced array as a string in + format. @@ -951,2 +949,2 @@ CALL transaction_test1(); - Returns the contents of the referenced array as a string in array constructor format - (see ). + Returns the contents of the referenced array as a string in + format. diff --git a/doc/src/sgml/plpgsql.sgml b/doc/src/sgml/plpgsql.sgml index 561f6e50d63..a4a158d9101 100644 --- a/doc/src/sgml/plpgsql.sgml +++ b/doc/src/sgml/plpgsql.sgml @@ -136 +136 @@ - works exactly the same way as for SQL functions, as discussed in + works exactly the same way as for @@ -142,2 +142,2 @@ - accept and return the polymorphic types described in - , thus allowing the actual data + accept and return , thus allowing + the actual data @@ -193,2 +193,2 @@ LANGUAGE plpgsql; - FUNCTION is concerned. It is often helpful to use dollar quoting - (see ) to write the function + FUNCTION is concerned. It is often helpful to use + to write the function @@ -306,2 +306 @@ $$ LANGUAGE plpgsql; - See for information on managing - transactions in PL/pgSQL. + See . @@ -358,2 +357,2 @@ arow RECORD; - The COLLATE option specifies a collation to use for the - variable (see ). + The COLLATE option specifies + for the variable. @@ -517,3 +516,3 @@ SELECT * FROM sum_n_product(2, 4); - As discussed in , this - effectively creates an anonymous record type for the function's - results. If a RETURNS clause is given, it must say + This effectively creates an anonymous record type for the function's + results, as described in . + If a RETURNS clause is given, it must say @@ -545,2 +544,2 @@ CALL sum_n_product(2, 4, NULL, NULL); - However, when calling a procedure - from PL/pgSQL, you should instead write a + However, when , you + should instead write a @@ -548,2 +547 @@ CALL sum_n_product(2, 4, NULL, NULL); - of the call. See - for details. + of the call. @@ -573,2 +571 @@ $$ LANGUAGE plpgsql; - is declared as a polymorphic type (see - ), a special + is declared as , a special @@ -703 +700 @@ user_ids users.user_id%TYPE ARRAY[4]; -- equivalent to the above - Just as when declaring table columns that are arrays, it doesn't + Just as with , it doesn't @@ -707 +703,0 @@ user_ids users.user_id%TYPE ARRAY[4]; -- equivalent to the above - (See .) @@ -831 +827,2 @@ SELECT merge_fields(t.*) FROM table1 t WHERE ... ; - When a PL/pgSQL function has one or more + As described in , when a + PL/pgSQL function has one or more @@ -834 +831 @@ SELECT merge_fields(t.*) FROM table1 t WHERE ... ; - arguments, as described in . If a collation is + arguments. If a collation is @@ -934,2 +931 @@ SELECT expression - are replaced by query parameters, as discussed in detail in - . + are subject to . @@ -938 +934,3 @@ SELECT expression - evaluations with different values of the variables. Thus, what + evaluations with different values of the variables, as described in + . + Thus, what @@ -955 +952,0 @@ PREPARE statement_name(integer, integer) AS SELECT $1 - More information appears in . @@ -986 +983 @@ IF count(*) > 0 FROM my_table THEN ... - as described in . + see . @@ -1051,2 +1048,2 @@ INSERT INTO mytable VALUES (1,'one'), (2,'two'); - an INTO clause to capture the output, as described - in . + an INTO clause to capture the output; see + . @@ -1078,2 +1075,2 @@ INSERT INTO mytable VALUES (1,'one'), (2,'two'); - at run time. This is exactly like the processing described earlier - for expressions; for details see . + at run time. This is exactly the process described in + . @@ -1084,3 +1081,2 @@ INSERT INTO mytable VALUES (1,'one'), (2,'two'); - PL/pgSQL may cache and re-use the execution - plan for the command, as discussed in - . + PL/pgSQL may use + for the command. @@ -1095,2 +1091,2 @@ INSERT INTO mytable VALUES (1,'one'), (2,'two'); - command as a string and then EXECUTE it, as - discussed in . + command as a string and then use the EXECUTE statement + described in . @@ -1126,3 +1122,4 @@ PERFORM query; - FOUND is set to true if the query produced at - least one row, or false if it produced no rows (see - ). + FOUND described in + is set to true if the + query produced at + least one row, or false if it produced no rows. @@ -1231,2 +1228,2 @@ MERGE ... RETURNING expressions INTO STRICT - You can check the special FOUND variable (see - ) to + You can check the special variable FOUND described in + to @@ -1320,2 +1317 @@ CONTEXT: PL/pgSQL function get_userid(text) line 6 at SQL statement - normal attempts to cache plans for commands (as discussed in - ) will not work in such + normal will not work in such @@ -1483,4 +1479,2 @@ EXECUTE format('SELECT count(*) FROM %I ' - function body is dollar quoting. (If you have legacy code that does - not use dollar quoting, please refer to the - overview in , which can save you - some effort when translating said code to a more reasonable scheme.) + function body is dollar quoting. (For legacy code without dollar quoting, + see .) @@ -1584,3 +1578,2 @@ EXECUTE 'UPDATE tbl SET ' - Dynamic SQL statements can also be safely constructed using the - format function (see ). For example: + Dynamic SQL statements can also be safely constructed using + . For example: @@ -2668,4 +2661,4 @@ $$ LANGUAGE plpgsql; - PL/pgSQL variables are replaced by query parameters, - and the query plan is cached for possible re-use, as discussed in - detail in and - . + PL/pgSQL variables are replaced by query + parameters + (see ), and the query plan is cached for + possible re-use (see ). @@ -2694 +2687 @@ END LOOP label ; - through is to declare it as a cursor. This is described in + through is to declare it as a cursor; see @@ -3221,2 +3214 @@ DECLARE - via the FOR statement described in - . + via . @@ -3345,2 +3337,2 @@ OPEN bound_cursorvar ( , it + separate it from the argument expression. Similar to + , it @@ -3772 +3764 @@ CALL transaction_test1(); - exception handlers (see ). + . @@ -3890,2 +3882 @@ RAISE NOTICE 'Calling cs_create_job(%)', v_job_id; - See for the valid error condition - names and the predefined SQLSTATE codes. + See . @@ -4825,2 +4816 @@ INSERT INTO foo (foo) VALUES (foo(foo)); - that, you must build a command string dynamically, as explained in - .) + that, see .) @@ -5181,3 +5171,2 @@ $$ LANGUAGE plpgsql; - It's recommended that you instead write the function body as a - dollar-quoted string literal (see ). In the dollar-quoting + It's recommended that you instead write the function body as + . In the dollar-quoting @@ -5500,2 +5489,2 @@ HINT: Make sure the query returns the exact list of columns. - single quotes in the function body. (See .) + single quotes in the function body + (see ). @@ -5533 +5522,2 @@ HINT: Make sure the query returns the exact list of columns. - Integer FOR loops with REVERSE work + with REVERSE + work @@ -5538,2 +5528 @@ HINT: Make sure the query returns the exact list of columns. - but is unlikely to be changed. (See .) + but is unlikely to be changed. diff --git a/doc/src/sgml/plpython.sgml b/doc/src/sgml/plpython.sgml index c860a47a2e1..f5196b6e685 100644 --- a/doc/src/sgml/plpython.sgml +++ b/doc/src/sgml/plpython.sgml @@ -789,2 +789,2 @@ $$ LANGUAGE plpython3u; - PL/Python can be used to define event triggers - (see also ). + PL/Python can be used to define + . @@ -1011 +1011 @@ rv = plan.execute(["name"], 5) - and Python data types as described in . + and Python . @@ -1016 +1016 @@ rv = plan.execute(["name"], 5) - saved. Read the SPI documentation () for a + saved. Read for a @@ -1019,2 +1019,2 @@ rv = plan.execute(["name"], 5) - dictionaries SD or GD (see - ). For example: + dictionaries SD or GD, + as described in . For example: @@ -1195,2 +1195,2 @@ $$ LANGUAGE plpython3u; - Recovering from errors caused by database access as described in - can lead to an undesirable + in database access can lead to an + undesirable diff --git a/doc/src/sgml/pltcl.sgml b/doc/src/sgml/pltcl.sgml index 9fd008a99d7..324c8a2f366 100644 --- a/doc/src/sgml/pltcl.sgml +++ b/doc/src/sgml/pltcl.sgml @@ -482 +482,2 @@ $$ LANGUAGE pltcl; - executed within an SQL subtransaction. If the script returns an + executed within . If the script + returns an @@ -485,2 +485,0 @@ $$ LANGUAGE pltcl; - See for more details and an - example. @@ -930 +928,0 @@ if {[catch { spi_exec $sql_command }]} { - Recovering from errors caused by database access as described in diff --git a/doc/src/sgml/postgres-fdw.sgml b/doc/src/sgml/postgres-fdw.sgml index b9e1b04463e..2b2cab16d97 100644 --- a/doc/src/sgml/postgres-fdw.sgml +++ b/doc/src/sgml/postgres-fdw.sgml @@ -119,2 +119 @@ - can have the same options that libpq accepts in - connection strings, as described in , + can have the same , diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml index 49f81676712..ecc1ed9e77b 100644 --- a/doc/src/sgml/protocol.sgml +++ b/doc/src/sgml/protocol.sgml @@ -401,2 +401,2 @@ - message type. (Details of the exact representation of each message - appear in .) There are + message type. (Details appear in + .) There are @@ -563 +563,2 @@ - The frontend must now initiate a SASL negotiation, using one of the + The frontend must now initiate , + using one of the @@ -568,2 +569 @@ - AuthenticationSASLContinue. See - for details. + AuthenticationSASLContinue. @@ -759,2 +759,3 @@ - The backend is ready to copy data from the frontend to a - table; see . + The backend is ready for from the + frontend to a + table. @@ -769,2 +770,3 @@ - The backend is ready to copy data from a table to the - frontend; see . + The backend is ready for from a table to + the + frontend. @@ -849,2 +851,2 @@ - COPY to or from the frontend invokes special protocol - as described in . + COPY to or from the frontend invokes + . @@ -1463,2 +1465,2 @@ SELCT 1/0; - and should be prepared for other asynchronous message types as well (see - ). Otherwise, any message type other than + and should be prepared for other as well. + Otherwise, any message type other than @@ -1704,3 +1706,2 @@ SELCT 1/0; - able to capture the session traffic. For more information on - encrypting PostgreSQL sessions with - SSL, see . + able to capture the session traffic. For more information, + see . @@ -1813,3 +1814,2 @@ SELCT 1/0; - able to capture the session traffic. For more information on - encrypting PostgreSQL sessions with - GSSAPI, see . + able to capture the session traffic. For more information, + see . @@ -2352,2 +2352,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - slot. See for more about - replication slots. + slot. See for more + information. @@ -2374 +2374 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - (see ). + see . @@ -2520,2 +2520,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - See for more about - replication slots. This command is currently only supported for logical + See for more information. + This command is currently only supported for logical @@ -2669,2 +2669,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - see and for details. + see and + . @@ -3078,3 +3078,3 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - plugin. See for - options that are accepted by the standard (pgoutput) - plugin. + plugin. See + accepted + by the standard (pgoutput) plugin. @@ -3652,2 +3652,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - See for options - that are accepted by the standard (pgoutput) plugin. + See accepted + by the standard (pgoutput) plugin. @@ -3662 +3662 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - subsections. Individual messages are described in + subsections and described in @@ -5108,2 +5108,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - The presently defined field types are listed in - . + The presently defined are + listed. @@ -5548,2 +5548,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - The presently defined field types are listed in - . + The presently defined are + listed. @@ -6260 +6260 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - Used to connect in streaming replication mode, where + Used to connect in , where @@ -6265,2 +6265 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - false. See - for details. + false. @@ -6395,2 +6394,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - Code: the SQLSTATE code for the error (see ). Not localizable. Always present. + Code: . Not localizable. Always + present. @@ -6594,2 +6593,2 @@ psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;" - encapsulated inside replication protocol WAL messages as described in - , and generally obey the same message + encapsulated inside WAL messages, + and generally obey the same message diff --git a/doc/src/sgml/queries.sgml b/doc/src/sgml/queries.sgml index ec4ca01cd16..9f2db682b33 100644 --- a/doc/src/sgml/queries.sgml +++ b/doc/src/sgml/queries.sgml @@ -62 +62 @@ SELECT a, b + c FROM table1; - See for more details. + See . @@ -640,2 +640 @@ SELECT a.* FROM (my_table AS a JOIN your_table AS b ON ...) AS c - parentheses. They may be assigned a table alias name, and optionally - column alias names (as in ). + parentheses. They may be assigned . @@ -663 +662 @@ FROM (VALUES ('anne', 'smith'), ('bob', 'jones'), ('joe', 'blow')) - For more information see . + See . @@ -954,2 +953,2 @@ WHERE search_condition - where search_condition is any value - expression (see ) that + where search_condition is any + that @@ -1106,3 +1105,2 @@ SELECT select_list - computes a single value over the entire group. More information - about the available aggregate functions can be found in . + computes a single value over the entire group. For more information, + see . @@ -1115,2 +1113 @@ SELECT select_list - using the DISTINCT clause (see ). + using the clause. @@ -1483,2 +1480 @@ GROUP BY GROUPING SETS ( - , - and + , , and @@ -1554,2 +1550,2 @@ SELECT a, b, c FROM ... - in the FROM clause, or the aliases given to them as - explained in . The name + in the FROM clause, or the + given to them. The name @@ -1780,2 +1776,2 @@ SELECT DISTINCT ON (expression , . + the corresponding columns have compatible data types. + See for details. @@ -2020,2 +2016,2 @@ VALUES ( expression [, ...] ) [, .. - of the result is determined using the same rules as for UNION - (see ). + of the result is determined using the same rules as for + . diff --git a/doc/src/sgml/query.sgml b/doc/src/sgml/query.sgml index b190f28d41e..79ee2b57a54 100644 --- a/doc/src/sgml/query.sgml +++ b/doc/src/sgml/query.sgml @@ -776,2 +776,2 @@ SELECT city, count(*), max(temp_lo) - The LIKE operator does pattern matching and - is explained in . + The LIKE operator does + . diff --git a/doc/src/sgml/rangetypes.sgml b/doc/src/sgml/rangetypes.sgml index 92ea0e83dab..ecd97bb1129 100644 --- a/doc/src/sgml/rangetypes.sgml +++ b/doc/src/sgml/rangetypes.sgml @@ -132 +132,2 @@ SELECT isempty(numrange(1, 5)); - In the text form of a range, an inclusive lower bound is represented by + In , an inclusive lower bound is represented + by @@ -137 +137,0 @@ SELECT isempty(numrange(1, 5)); - (See for more details.) @@ -231,2 +231 @@ empty - composite-type literals. See for - additional commentary. + . diff --git a/doc/src/sgml/ref/alter_default_privileges.sgml b/doc/src/sgml/ref/alter_default_privileges.sgml index 6acd0f1df91..faa0493a2ac 100644 --- a/doc/src/sgml/ref/alter_default_privileges.sgml +++ b/doc/src/sgml/ref/alter_default_privileges.sgml @@ -207,2 +207 @@ REVOKE [ GRANT OPTION FOR ] - The meaning of the privilege display is the same as explained for - \dp in . + See for the meaning of the privilege display. diff --git a/doc/src/sgml/ref/alter_index.sgml b/doc/src/sgml/ref/alter_index.sgml index fb7096c16ea..c00617e6401 100644 --- a/doc/src/sgml/ref/alter_index.sgml +++ b/doc/src/sgml/ref/alter_index.sgml @@ -160,3 +160 @@ ALTER INDEX ALL IN TABLESPACE name - For more information on the use of statistics by the - PostgreSQL query planner, refer to - . + See . diff --git a/doc/src/sgml/ref/alter_statistics.sgml b/doc/src/sgml/ref/alter_statistics.sgml index c82a728a910..9d9dfb617da 100644 --- a/doc/src/sgml/ref/alter_statistics.sgml +++ b/doc/src/sgml/ref/alter_statistics.sgml @@ -109,3 +109 @@ ALTER STATISTICS name SET STATISTIC - For more information on the use of statistics by the - PostgreSQL query planner, refer to - . + See . diff --git a/doc/src/sgml/ref/alter_subscription.sgml b/doc/src/sgml/ref/alter_subscription.sgml index e4f0b6b16c7..1f182b5109e 100644 --- a/doc/src/sgml/ref/alter_subscription.sgml +++ b/doc/src/sgml/ref/alter_subscription.sgml @@ -211,4 +211 @@ ALTER SUBSCRIPTION name RENAME TO < - See for recommendations on how - to handle any warnings about sequence definition differences between - the publisher and the subscriber, which might occur when - copy_data = true. + See . @@ -247,3 +244 @@ ALTER SUBSCRIPTION name RENAME TO < - See for - recommendations on how to handle any warnings about sequence definition - differences between the publisher and the subscriber. + See . @@ -252,2 +247 @@ ALTER SUBSCRIPTION name RENAME TO < - See for recommendations on how to - identify and handle out-of-sync sequences. + See . @@ -373,2 +367 @@ ALTER SUBSCRIPTION name RENAME TO < - is cleared. See for - the details of logical replication conflicts. + is cleared. See . diff --git a/doc/src/sgml/ref/alter_system.sgml b/doc/src/sgml/ref/alter_system.sgml index b28919d1b26..c6cb83ed3a4 100644 --- a/doc/src/sgml/ref/alter_system.sgml +++ b/doc/src/sgml/ref/alter_system.sgml @@ -115 +115 @@ ALTER SYSTEM RESET ALL - See for other ways to set the parameters. + See . diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml index dec34337d1a..b88306d1af6 100644 --- a/doc/src/sgml/ref/alter_table.sgml +++ b/doc/src/sgml/ref/alter_table.sgml @@ -369,3 +369 @@ WITH ( MODULUS numeric_literal, REM - For more information on the use of statistics by the - PostgreSQL query planner, refer to - . + See . @@ -409,3 +407 @@ WITH ( MODULUS numeric_literal, REM - time. For more information on the use of statistics by the - PostgreSQL query planner, refer to - . + time. See . @@ -431 +427,2 @@ WITH ( MODULUS numeric_literal, REM - column is held inline or in a secondary TOAST table, + column is held inline or in a secondary + table, @@ -449 +445,0 @@ WITH ( MODULUS numeric_literal, REM - See for more information. @@ -867,3 +863,2 @@ WITH ( MODULUS numeric_literal, REM - in the - CREATE TABLE documentation - for details on the available parameters. Note that the table contents + . Note that the table + contents @@ -1254,2 +1249,2 @@ WITH ( MODULUS numeric_literal, REM - ALTER TABLE MERGE PARTITION would fail. - (see ). + ALTER TABLE MERGE PARTITION would fail, as described in + . @@ -1356 +1351 @@ WITH ( MODULUS numeric_literal, REM - would fail (see ). + would fail, as described in . diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml index ec81f00fecf..2db5c377059 100644 --- a/doc/src/sgml/ref/analyze.sgml +++ b/doc/src/sgml/ref/analyze.sgml @@ -196 +196 @@ ANALYZE [ ( option [, ...] ) ] [ ) + @@ -332 +332 @@ ANALYZE [ ( option [, ...] ) ] [ for details. + . diff --git a/doc/src/sgml/ref/call.sgml b/doc/src/sgml/ref/call.sgml index 9e83a77b7c9..2ded92b3d6e 100644 --- a/doc/src/sgml/ref/call.sgml +++ b/doc/src/sgml/ref/call.sgml @@ -65 +65 @@ CALL name ( [ for details. + . diff --git a/doc/src/sgml/ref/checkpoint.sgml b/doc/src/sgml/ref/checkpoint.sgml index 08dbe62c612..4f53fb33a11 100644 --- a/doc/src/sgml/ref/checkpoint.sgml +++ b/doc/src/sgml/ref/checkpoint.sgml @@ -49 +49 @@ CHECKPOINT [ ( option [, ...] ) ] - regular checkpoint scheduled by the system (controlled by the settings in + regular checkpoint scheduled by the system (see @@ -103,2 +103,2 @@ CHECKPOINT [ ( option [, ...] ) ] - request the checkpoint be spread over a longer interval (controlled via - the settings in ), like a + request the checkpoint be spread over a longer interval (see + ), like a diff --git a/doc/src/sgml/ref/cluster.sgml b/doc/src/sgml/ref/cluster.sgml index ffb3ff898c6..372cd8513d3 100644 --- a/doc/src/sgml/ref/cluster.sgml +++ b/doc/src/sgml/ref/cluster.sgml @@ -115 +115 @@ CLUSTER [ ( option [, ...] ) ] [ for details. + . diff --git a/doc/src/sgml/ref/clusterdb.sgml b/doc/src/sgml/ref/clusterdb.sgml index 0d2051bf6f1..81b5e734019 100644 --- a/doc/src/sgml/ref/clusterdb.sgml +++ b/doc/src/sgml/ref/clusterdb.sgml @@ -299,2 +299 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 4706c9a4410..4bebc337e42 100644 --- a/doc/src/sgml/ref/copy.sgml +++ b/doc/src/sgml/ref/copy.sgml @@ -94 +94 @@ COPY { table_name [ ( for details. + . diff --git a/doc/src/sgml/ref/create_access_method.sgml b/doc/src/sgml/ref/create_access_method.sgml index dae43dbaed5..d078c4a9694 100644 --- a/doc/src/sgml/ref/create_access_method.sgml +++ b/doc/src/sgml/ref/create_access_method.sgml @@ -83,3 +83,2 @@ CREATE ACCESS METHOD name - depending on the type of access method. The table access method API - is described in and the index access method - API is described in . + depending on the type of access method. See and + . diff --git a/doc/src/sgml/ref/create_aggregate.sgml b/doc/src/sgml/ref/create_aggregate.sgml index 0472ac2e874..a5e869997e8 100644 --- a/doc/src/sgml/ref/create_aggregate.sgml +++ b/doc/src/sgml/ref/create_aggregate.sgml @@ -94,2 +94,2 @@ CREATE [ OR REPLACE ] AGGREGATE name. If one defines new + commonly-used aggregate functions are included with the distribution in + . If one defines new @@ -210,2 +210,2 @@ CREATE [ OR REPLACE ] AGGREGATE namemoving-aggregate mode, - as described in . This requires + An aggregate can optionally support + . This requires @@ -239,2 +239,2 @@ CREATE [ OR REPLACE ] AGGREGATE namepartial aggregation, - as described in . + An aggregate can optionally support + . diff --git a/doc/src/sgml/ref/create_collation.sgml b/doc/src/sgml/ref/create_collation.sgml index 4af1836ae30..10b67bbb659 100644 --- a/doc/src/sgml/ref/create_collation.sgml +++ b/doc/src/sgml/ref/create_collation.sgml @@ -141,2 +141,2 @@ CREATE COLLATION [ IF NOT EXISTS ] name FROM libc is the default. See for details. + libc is the default. See + . @@ -230 +230 @@ CREATE COLLATION [ IF NOT EXISTS ] name FROM for more information on how to create collations. + See . @@ -265,2 +265 @@ CREATE COLLATION german_phonebook (provider = icu, locale = 'de-u-co-phonebk'); - See for further details and examples - on the rules syntax. + See . diff --git a/doc/src/sgml/ref/create_database.sgml b/doc/src/sgml/ref/create_database.sgml index 3544b15efda..21c9c146c29 100644 --- a/doc/src/sgml/ref/create_database.sgml +++ b/doc/src/sgml/ref/create_database.sgml @@ -117,3 +117,2 @@ CREATE DATABASE name - template database). The character sets supported by the - PostgreSQL server are described in - . See below for + template database). See . + See below for @@ -282,2 +281,2 @@ CREATE DATABASE name - linkend="create-database-template"/>. See for details. + linkend="create-database-template"/>. See + . @@ -414 +413 @@ CREATE DATABASE name - See for more information. + See . diff --git a/doc/src/sgml/ref/create_domain.sgml b/doc/src/sgml/ref/create_domain.sgml index c111285a69c..079907b5cdf 100644 --- a/doc/src/sgml/ref/create_domain.sgml +++ b/doc/src/sgml/ref/create_domain.sgml @@ -225,2 +225 @@ INSERT INTO tab (domcol) VALUES ((SELECT domcol FROM tab WHERE false)); - and not at other times. (This is essentially the same as the treatment - of table CHECK constraints, as described in + and not at other times. (This is essentially the same as diff --git a/doc/src/sgml/ref/create_event_trigger.sgml b/doc/src/sgml/ref/create_event_trigger.sgml index ef12cfa20d4..c4b9fdb2106 100644 --- a/doc/src/sgml/ref/create_event_trigger.sgml +++ b/doc/src/sgml/ref/create_event_trigger.sgml @@ -38,2 +38,2 @@ CREATE EVENT TRIGGER name - will be executed. For a general introduction to event triggers, see - . The user who creates an event trigger + will be executed. See . The user who + creates an event trigger diff --git a/doc/src/sgml/ref/create_extension.sgml b/doc/src/sgml/ref/create_extension.sgml index 713abd9c494..8ea0c76ab3d 100644 --- a/doc/src/sgml/ref/create_extension.sgml +++ b/doc/src/sgml/ref/create_extension.sgml @@ -210,2 +210 @@ CREATE EXTENSION [ IF NOT EXISTS ] extension_name - For information about writing new extensions, see - . + See . diff --git a/doc/src/sgml/ref/create_foreign_table.sgml b/doc/src/sgml/ref/create_foreign_table.sgml index 083f16772b7..416d1ba399c 100644 --- a/doc/src/sgml/ref/create_foreign_table.sgml +++ b/doc/src/sgml/ref/create_foreign_table.sgml @@ -152,3 +152 @@ WITH ( MODULUS numeric_literal, REM - specifiers. For more information on the data types supported by - PostgreSQL, refer to . + specifiers. See . diff --git a/doc/src/sgml/ref/create_function.sgml b/doc/src/sgml/ref/create_function.sgml index 30bd4602f8d..c2ddb3dc652 100644 --- a/doc/src/sgml/ref/create_function.sgml +++ b/doc/src/sgml/ref/create_function.sgml @@ -151,2 +151,2 @@ CREATE [ OR REPLACE ] FUNCTION - when calling a function to improve readability (see ). In any case, the name + when calling a function (see ). + In any case, the name @@ -552,2 +552,2 @@ CREATE [ OR REPLACE ] FUNCTION - It is often helpful to use dollar quoting (see ) to write the function definition + It is often helpful to use to + write the function definition @@ -836,2 +836,2 @@ $$ LANGUAGE plpgsql - (see for more - information). Frequently you will wish to restrict use of a security + (see ). Frequently you will wish to restrict use + of a security diff --git a/doc/src/sgml/ref/create_index.sgml b/doc/src/sgml/ref/create_index.sgml index bb7505d171b..e470b858c26 100644 --- a/doc/src/sgml/ref/create_index.sgml +++ b/doc/src/sgml/ref/create_index.sgml @@ -77 +77 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] for more discussion. + table. See . @@ -130 +130 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] below. + — see . @@ -356,2 +356 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] below - for details. + . @@ -425,2 +424,2 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] is dependent on having + workload dependent). is dependent on + having @@ -461,2 +460 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] . Set to + Controls usage of . Set to @@ -495,2 +493,2 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] is used to build the index. With + Controls whether is used to build + the index. With @@ -522,2 +520 @@ CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] . + Controls usage of . @@ -717,3 +714 @@ Indexes: - See for information about when indexes can - be used, when they are not used, and in which particular situations - they can be useful. + See . @@ -746,3 +741,2 @@ Indexes: - the proper class when creating an index. More information about - operator classes is in and in . + the proper class when creating an index. See + and . @@ -893 +887 @@ Indexes: - view. See for details. + view. See . diff --git a/doc/src/sgml/ref/create_language.sgml b/doc/src/sgml/ref/create_language.sgml index 102efe5a6c7..21cdea59e9e 100644 --- a/doc/src/sgml/ref/create_language.sgml +++ b/doc/src/sgml/ref/create_language.sgml @@ -190,2 +190,2 @@ CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE ) records information about the + The system catalog records information + about the diff --git a/doc/src/sgml/ref/create_materialized_view.sgml b/doc/src/sgml/ref/create_materialized_view.sgml index 62d897931c3..600fadc26d9 100644 --- a/doc/src/sgml/ref/create_materialized_view.sgml +++ b/doc/src/sgml/ref/create_materialized_view.sgml @@ -103,2 +103,2 @@ CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] table_name - access method of type TABLE. See for more information. If this option is not + access method of type TABLE. See + . If this option is not @@ -116,3 +116,3 @@ CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] table_name - This clause specifies optional storage parameters for the new - materialized view; see - in the + This clause specifies optional + for the new + materialized view; see the diff --git a/doc/src/sgml/ref/create_opclass.sgml b/doc/src/sgml/ref/create_opclass.sgml index 2d560b68658..8fc5747289c 100644 --- a/doc/src/sgml/ref/create_opclass.sgml +++ b/doc/src/sgml/ref/create_opclass.sgml @@ -279,2 +279,2 @@ CREATE OPERATOR CLASS name [ DEFAUL - for the data type _int4 (array of int4). See the - module for the complete example. + for the data type _int4 (array of int4). See + for the complete example. diff --git a/doc/src/sgml/ref/create_operator.sgml b/doc/src/sgml/ref/create_operator.sgml index d2ffb1b2a50..b77cbd73f69 100644 --- a/doc/src/sgml/ref/create_operator.sgml +++ b/doc/src/sgml/ref/create_operator.sgml @@ -109 +109 @@ CREATE OPERATOR name ( - Their meaning is detailed in . + See . @@ -301 +301 @@ COMMUTATOR = OPERATOR(myschema.===) , - is hard-wired. See for precedence details. + is hard-wired. See . diff --git a/doc/src/sgml/ref/create_procedure.sgml b/doc/src/sgml/ref/create_procedure.sgml index 03a14c86845..7504918e08e 100644 --- a/doc/src/sgml/ref/create_procedure.sgml +++ b/doc/src/sgml/ref/create_procedure.sgml @@ -273,2 +273,2 @@ CREATE [ OR REPLACE ] PROCEDURE - It is often helpful to use dollar quoting (see ) to write the procedure definition + It is often helpful to use to + write the procedure definition diff --git a/doc/src/sgml/ref/create_publication.sgml b/doc/src/sgml/ref/create_publication.sgml index f82d640e6ca..77c4bddc065 100644 --- a/doc/src/sgml/ref/create_publication.sgml +++ b/doc/src/sgml/ref/create_publication.sgml @@ -64,2 +64 @@ CREATE PUBLICATION name - for details about how - publications fit into the logical replication setup. + . @@ -114,2 +113 @@ CREATE PUBLICATION name - for details about column - lists. + . @@ -288,2 +286 @@ CREATE PUBLICATION name - See for more details about - logical replication of generated columns. + See . @@ -418,2 +415 @@ CREATE PUBLICATION name - See for details about row - filters. + See . diff --git a/doc/src/sgml/ref/create_role.sgml b/doc/src/sgml/ref/create_role.sgml index cee23b1ea6b..00d8ba6efd4 100644 --- a/doc/src/sgml/ref/create_role.sgml +++ b/doc/src/sgml/ref/create_role.sgml @@ -279,3 +279,2 @@ in sync when changing the above synopsis! - in a future release of PostgreSQL. Refer - to for details about migrating to - another password type. + in a future release of PostgreSQL. Refer to + . diff --git a/doc/src/sgml/ref/create_rule.sgml b/doc/src/sgml/ref/create_rule.sgml index 4871a896dc3..5e58a278621 100644 --- a/doc/src/sgml/ref/create_rule.sgml +++ b/doc/src/sgml/ref/create_rule.sgml @@ -58 +58 @@ CREATE [ OR REPLACE ] RULE name AS - More information about the rules system is in . + See . diff --git a/doc/src/sgml/ref/create_sequence.sgml b/doc/src/sgml/ref/create_sequence.sgml index 0ffcd0febd1..ce5faf558e2 100644 --- a/doc/src/sgml/ref/create_sequence.sgml +++ b/doc/src/sgml/ref/create_sequence.sgml @@ -61,2 +61 @@ CREATE [ { TEMPORARY | TEMP } | UNLOGGED ] SEQUENCE [ IF NOT EXISTS ] . + to operate on the sequence. See . diff --git a/doc/src/sgml/ref/create_server.sgml b/doc/src/sgml/ref/create_server.sgml index ce4a064eabb..481f0b37d46 100644 --- a/doc/src/sgml/ref/create_server.sgml +++ b/doc/src/sgml/ref/create_server.sgml @@ -155 +155 @@ CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', db - See for more details. + See . diff --git a/doc/src/sgml/ref/create_subscription.sgml b/doc/src/sgml/ref/create_subscription.sgml index 07d5b1bd77c..f17648c0145 100644 --- a/doc/src/sgml/ref/create_subscription.sgml +++ b/doc/src/sgml/ref/create_subscription.sgml @@ -60,2 +60 @@ CREATE SUBSCRIPTION subscription_name and + See also and @@ -99 +98 @@ CREATE SUBSCRIPTION subscription_namesubscription_name - for recommendations on how to handle any warnings about sequence - definition differences between the publisher and the subscriber, - which might occur when copy_data = true. + See . diff --git a/doc/src/sgml/ref/create_table.sgml b/doc/src/sgml/ref/create_table.sgml index e342585c7f0..1e742eb59f0 100644 --- a/doc/src/sgml/ref/create_table.sgml +++ b/doc/src/sgml/ref/create_table.sgml @@ -307,3 +307 @@ WITH ( MODULUS numeric_literal, REM - specifiers. For more information on the data types supported by - PostgreSQL, refer to . + specifiers. See . @@ -336 +334,2 @@ WITH ( MODULUS numeric_literal, REM - column is held inline or in a secondary TOAST table, + column is held inline or in a secondary + table, @@ -349 +347,0 @@ WITH ( MODULUS numeric_literal, REM - See for more information. @@ -471,2 +469 @@ WITH ( MODULUS numeric_literal, REM - See for more discussion on table - partitioning. + See . @@ -526 +523 @@ WITH ( MODULUS numeric_literal, REM - rules of row-wise comparison (). + rules of . @@ -885 +882 @@ WITH ( MODULUS numeric_literal, REM - current row (see ). + current row, per . @@ -1044 +1041 @@ WITH ( MODULUS numeric_literal, REM - other types by adding the extension (which + other types by adding (which @@ -1166,2 +1163,2 @@ WITH ( MODULUS numeric_literal, REM - operator must be associated with an appropriate operator class - (see ) for the index access + operator must be associated with an appropriate + for the index access @@ -1461,2 +1458,2 @@ WITH ( MODULUS numeric_literal, REM - type TABLE. See for more - information. If this option is not specified, the default table access + type TABLE. See . If this + option is not specified, the default table access @@ -1478,2 +1475,2 @@ WITH ( MODULUS numeric_literal, REM - see below for more - information. For backward-compatibility the WITH + see . For + backward-compatibility the WITH @@ -1595,2 +1592 @@ WITH ( MODULUS numeric_literal, REM - table's secondary TOAST table, if any - (see for more information about TOAST). + table's secondary table, if any. @@ -1684 +1680 @@ WITH ( MODULUS numeric_literal, REM - discussed in . + (see ). @@ -1686,2 +1682 @@ WITH ( MODULUS numeric_literal, REM - transaction ID wraparound. See for - more about wraparound prevention. + transaction ID wraparound. See . diff --git a/doc/src/sgml/ref/create_table_as.sgml b/doc/src/sgml/ref/create_table_as.sgml index 0492933ff38..1c2e2a1aec4 100644 --- a/doc/src/sgml/ref/create_table_as.sgml +++ b/doc/src/sgml/ref/create_table_as.sgml @@ -138,2 +138,2 @@ CREATE [ persistence_mode ] TABLE [ IF NOT EXISTS ] < - type TABLE. See for more - information. If this option is not specified, the default table access + type TABLE. See . If this + option is not specified, the default table access @@ -151,3 +151,2 @@ CREATE [ persistence_mode ] TABLE [ IF NOT EXISTS ] < - see in the - documentation for more - information. For backward-compatibility the WITH + see . For + backward-compatibility the WITH diff --git a/doc/src/sgml/ref/create_tablespace.sgml b/doc/src/sgml/ref/create_tablespace.sgml index b77e774c53f..20aa40a64d5 100644 --- a/doc/src/sgml/ref/create_tablespace.sgml +++ b/doc/src/sgml/ref/create_tablespace.sgml @@ -56,2 +56,3 @@ CREATE TABLESPACE tablespace_name - A tablespace cannot be used independently of the cluster in which it - is defined; see . + cannot be used independently of the + cluster in which they + are defined. diff --git a/doc/src/sgml/ref/create_trigger.sgml b/doc/src/sgml/ref/create_trigger.sgml index bb1426f4970..cd047ea386e 100644 --- a/doc/src/sgml/ref/create_trigger.sgml +++ b/doc/src/sgml/ref/create_trigger.sgml @@ -223 +223 @@ CREATE [ OR REPLACE ] [ CONSTRAINT ] TRIGGER name - Refer to for more information about triggers. + See . @@ -590,3 +590,3 @@ UPDATE OF column_name1 [, column_name2. + There are a few built-in that can be used + to + solve common problems without having to write your own trigger code. @@ -679,2 +679 @@ CREATE TRIGGER paired_items_update - contains a complete example of a trigger - function written in C. + shows a trigger function written in C. diff --git a/doc/src/sgml/ref/create_type.sgml b/doc/src/sgml/ref/create_type.sgml index 994dfc65268..115059519fa 100644 --- a/doc/src/sgml/ref/create_type.sgml +++ b/doc/src/sgml/ref/create_type.sgml @@ -120,2 +120,2 @@ CREATE TYPE name - The second form of CREATE TYPE creates an enumerated - (enum) type, as described in . + The second form of CREATE TYPE creates + . @@ -135,2 +135,2 @@ CREATE TYPE name - The third form of CREATE TYPE creates a new - range type, as described in . + The third form of CREATE TYPE creates + . @@ -414,2 +414,2 @@ CREATE TYPE name - can handle values that have been toasted, as described - in and . + can handle values that have been toasted + (see and ). @@ -471,2 +471,2 @@ CREATE TYPE name - ELEMENT = int4. For more details, - see below. + ELEMENT = int4. See + . diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml index 2ccbe13f390..2047f434d33 100644 --- a/doc/src/sgml/ref/createdb.sgml +++ b/doc/src/sgml/ref/createdb.sgml @@ -114,3 +114 @@ PostgreSQL documentation - database. The character sets supported by the - PostgreSQL server are described in - . + database. See . @@ -158,2 +156,2 @@ PostgreSQL documentation - Specifies the locale name when the builtin provider is used. Locale support - is described in . + Specifies the locale name when the builtin provider is used. See + . @@ -395,2 +393 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index 0c061428514..46d5626c22e 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -480,2 +480 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/declare.sgml b/doc/src/sgml/ref/declare.sgml index 5712825314e..1a5c524b4af 100644 --- a/doc/src/sgml/ref/declare.sgml +++ b/doc/src/sgml/ref/declare.sgml @@ -53,3 +53,3 @@ DECLARE name [ BINARY ] [ ASENSITIV - If you are trying to use cursors inside a PL/pgSQL - function, the rules are different — - see . + If you are trying to use inside a + PL/pgSQL + function, the rules are different. @@ -250,2 +250,2 @@ DECLARE name [ BINARY ] [ ASENSITIV - results if they invoke any volatile functions (see ). When a previously fetched row is + results if they invoke any volatile functions, as described in + . When a previously fetched row is diff --git a/doc/src/sgml/ref/delete.sgml b/doc/src/sgml/ref/delete.sgml index 9066d7ea83d..1eff06f267b 100644 --- a/doc/src/sgml/ref/delete.sgml +++ b/doc/src/sgml/ref/delete.sgml @@ -114,2 +114,2 @@ DELETE FROM [ ONLY ] table_name [ * - query. See and - for details. + query. See and + . diff --git a/doc/src/sgml/ref/drop_role.sgml b/doc/src/sgml/ref/drop_role.sgml index cbcb3cd3d3e..d224dc887b1 100644 --- a/doc/src/sgml/ref/drop_role.sgml +++ b/doc/src/sgml/ref/drop_role.sgml @@ -46,2 +46 @@ DROP ROLE [ IF EXISTS ] name [, ... - commands can be useful for this purpose; see - for more discussion. + commands can be useful for this purpose; see . diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml index d36aed38c52..808c4461f1f 100644 --- a/doc/src/sgml/ref/dropdb.sgml +++ b/doc/src/sgml/ref/dropdb.sgml @@ -261,2 +261 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml index b6be26d5b0a..4611fc422a9 100644 --- a/doc/src/sgml/ref/dropuser.sgml +++ b/doc/src/sgml/ref/dropuser.sgml @@ -239,2 +239 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/fetch.sgml b/doc/src/sgml/ref/fetch.sgml index f0f3ac2a028..41e1450bc83 100644 --- a/doc/src/sgml/ref/fetch.sgml +++ b/doc/src/sgml/ref/fetch.sgml @@ -100,3 +100,3 @@ FETCH [ direction ] [ FROM | IN ] < - If you are trying to use cursors inside a PL/pgSQL - function, the rules are different — - see . + If you are trying to use inside a + PL/pgSQL + function, the rules are different. diff --git a/doc/src/sgml/ref/grant.sgml b/doc/src/sgml/ref/grant.sgml index 67426d42285..b0678ca68dd 100644 --- a/doc/src/sgml/ref/grant.sgml +++ b/doc/src/sgml/ref/grant.sgml @@ -204 +204 @@ GRANT role_name [, ...] TO . + Specific types of . @@ -292,2 +292,2 @@ GRANT role_name [, ...] TO for - details on inheritance. If it is set to TRUE, + of the new membership; see . If it is set + to TRUE, @@ -433,2 +433 @@ GRANT role_name [, ...] TO for more information about specific - privilege types, as well as how to inspect objects' privileges. + See . diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml index bd0dbff8caa..5193455e373 100644 --- a/doc/src/sgml/ref/initdb.sgml +++ b/doc/src/sgml/ref/initdb.sgml @@ -57 +57 @@ PostgreSQL documentation - for more details. + . @@ -97 +97,2 @@ PostgreSQL documentation - libc (see ). The + libc, as described in + . The @@ -129,2 +130 @@ PostgreSQL documentation - More details about locale settings can be found in . + See . @@ -152,2 +152,2 @@ PostgreSQL documentation - and local lines). See - for an overview of valid values. + and local lines). See + . @@ -215,3 +215 @@ PostgreSQL documentation - it then. The character sets supported by the - PostgreSQL server are described in . + it then. See . @@ -247,2 +245,2 @@ PostgreSQL documentation - Specifies the ICU locale when the ICU provider is used. Locale support - is described in . + Specifies the ICU locale when the ICU provider is used. See + . @@ -281 +279 @@ PostgreSQL documentation - See for details. + See . @@ -292,2 +290,2 @@ PostgreSQL documentation - environment that initdb runs in. Locale - support is described in . + environment that initdb runs in. See + . @@ -333,2 +331,2 @@ PostgreSQL documentation - Specifies the locale name when the builtin provider is used. Locale support - is described in . + Specifies the locale name when the builtin provider is used. See + . @@ -346,2 +344,2 @@ PostgreSQL documentation - created. The default is libc (see ). + created. The default is libc, as described in + . diff --git a/doc/src/sgml/ref/insert.sgml b/doc/src/sgml/ref/insert.sgml index 121a9edcb99..f7f77ab44e4 100644 --- a/doc/src/sgml/ref/insert.sgml +++ b/doc/src/sgml/ref/insert.sgml @@ -83,2 +83,2 @@ INSERT INTO table_name [ AS . + rows matching the unique index values being inserted; see + . @@ -87 +87 @@ INSERT INTO table_name [ AS below.) + violation error. (See .) @@ -160,2 +160,2 @@ INSERT INTO table_name [ AS and - for details. + query. See and + . diff --git a/doc/src/sgml/ref/lock.sgml b/doc/src/sgml/ref/lock.sgml index 070855da18b..a1b13672bb7 100644 --- a/doc/src/sgml/ref/lock.sgml +++ b/doc/src/sgml/ref/lock.sgml @@ -140 +140 @@ LOCK [ TABLE ] [ ONLY ] name [ * ] - Lock modes are described in . + See . @@ -214,3 +214,2 @@ LOCK [ TABLE ] [ ONLY ] name [ * ] - acquire an actual row-level lock, see - and - in the documentation. + acquire an actual row-level lock, see and + in . diff --git a/doc/src/sgml/ref/merge.sgml b/doc/src/sgml/ref/merge.sgml index 765fe7a7d62..9bf728f01f8 100644 --- a/doc/src/sgml/ref/merge.sgml +++ b/doc/src/sgml/ref/merge.sgml @@ -158,2 +158,3 @@ MERGE INTO [ ONLY ] target_table_name and - for details. Note that WITH RECURSIVE is not supported + query. See and + . Note that WITH RECURSIVE + is not supported @@ -713,2 +714 @@ MERGE total_count - apply; see for an explanation - on the behavior at each isolation level. + apply; see . diff --git a/doc/src/sgml/ref/pg_amcheck.sgml b/doc/src/sgml/ref/pg_amcheck.sgml index ef2bdfd19ae..d28c2019310 100644 --- a/doc/src/sgml/ref/pg_amcheck.sgml +++ b/doc/src/sgml/ref/pg_amcheck.sgml @@ -653,2 +653 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml index fecee08b0a5..b518d61214d 100644 --- a/doc/src/sgml/ref/pg_basebackup.sgml +++ b/doc/src/sgml/ref/pg_basebackup.sgml @@ -35,3 +35,2 @@ PostgreSQL documentation - both for point-in-time recovery (see ) - and as the starting point for a log-shipping or streaming-replication standby - server (see ). + both for + and as the starting point for . @@ -50,3 +49,2 @@ PostgreSQL documentation - See for more information - about incremental backups, and - for steps to recover from a backup. + See and + . @@ -128 +126 @@ PostgreSQL documentation - See for details. + See . @@ -953,2 +951 @@ PostgreSQL documentation - uses the environment variables supported by libpq - (see ). + uses . diff --git a/doc/src/sgml/ref/pg_checksums.sgml b/doc/src/sgml/ref/pg_checksums.sgml index 8a18f447d15..45890324075 100644 --- a/doc/src/sgml/ref/pg_checksums.sgml +++ b/doc/src/sgml/ref/pg_checksums.sgml @@ -41,5 +41,2 @@ PostgreSQL documentation - must be shut down cleanly before running pg_checksums. - Checksums can also be enabled while the cluster is running using - processing, see - for further details on the different approaches. - When verifying checksums, the exit + must be shut down cleanly before running + pg_checksums. When verifying checksums, the exit @@ -52,5 +49,3 @@ PostgreSQL documentation - When enabling checksums with pg_checksums, if - checksums were in the process of being enabled using - when the cluster was shut - down, pg_checksums will still process all - relation files regardless of the progress of online checksum processing. + When enabling checksums, if checksums were in the process of being enabled + when the cluster was shut down, pg_checksums + will still process all relations regardless of the online processing. diff --git a/doc/src/sgml/ref/pg_combinebackup.sgml b/doc/src/sgml/ref/pg_combinebackup.sgml index 9a6d201e0b8..063131d8b2a 100644 --- a/doc/src/sgml/ref/pg_combinebackup.sgml +++ b/doc/src/sgml/ref/pg_combinebackup.sgml @@ -329,2 +329 @@ PostgreSQL documentation - uses the environment variables supported by libpq - (see ). + uses . diff --git a/doc/src/sgml/ref/pg_createsubscriber.sgml b/doc/src/sgml/ref/pg_createsubscriber.sgml index 3b3038d1891..a3aad5c7212 100644 --- a/doc/src/sgml/ref/pg_createsubscriber.sgml +++ b/doc/src/sgml/ref/pg_createsubscriber.sgml @@ -200,2 +200,2 @@ PostgreSQL documentation - The connection string to the publisher. For details see . + The connection string to the publisher. See + . diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index ae1bc14d2f2..0a4de968be7 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -46,2 +46,2 @@ PostgreSQL documentation - taking regular backups of production databases. See for further discussion. + taking regular backups of production databases. See + . @@ -283,2 +283,2 @@ PostgreSQL documentation - variable to the desired dump encoding.) The supported encodings are - described in . + variable to the desired dump encoding.) See + . @@ -960,2 +960 @@ PostgreSQL documentation - Example files are listed below in the - section. + are listed below. @@ -1323,3 +1322 @@ PostgreSQL documentation - serialization_failure. See - for more information about transaction isolation and concurrency - control. + serialization_failure. See . @@ -1625,2 +1622 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index 51c70198091..eb41fb12898 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -81,2 +81,2 @@ PostgreSQL documentation - ~/.pgpass file in such cases. See for more information. + ~/.pgpass file in such cases. See + . @@ -958,2 +958 @@ exclude database PATTERN - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/pg_isready.sgml b/doc/src/sgml/ref/pg_isready.sgml index ba25ca65a40..a44873c4c0d 100644 --- a/doc/src/sgml/ref/pg_isready.sgml +++ b/doc/src/sgml/ref/pg_isready.sgml @@ -160,2 +160 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/pg_receivewal.sgml b/doc/src/sgml/ref/pg_receivewal.sgml index 9e353a068e5..3308faf85f9 100644 --- a/doc/src/sgml/ref/pg_receivewal.sgml +++ b/doc/src/sgml/ref/pg_receivewal.sgml @@ -36,2 +36 @@ PostgreSQL documentation - location for doing a restore using point-in-time recovery (see - ). + location for doing a restore using . @@ -219 +218,2 @@ PostgreSQL documentation - replication slot (see ). + replication slot. See for + more information. @@ -482,2 +482 @@ PostgreSQL documentation - uses the environment variables supported by libpq - (see ). + uses . diff --git a/doc/src/sgml/ref/pg_recvlogical.sgml b/doc/src/sgml/ref/pg_recvlogical.sgml index 5f76e424e26..083112be1f0 100644 --- a/doc/src/sgml/ref/pg_recvlogical.sgml +++ b/doc/src/sgml/ref/pg_recvlogical.sgml @@ -278,3 +278,2 @@ PostgreSQL documentation - plugin. See for - information about the plugins PostgreSQL - provides. The default is . + plugin. See . The default + is . @@ -480,2 +479 @@ PostgreSQL documentation - uses the environment variables supported by libpq - (see ). + uses . diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml index 5e77ddd556f..556779e37fb 100644 --- a/doc/src/sgml/ref/pg_restore.sgml +++ b/doc/src/sgml/ref/pg_restore.sgml @@ -1154,2 +1154 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). However, it does not read + also uses . However, it does not read @@ -1270,3 +1269,2 @@ CREATE DATABASE foo WITH TEMPLATE template0; - optimizer has useful statistics; see and for more - information. + optimizer has useful statistics; see + and . diff --git a/doc/src/sgml/ref/pg_rewind.sgml b/doc/src/sgml/ref/pg_rewind.sgml index f704dc108e6..ce205f7b461 100644 --- a/doc/src/sgml/ref/pg_rewind.sgml +++ b/doc/src/sgml/ref/pg_rewind.sgml @@ -352,2 +352,2 @@ PostgreSQL documentation - pg_rewind also uses the environment variables - supported by libpq (see ). + pg_rewind also uses + . diff --git a/doc/src/sgml/ref/pgarchivecleanup.sgml b/doc/src/sgml/ref/pgarchivecleanup.sgml index 79e751381ac..e998563982b 100644 --- a/doc/src/sgml/ref/pgarchivecleanup.sgml +++ b/doc/src/sgml/ref/pgarchivecleanup.sgml @@ -37 +37 @@ PostgreSQL documentation - running as a standby server (see ). + running as . diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index 2e401d1ceb8..03332b3772e 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -72,2 +72,2 @@ tps = 896.967014 (without initial connection time) - serialization or deadlock errors (see - for more information). + serialization or deadlock errors. + See for more information. @@ -79,2 +79,2 @@ tps = 896.967014 (without initial connection time) - The next line reports the number of failed transactions (see - for more information). + The next line reports the number of failed transactions. + See for more information. @@ -542,2 +542 @@ pgbench options d - for more information about - retrying such transactions. + . @@ -771 +770 @@ pgbench options d - See for more information. + See . @@ -794 +793 @@ pgbench options d - See for more information. + See . @@ -816 +815 @@ pgbench options d - See for more information. + See . @@ -842,2 +841 @@ pgbench options d - errors are not retried. See - for more information about retrying such transactions. + errors are not retried. See . @@ -934 +932 @@ pgbench options d - See for more information. + See . @@ -1052,2 +1050 @@ pgbench options d - uses the environment variables supported by libpq - (see ). + uses . @@ -1421 +1418 @@ SELECT 4 AS four \; SELECT 5 AS five \aset - for more details. + . @@ -2435 +2432 @@ END; - for more information). + ). @@ -2711 +2708 @@ END; - for more information. + . @@ -2717 +2714 @@ END; - statement. See for more information. + statement. See . @@ -2968 +2965 @@ statement latencies in milliseconds, failures and retries: - the command line (See ). + the command line; see . diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml index 38ca09b423c..157bd107f7d 100644 --- a/doc/src/sgml/ref/pgupgrade.sgml +++ b/doc/src/sgml/ref/pgupgrade.sgml @@ -499,2 +499 @@ make prefix=/usr/local/pgsql.new install - in pg_hba.conf or use a ~/.pgpass file - (see ). + in pg_hba.conf or use . diff --git a/doc/src/sgml/ref/postgres-ref.sgml b/doc/src/sgml/ref/postgres-ref.sgml index b13a16a117f..e6d7f91fb23 100644 --- a/doc/src/sgml/ref/postgres-ref.sgml +++ b/doc/src/sgml/ref/postgres-ref.sgml @@ -121,3 +121,2 @@ PostgreSQL documentation - Sets a named run-time parameter. The configuration parameters - supported by PostgreSQL are - described in . Most of the + Sets a named run-time parameter. See . + Most of the @@ -180 +179 @@ PostgreSQL documentation - for details. + . @@ -272,2 +271 @@ PostgreSQL documentation - available. For more information on using SSL, - refer to . + available. See . @@ -491,2 +489,2 @@ PostgreSQL documentation - The following options only apply to the single-user mode - (see below). + The following options only apply to + . @@ -606,2 +604,2 @@ PostgreSQL documentation - kernel to provide adequate shared memory and semaphores. For more - discussion see . You might be able + kernel to provide adequate shared memory and semaphores. See + . You might be able @@ -687,2 +685 @@ PostgreSQL documentation - in for the SQL-callable equivalents - of these two actions. + in . diff --git a/doc/src/sgml/ref/prepare_transaction.sgml b/doc/src/sgml/ref/prepare_transaction.sgml index f4f6118ac31..630f5f37aab 100644 --- a/doc/src/sgml/ref/prepare_transaction.sgml +++ b/doc/src/sgml/ref/prepare_transaction.sgml @@ -130,2 +130,3 @@ PREPARE TRANSACTION transaction_id - to prevent transaction ID wraparound (see ). Keep in mind also that the transaction + to prevent transaction ID wraparound. + See for more information. + Keep in mind also that the transaction diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index 7c05afd4719..1e91f94882a 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -128,2 +128 @@ echo '\x \\ SELECT * FROM foo;' | psql - transactions. (See - for more details about how the server handles multi-query strings.) + transactions. (See .) @@ -675,2 +674,2 @@ EOF - values. (For additional environment variables, see .) It is also convenient to have a + values. (See also .) It is also convenient to + have a @@ -678 +677 @@ EOF - passwords. See for more information. + passwords. See . @@ -691,2 +690 @@ $ psql postgresql://dbmaster:5433/mydb?sslmode=require - This way you can also use LDAP for connection - parameter lookup as described in . + This way you can also use . @@ -914,2 +912,2 @@ INSERT INTO tbl1 VALUES ($1, $2) \bind 'first value' 'second value' \g - This command causes the extended query protocol (see ) to be used, unlike normal + This command causes to be + used, unlike normal @@ -947,2 +945,2 @@ INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1 - This command causes the extended query protocol (see - ) to be used, unlike normal + This command causes to be + used, unlike normal @@ -965,2 +963,2 @@ INSERT INTO tbls1 VALUES ($1, $2) \parse stmt1 - connection string as detailed in - . If no arguments are given, a + connection string (see ). If no + arguments are given, a @@ -1400,2 +1398 @@ SELECT $1 \parse stmt1 - Lists operator classes - (see ). + Lists . @@ -1425,2 +1422 @@ SELECT $1 \parse stmt1 - Lists operator families - (see ). + Lists . @@ -1477,2 +1473,2 @@ SELECT $1 \parse stmt1 - Lists support functions associated with operator families - (see ). + Lists associated with operator + families. @@ -1637,2 +1633,2 @@ SELECT $1 \parse stmt1 - privileges. The meaning of the privilege display is explained in - . + privileges. See for the meaning of the + privilege display. @@ -2007,3 +2003,2 @@ SELECT $1 \parse stmt1 - commands are used to set access privileges. The meaning of the - privilege display is explained in - . + commands are used to set access privileges. See + for the meaning of the privilege display. @@ -3748 +3743 @@ testdb=> \setenv LESS -imx4F - See for more details. + See . @@ -4046,2 +4041 @@ SELECT 1\; SELECT 2\; SELECT 3; - transactions. (See - for more details about how the server handles multi-query strings.) + transactions. (See .) @@ -4786 +4780 @@ bar - The error code (see ) associated + associated @@ -5439,2 +5433 @@ PSQL_EDITOR_LINENUMBER_ARG='--line ' - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/reindex.sgml b/doc/src/sgml/ref/reindex.sgml index 185cd75ca30..db5ef2b799a 100644 --- a/doc/src/sgml/ref/reindex.sgml +++ b/doc/src/sgml/ref/reindex.sgml @@ -174 +174 @@ REINDEX [ ( option [, ...] ) ] { DA - — see below. + — see . @@ -514 +514 @@ Indexes: - for details. + . diff --git a/doc/src/sgml/ref/reindexdb.sgml b/doc/src/sgml/ref/reindexdb.sgml index a90e48ea86b..aa39fc57ec2 100644 --- a/doc/src/sgml/ref/reindexdb.sgml +++ b/doc/src/sgml/ref/reindexdb.sgml @@ -403,2 +403 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/revoke.sgml b/doc/src/sgml/ref/revoke.sgml index 618a204c36f..3671e267881 100644 --- a/doc/src/sgml/ref/revoke.sgml +++ b/doc/src/sgml/ref/revoke.sgml @@ -298,2 +298 @@ REVOKE [ { ADMIN | INHERIT | SET } OPTION FOR ] - See for more information about specific - privilege types, as well as how to inspect objects' privileges. + See . diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml index 09b6ce809bb..21528f04cc6 100644 --- a/doc/src/sgml/ref/select.sgml +++ b/doc/src/sgml/ref/select.sgml @@ -103 +103 @@ TABLE [ ONLY ] table_name [ * ] - (See below.) + (See .) @@ -113 +113 @@ TABLE [ ONLY ] table_name [ * ] - (See below.) + (See .) @@ -121 +121 @@ TABLE [ ONLY ] table_name [ * ] - output. (See below.) + output. (See .) @@ -133,2 +133 @@ TABLE [ ONLY ] table_name [ * ] - and - below.) + and .) @@ -145 +144 @@ TABLE [ ONLY ] table_name [ * ] - row or row group. (See below.) + row or row group. (See .) @@ -154 +153 @@ TABLE [ ONLY ] table_name [ * ] - duplicates. (See below.) + duplicates. (See .) @@ -176 +175 @@ TABLE [ ONLY ] table_name [ * ] - below.) + .) @@ -186 +185 @@ TABLE [ ONLY ] table_name [ * ] - below.) + .) @@ -194,2 +193,2 @@ TABLE [ ONLY ] table_name [ * ] - only returns a subset of the result rows. (See below.) + only returns a subset of the result rows. (See + .) @@ -205,2 +204 @@ TABLE [ ONLY ] table_name [ * ] - against concurrent updates. (See - below.) + against concurrent updates. (See .) @@ -317,2 +315,2 @@ TABLE [ ONLY ] table_name [ * ] - used internally for tracking visited rows. See for examples. + used internally for tracking visited rows. See + . @@ -879,2 +877 @@ GROUP BY { ALL | [ ALL | DISTINCT ] grouping_elem - For further details on the handling - of grouping sets see . + See . @@ -1157,2 +1154 @@ EXCLUDE NO OTHERS - Window functions are described in detail in - , + See , @@ -1185,2 +1181,2 @@ EXCLUDE NO OTHERS - PostgreSQL keyword (see ). For protection against possible + PostgreSQL keyword, as listed in + . For protection against possible @@ -1528 +1524 @@ SELECT name FROM distributors ORDER BY code; - For more information see and + See and @@ -1650,2 +1646 @@ KEY SHARE - in the FROM clause. For more information on each - row-level lock mode, refer to . + in the FROM clause. See . @@ -2210,2 +2205,2 @@ SELECT 2+2; - ... for the same functionality, as shown above - in . This + ... for the same functionality, as shown in + . This diff --git a/doc/src/sgml/ref/select_into.sgml b/doc/src/sgml/ref/select_into.sgml index cbf865ff838..9ed19c65cf2 100644 --- a/doc/src/sgml/ref/select_into.sgml +++ b/doc/src/sgml/ref/select_into.sgml @@ -138,2 +138,2 @@ SELECT * INTO films_recent FROM films WHERE date_prod >= '2002-01-01'; - in ECPG (see ) and - PL/pgSQL (see ). + in and + . diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml index 16c7e9a7b26..7ce6d767b3f 100644 --- a/doc/src/sgml/ref/set.sgml +++ b/doc/src/sgml/ref/set.sgml @@ -261,2 +261 @@ SELECT setseed(value); - see for more information - about time zones. + see for more information. diff --git a/doc/src/sgml/ref/set_transaction.sgml b/doc/src/sgml/ref/set_transaction.sgml index 727a92757e8..c7c131e2e34 100644 --- a/doc/src/sgml/ref/set_transaction.sgml +++ b/doc/src/sgml/ref/set_transaction.sgml @@ -127,2 +127 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa - for more information about transaction - isolation and concurrency control. + . @@ -215,2 +214,2 @@ SET SESSION CHARACTERISTICS AS TRANSACTION transa - ALTER DATABASE, etc. Consult - for more information. + ALTER DATABASE, etc. See + . diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml index 38ee973ea05..b0d36e2c9de 100644 --- a/doc/src/sgml/ref/vacuum.sgml +++ b/doc/src/sgml/ref/vacuum.sgml @@ -198,2 +198,3 @@ VACUUM [ ( option [, ...] ) ] [ ). However, the + quickly as possible to avoid imminent transaction ID wraparound. + See for more information. + However, the @@ -484,2 +485 @@ VACUUM [ ( option [, ...] ) ] [ for - details. + worker. See . @@ -495 +495 @@ VACUUM [ ( option [, ...] ) ] [ for details. + . diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml index 508c8dfa146..b230b360551 100644 --- a/doc/src/sgml/ref/vacuumdb.sgml +++ b/doc/src/sgml/ref/vacuumdb.sgml @@ -255,2 +255,2 @@ PostgreSQL documentation - multixact ID wraparound (see - ). + multixact ID wraparound; see + . @@ -277 +277,2 @@ PostgreSQL documentation - ID wraparound (see ). + ID wraparound. See for more + information. @@ -640,2 +641 @@ PostgreSQL documentation - also uses the environment variables supported by libpq - (see ). + also uses . diff --git a/doc/src/sgml/ref/values.sgml b/doc/src/sgml/ref/values.sgml index 4bf7bfdffee..bb0aaf8b938 100644 --- a/doc/src/sgml/ref/values.sgml +++ b/doc/src/sgml/ref/values.sgml @@ -46,2 +46,2 @@ VALUES ( expression [, ...] ) [, .. - appearing in that column, using the same rules as for UNION - (see ). + appearing in that column, using the same rules as for + . diff --git a/doc/src/sgml/regress.sgml b/doc/src/sgml/regress.sgml index c74941bfbf2..cb3693ff83f 100644 --- a/doc/src/sgml/regress.sgml +++ b/doc/src/sgml/regress.sgml @@ -102,2 +102,2 @@ make MAX_CONNECTIONS=10 check - To run the tests after installation (see ), - initialize a data directory and start the + To run the tests after , initialize a data + directory and start the @@ -259,2 +259 @@ make check-world -j8 >/dev/null - Some of these auxiliary test suites use the TAP infrastructure explained - in . + Some of these auxiliary test suites use . @@ -640,3 +639,3 @@ make check EXTRA_TESTS=numeric_big - the result is valid, you can add a new comparison file to silence - the failure report in future test runs. See - for details. + the result is valid, you can add new + to silence + the failure report in future test runs. diff --git a/doc/src/sgml/release-19.sgml b/doc/src/sgml/release-19.sgml index ee7c7d1a3f4..465bb7f8dd4 100644 --- a/doc/src/sgml/release-19.sgml +++ b/doc/src/sgml/release-19.sgml @@ -9 +9 @@ - 2026-??-??, AS OF 2026-06-05 + 2026-??-??, AS OF 2026-05-14 @@ -80 +80 @@ Issue a warning after successful MD5 password authentication (Nathan Bossart) -The warning can be disabled via server variable md5_password_warnings. MD5 passwords were marked as deprecated in PostgreSQL 18. +The warning can be disabled via server variable md5_password_warnings. MD5 passwords were marked as deprecated in Postgres 18. @@ -96 +96 @@ Remove RADIUS support (Thomas Munro) -PostgreSQL only supported RADIUS over UDP, which is unfixably insecure. +Postgres only supported RADIUS over UDP, which is unfixably insecure. @@ -128 +128 @@ Prevent carriage returns and line feeds in database, role, and tablespace names -This was changed to avoid security problems. pg_upgrade will also disallow upgrading of clusters that use such names. +This was changed to avoid security problems. pg_upgrade will also disallow upgrading from clusters that use such names. @@ -141 +141 @@ Author: Tom Lane -Change the default index opclasses for inet and cidr data types from to GiST (Tom Lane) +Change the default index opclasses for inet and cidr data types from to GiST (Tom Lane) @@ -147 +147 @@ Change the default index opclasses for -The inet/cidr opclasses are broken because they can exclude rows that should be returned. pg_upgrade will fail to upgrade if inet/cidr indexes exist in the old +The inet/cidr opclasses are broken because they can exclude rows that should be returned. pg_upgrade will fail to upgrade if inet/cidr indexes exist in the old @@ -167 +167 @@ Stop reordering non-schema objects created by < -The goal of the reordering was to avoid dependencies, but it was imperfect. PostgreSQL now uses the specified object ordering, except for foreign keys which are created last. +The goal of the reordering was to avoid dependencies, but it was imperfect. Postgres now uses the specified object ordering, except for foreign keys which are created last. @@ -242 +242 @@ Author: Tomas Vondra -Change JIT to be disabled by default (Jelte Fennema-Nio) +Change JIT to be disabled by default (Jelte Fennema-Nio) @@ -247 +247 @@ Change JIT to be disabled by defau -Previously JIT was enabled by default, and activated based on optimizer costs, but this costing has been determined to be unreliable. This change requires sites that are doing many +Previously JIT was enabled by default, and activated based on optimizer costs. Unfortunately, this costing has been determined to be unreliable, so require sites that are doing many @@ -252,16 +251,0 @@ large analytical queries to manually enable JIT. - - - - -Rename column sync_error_count to sync_table_error_count in system view pg_stat_subscription_stats (Vignesh C) -§ - - - -This is necessary since sequence errors are now tracked separately. - - - @@ -329,2 +313,2 @@ This encoding was complex and rarely used. Databases using it will need to be d - PostgreSQL 19 and the previous major - release. + PostgreSQL 19 and the previous major + release. @@ -347 +331 @@ Author: Richard Guo -Allow NOT IN clauses to be converted to more efficient ANTI JOINs when NULLs are not present (Richard Guo) +Allow NOT IN clauses to be converted to more efficient anti-joins when NULLs are not present (Richard Guo) @@ -378,5 +362 @@ Author: Richard Guo -2025-10-08 [8e1185910] Implement Eager Aggregation -Author: Richard Guo -2026-04-06 [bd94845e8] Fix collation handling for grouping keys in eager aggreg -Author: Richard Guo -2026-04-06 [3a08a2a8b] Fix volatile function evaluation in eager aggregation +2025-08-19 [24225ad9a] Pathify RHS unique-ification for semijoin planning @@ -387,8 +367,2 @@ Author: Richard Guo -Allow some aggregate processing to be performed before joins (Richard Guo, Antonin Houska) -§ -§ -§ - - - -This can reduce the number of rows needed to be processed. +Improve the planning of semijoins (Richard Guo) +§ @@ -412 +386 @@ Author: Richard Guo -2025-08-19 [24225ad9a] Pathify RHS unique-ification for semijoin planning +2026-02-10 [f41ab5157] Teach planner to transform "x IS [NOT] DISTINCT FROM NUL @@ -417,2 +391,22 @@ Author: Richard Guo -Improve the planning of semijoins (Richard Guo) -§ +Convert IS [NOT] DISTINCT FROM NULL to IS [NOT] NULL during constant folding (Richard Guo) +§ + + + +The latter form is more easily optimized. + + + + + + + +Perform earlier constant folding of Var IS [NOT] NULL in the optimizer (Richard Guo) +§ + + + +This allows for later optimizations. @@ -436 +430,5 @@ Author: Richard Guo -2026-02-10 [f41ab5157] Teach planner to transform "x IS [NOT] DISTINCT FROM NUL +2025-10-08 [8e1185910] Implement Eager Aggregation +Author: Richard Guo +2026-04-06 [bd94845e8] Fix collation handling for grouping keys in eager aggreg +Author: Richard Guo +2026-04-06 [3a08a2a8b] Fix volatile function evaluation in eager aggregation @@ -441,2 +439,4 @@ Author: Richard Guo -Convert IS [NOT] DISTINCT FROM NULL to IS [NOT] NULL during constant folding (Richard Guo) -§ +Allow some aggregate processing to be performed before joins (Richard Guo, Antonin Houska) +§ +§ +§ @@ -446 +446 @@ Convert IS [NOT] DISTIN -The latter form is more easily optimized. +This can reduce the number of rows needed to be processed. @@ -452 +452 @@ Author: Richard Guo -2026-02-10 [0a3796125] Optimize IS DISTINCT FROM with non-nullable inputs +2025-10-08 [185e30426] Allow negative aggtransspace to indicate unbounded state @@ -457,2 +457,6 @@ Author: Richard Guo -Simplify IS [NOT] DISTINCT FROM to equality/inequality operators when inputs are proven non-nullable (Richard Guo) -§ +Allow negative values of pg_aggregate.aggtransspace to indicate unbounded memory usage (Richard Guo) +§ + + + +This information is used by the optimizer in planning memory usage. @@ -464 +468 @@ Author: Richard Guo -2025-07-22 [e2debb643] Reduce "Var IS [NOT] NULL" quals during constant folding +2026-02-10 [0aaf0de7f] Optimize BooleanTest with non-nullable input @@ -469,6 +473,2 @@ Author: Richard Guo -Perform earlier constant folding of var IS [NOT] NULL in the optimizer (Richard Guo) -§ - - - -This allows for later optimizations. +Simplify IS [NOT] TRUE/FALSE/UNKNOWN to plain boolean expressions when the input is proven non-nullable (Richard Guo) +§ @@ -495 +495 @@ Author: Richard Guo -2026-02-10 [0aaf0de7f] Optimize BooleanTest with non-nullable input +2026-02-10 [0a3796125] Optimize IS DISTINCT FROM with non-nullable inputs @@ -500,2 +500,2 @@ Author: Richard Guo -Simplify IS [NOT] TRUE/FALSE/UNKNOWN to plain boolean expressions when the input is proven non-nullable (Richard Guo) -§ +Simplify IS [NOT] DISTINCT FROM to equality/inequality operators when inputs are proven non-nullable (Richard Guo) +§ @@ -536 +536 @@ Author: Dean Rasheed -Allow extended statistics on virtual generated columns (Yugo Nagata) +Allow extended statistics on virtual generated columns (Yugo Nagata) @@ -584,16 +583,0 @@ Adjust the optimizer to consider startup costs of partial paths (Robert Haas, To - - - - - - -Allow negative values of pg_aggregate.aggtransspace to indicate unbounded memory usage (Richard Guo) -§ - - - -This information is used by the optimizer in planning memory usage. - @@ -642 +626 @@ Author: Andres Freund -Improve asynchronous I/O read-ahead scheduling for large requests (Andres Freund) +Improve asynchronous I/O read-ahead scheduling for large requests (Andres Freund) @@ -661 +645 @@ Allow io_method method < -The new server variables are io_min_workers, io_max_workers, io_worker_idle_timeout, and io_worker_launch_interval. +New server variables are io_min_workers, io_max_workers, io_worker_idle_timeout, and io_worker_launch_interval. @@ -672 +656 @@ Author: Melanie Plageman -Allow query table scans to mark pages as all-visible in the visibility map (Melanie Plageman) +Allow query table scans to mark pages as all-visible in the visibility map (Melanie Plageman) @@ -691 +675 @@ Author: Masahiko Sawada -Allow autovacuum to use parallel vacuum workers (Daniil Davydov) +Allow autovacuum to use parallel vacuum workers (Daniil Davydov) @@ -708 +692 @@ Author: David Rowley -Allow TID Range Scans to be parallelized (Cary Huang, David Rowley) +Allow TID Range Scans to be parallelized (Cary Huang, David Rowley) @@ -748 +732 @@ Author: Andrew Dunstan -Allow the addition of columns based on domains containing constraints to usually avoid a table rewrite (Jian He) +Allow the addition of columns based on domains containing constraints to usually avoid a table rewrite (Jian He) @@ -764 +748 @@ Author: Michael Paquier -Change the default TOAST compression method from pglz to the more efficient lz4 (Euler Taveira) +Change the default TOAST compression method from pglz to the more efficient lz4 (Euler Taveira) @@ -806 +790 @@ Author: Michael Paquier -Improve performance of hash index bulk-deletion and GIN index vacuuming using streaming reads (Xuneng Zhou) +Improve performance of hash index bulk-deletion and GIN index vacuuming using streaming reads (Xuneng Zhou) @@ -850 +834 @@ Author: Tom Lane -Optimize plpgsql syntax SELECT simple-expression INTO var (Tom Lane) +Optimize plpgsql syntax SELECT simple-expression INTO var (Tom Lane) @@ -870 +854 @@ Author: Michael Paquier -Add system view pg_stat_lock and function pg_stat_get_lock() to report per-lock-type statistics (Bertrand Drouvot) +Add system view pg_stat_lock and function pg_stat_get_lock() to report per-lock type statistics (Bertrand Drouvot) @@ -891,2 +875,2 @@ Add system view pg_stat_recove -Author: Nathan Bossart -2026-04-06 [87f61f0c8] Add pg_stat_autovacuum_scores system view. +Author: Masahiko Sawada +2025-10-08 [d3b6183dd] Add mem_exceeded_count column to pg_stat_replication_slo @@ -897,2 +881,2 @@ Author: Nathan Bossart -Add system view pg_stat_autovacuum_scores to report per-table autovacuum details (Sami Imseih) -§ +Add mem_exceeded_count column to system view pg_stat_replication_slots (Bertrand Drouvot) +§ @@ -900 +883,0 @@ Add system view pg_st - @@ -902,8 +884,0 @@ Add system view pg_st - - - @@ -911,3 +886 @@ Author: Nathan Bossart -Add system view pg_dsm_registry_allocations to report dynamic shared memory details (Florents Tselai, Nathan Bossart) -§ -§ +This reports the number of times that logical_decoding_work_mem was exceeded. @@ -918,2 +891,2 @@ Add system view pg_ -Author: Masahiko Sawada -2025-12-09 [0d7895206] Add mode and started_by columns to pg_stat_progress_vacu +Author: Michael Paquier +2025-10-06 [a5b543258] Add stats_reset to pg_stat_all_{tables,indexes} and rela @@ -924,2 +897,2 @@ Author: Masahiko Sawada -Add vacuum initiation details to system view pg_stat_progress_vacuum (Shinya Kato) -§ +Add stats_reset column to system views pg_stat_all_tables, pg_stat_all_indexes, and pg_statio_all_sequences (Bertrand Drouvot, Sami Imseih, Shihao Zhong) +§ @@ -929 +902 @@ Add vacuum initiation details to system view pg_stat_progress_analyze (Shinya Kato) -§ - - - -The new started_by column reports the initiator of the analyze. +Add stats_reset column to system views pg_stat_user_functions and pg_stat_database_conflicts (Bertrand Drouvot, Shihao Zhong) +§ +§ @@ -950,2 +922,2 @@ The new started_by column reports the initiator of th -Author: Masahiko Sawada -2025-10-08 [d3b6183dd] Add mem_exceeded_count column to pg_stat_replication_slo +Author: Nathan Bossart +2026-04-06 [87f61f0c8] Add pg_stat_autovacuum_scores system view. @@ -956,6 +928,2 @@ Author: Masahiko Sawada -Add mem_exceeded_count column to system view pg_stat_replication_slots (Bertrand Drouvot) -§ - - - -This reports the number of times that logical_decoding_work_mem was exceeded. +Add system view pg_stat_autovacuum_scores to report per-table autovacuum details (Sami Imseih) +§ @@ -966,6 +934,2 @@ This reports the number of times that pg_stat_replication_slots and pg_replication_slots (Shlok Kyal) -§ -§ -§ +Add vacuum initiation details to system view pg_stat_progress_vacuum (Shinya Kato) +§ @@ -983 +945 @@ Add slot synchronization skip information to pg_stat_subscription_stats (Zhijie Hou) -§ +Add analyze initiation details to system view pg_stat_progress_analyze (Shinya Kato) +§ @@ -999 +961 @@ Add update_deleted column to system view retain_dead_tuples enabled. +The new started_by column reports the initiator of the analyze. @@ -1004,4 +966,2 @@ This reports the number of rows where updates were ignored due to concurrent del -Author: Amit Kapila -2025-11-07 [f6a4c498d] Add seq_sync_error_count to subscription statistics. -Author: Amit Kapila -2025-11-18 [3edaf29fa] Rename two columns in pg_stat_subscription_stats. +Author: Masahiko Sawada +2025-08-05 [deb674454] Add backup_type column to pg_stat_progress_basebackup. @@ -1012,3 +972,6 @@ Author: Amit Kapila -Add sync_seq_error_count column to system view pg_stat_subscription_stats to report sequence synchronization errors (Vignesh C) -§ -§ +Add a column to system view pg_stat_progress_basebackup to report the type of backup (Shinya Kato) +§ + + + +Possible values are full or incremental. @@ -1020 +983 @@ Author: Michael Paquier -2025-10-06 [a5b543258] Add stats_reset to pg_stat_all_{tables,indexes} and rela +2025-10-28 [f9a09aa29] Add wal_fpi_bytes to pg_stat_wal and pg_stat_get_backend @@ -1025,2 +988,2 @@ Author: Michael Paquier -Add stats_reset column to system views pg_stat_all_tables, pg_stat_all_indexes, and pg_statio_all_sequences (Bertrand Drouvot, Sami Imseih, Shihao Zhong) -§ +Add reporting of the bytes written to WAL for full page images (Shinya Kato) +§ @@ -1030 +993 @@ Add stats_reset column to system views sys and user view variants. +This is accessible via system view pg_stat_wal and function pg_stat_get_backend_wal(). @@ -1036,16 +999 @@ Author: Michael Paquier -2025-10-08 [b71bae41a] Add stats_reset to pg_stat_user_functions -Author: Fujii Masao -2026-03-16 [8fe315f18] Add stats_reset column to pg_statio_all_sequences ---> - - - -Add stats_reset column to system views pg_stat_user_functions and pg_stat_database_conflicts (Bertrand Drouvot, Shihao Zhong) -§ -§ - - - - - - @@ -1084,2 +1021 @@ Author: Michael Paquier -Add connecting value to system view column pg_stat_wal_receiver.status (Xuneng Zhou) -§ +Adds table OID and attribute number columns to pg_stats, and table OID and statistics object OID columns to the other two. @@ -1091 +1027 @@ Author: Michael Paquier -2025-10-28 [f9a09aa29] Add wal_fpi_bytes to pg_stat_wal and pg_stat_get_backend +2026-02-10 [307447e6d] Add information about range type stats to pg_stats_ext_e @@ -1096,6 +1032,2 @@ Author: Michael Paquier -Add reporting of the bytes written to WAL for full page images (Shinya Kato) -§ - - - -This is accessible via system view pg_stat_wal and function pg_stat_get_backend_wal(). +Add information about range type extended statistics to system view pg_stats_ext_exprs (Corey Huinker, Michael Paquier) +§ @@ -1107 +1039,3 @@ Author: Nathan Bossart -2026-03-17 [3b88e50d6] Add more columns to pg_stats, pg_stats_ext, and pg_stats +2025-07-09 [167ed8082] Introduce pg_dsm_registry_allocations view. +Author: Nathan Bossart +2025-12-02 [f894acb24] Show size of DSAs and dshashes in pg_dsm_registry_alloca @@ -1112,6 +1046,3 @@ Author: Nathan Bossart -Add columns to system views pg_stats, pg_stats_ext, and pg_stats_ext_exprs (Corey Huinker) -§ - - - -Adds table OID and attribute number columns to pg_stats, and table OID and statistics object OID columns to the other two. +Add system view pg_dsm_registry_allocations to report dynamic shared memory details (Florents Tselai, Nathan Bossart) +§ +§ @@ -1122,2 +1053,2 @@ Adds table OID and attribute number columns to extended statistics to system view pg_stats_ext_exprs (Corey Huinker, Michael Paquier) -§ +Add column location to system views pg_available_extensions and pg_available_extension_versions to report the file system directory of extensions (Matheus Alcantara) +§ @@ -1152 +1083 @@ Allow log_min_messagestype:level. A value without a colon controls all process types, allowing backward compatibility. +The new format is type:level. A value without a colon controls unspecified process types, enabling backward compatibility. @@ -1163 +1094 @@ Author: Peter Eisentraut -Add server variable log_autoanalyze_min_duration to log long-running autoanalyze operations (Shinya Kato) +Add server variable log_autoanalyze_min_duration to log long-running autoanalyze operations (Shinya Kato) @@ -1168 +1099 @@ Add server variable lo -Server variable log_autovacuum_min_duration now only controls logging of autovacuum operations. +Server variable log_autovacuum_min_duration now only controls logging of automatic vacuum operations. @@ -1191 +1122 @@ Author: Tatsuo Ishii -Add server variable debug_print_raw_parse to log raw parse trees (Chao Li) +Add server variable debug_print_parse to log the raw parse tree (Chao Li) @@ -1196 +1127 @@ Add server variable debug_pri -This is also enabled when the server is started with debug level three and higher. +This is also enabled when the server is started with debug level 3 and higher. @@ -1223 +1154 @@ Author: Michael Paquier -Add WAL full-page write bytes reporting to VACUUM and ANALYZE logging (Shinya Kato) +Add WAL full page write bytes reporting to VACUUM and ANALYZE logging (Shinya Kato) @@ -1235 +1166 @@ Author: Michael Paquier -Add IO wait events for COPY FROM/TO on a pipe, file, or program (Nikolay Samokhvalov) +Add IO wait events for COPY FROM/TO on a pipe/file/program (Nikolay Samokhvalov) @@ -1247 +1178 @@ Author: Alexander Korotkov -Add wait events for WAL write and flush LSNs (Xuneng Zhou) +Add wait events for WAL write and flush LSNs (Xuneng Zhou) @@ -1259 +1190 @@ Author: Amit Kapila -Have pg_get_sequence_data() return the sequence page LSN (Vignesh C) +Have pg_get_sequence_data function return the sequence page LSN (Vignesh C) @@ -1271 +1202 @@ Author: Michael Paquier -Add function pg_get_multixact_stats() to report multixact activity (Naga Appani) +Add function pg_get_multixact_stats() to report multixact activity (Naga Appani) @@ -1283 +1214 @@ Author: Nathan Bossart -Issue warnings when the wraparound of xid and multi-xids is less than 100 million (Nathan Bossart) +Issue warnings when the wraparound of xid and multi-xids is less than 100 million (Nathan Bossart) @@ -1288 +1219 @@ Issue warnings when the wraparound -The previous warning was 40 million. Warnings are issued to clients and in the server log. +The previous warning was 40 million. Warnings are issued to clients and the server log. @@ -1309 +1240 @@ Author: Daniel Gustafsson -Allow online enabling and disabling of data checksums (Daniel Gustafsson, Magnus Hagander, Tomas Vondra) +Allow online enabling and disabling of data checksums (Daniel Gustafsson, Magnus Hagander, Tomas Vondra) @@ -1326 +1257 @@ Author: Nathan Bossart -Add scoring system to control the order that tables are autovacuumed (Nathan Bossart) +Add scoring system to control the order that tables are autovacuumed (Nathan Bossart) @@ -1343 +1274 @@ Author: Daniel Gustafsson -Add server-side support for SNI (Server Name Indication) (Daniel Gustafsson, Jacob Champion) +Add server-side report for SNI (Server Name Indication) (Daniel Gustafsson, Jacob Champion) @@ -1348 +1279 @@ Add server-side support for SNIPGDATA/pg_hosts.conf specifies hostname/key pairs. +New configuration file PGDATA/pg_hosts.conf specifies hostname/key pairs. @@ -1361 +1292 @@ Author: Jacob Champion -Add a new OAUTH flow hook PQAUTHDATA_OAUTH_BEARER_TOKEN_V2 (Jacob Champion) +Add a new OAUTH flow hook PQAUTHDATA_OAUTH_BEARER_TOKEN_V2 (Jacob Champion) @@ -1367 +1298 @@ Add a new OAUTH flow hook PQAUTHDATA_OAUTH_BEARER_TOKEN by adding the issuer identifier and error message specification. +This is an improved version of PQAUTHDATA_OAUTH_BEARER_TOKEN by adding the issuer identifier and error message specification. @@ -1378 +1309 @@ Author: Nathan Bossart -Allow roles pg_read_all_data and pg_write_all_data to read/write large objects (Nitin Motiani, Nathan Bossart) +Allow roles pg_read_all_data and pg_write_all_data to read/write large objects (Nitin Motiani, Nathan Bossart) @@ -1406 +1337 @@ Author: Tom Lane -Allow server variables that represent lists to be emptied by setting the value to NULL (Tom Lane) +Allow server variables that represent lists to be emptied by setting the value to NULL (Tom Lane) @@ -1418 +1349 @@ Author: John Naylor -Update GB18030 encoding from version 2000 to 2022 (Chao Li, Zheng Tao) +Update GB18030 encoding from version 2000 to 2022 (Chao Li, Zheng Tao) @@ -1432 +1363 @@ See the commit message for compatibility details. - <link linkend="streaming-replication">Streaming Replication and Recovery</link> + Streaming Replication and Recovery @@ -1444 +1375 @@ Author: Alexander Korotkov -Add WAIT FOR command to allow standbys to wait for LSN values to be written, flushed, or replayed (Kartyshov Ivan, Alexander Korotkov, Xuneng Zhou) +Allow standbys to wait for LSN values to be written, flushed, or replayed via WAIT FOR (Kartyshov Ivan, Alexander Korotkov, Xuneng Zhou) @@ -1457 +1388 @@ Author: Amit Kapila -Improve function pg_sync_replication_slots() to wait for replication synchronization completion (Ajin Cherian, Zhijie Hou) +Improve function pg_sync_replication_slots() to wait for the synchronization completion (Ajin Cherian, Zhijie Hou) @@ -1491 +1422 @@ Author: Fujii Masao -Allow wal_receiver_timeout to be set per-subscription and user (Fujii Masao) +Allow wal_receiver_timeout to be set per subscription and user (Fujii Masao) @@ -1497 +1428 @@ Allow wal_receiver_timeoutwal_receiver_timeout values. +This allows subscriptions to use different wal_receiver_timeout values. @@ -1539,2 +1470,95 @@ Allow sequence values stored in subscribers to match the publisher (Vignesh C) -This is enabled during CREATE SUBSCRIPTION, ALTER SUBSCRIPTION ... REFRESH PUBLICATION, and ALTER SUBSCRIPTION ... REFRESH SEQUENCES. The latter only updates values, not sequence -existence. Function pg_get_sequence_data() allows inspection of sequence synchronization. +This is enabled during CREATE SUBSCRIPTION, ALTER SUBSCRIPTION ... REFRESH PUBLICATION, and ALTER SUBSCRIPTION ... REFRESH SEQUENCES. The latter only updates values, not sequence +existence. Function pg_get_sequence_data() allows inspection of sequence synchronization. + + + + + + + +Allow publications to publish all sequences via the ALL SEQUENCES clause (Vignesh C, Tomas Vondra) +§ + + + + + + + +Enhance ALTER SUBSCRIPTION on publications to synchronize the existence of sequences on subscribers to match the publisher (Vignesh C) +§ + + + + + + + +Allow CREATE/ALTER PUBLICATION to exclude some tables using the EXCEPT clause (Vignesh C, Shlok Kyal) +§ +§ +§ +§ + + + +This is useful when specifying ALL TABLES. + + + + + + + +Allow CREATE SUBSCRIPTION to use foreign data wrapper connection parameters (Jeff Davis) +§ + + + +The connection parameters are referenced via CREATE SUBSCRIPTION ... SERVER. + + + + + + + +When server variable wal_level is replica, allow the automatic enablement of logical replication when needed (Masahiko Sawada) +§ + + + +New server variable effective_wal_level reports the effective WAL level. + + + + + + + +Add logical subscriber setting retain_conflict_info to retain information needed for conflict resolution (Zhijie Hou) +§ @@ -1546 +1570 @@ Author: Amit Kapila -2025-10-09 [96b378497] Add "ALL SEQUENCES" support to publications. +2025-08-04 [fd5a1a0c3] Detect and report update_deleted conflicts. @@ -1551,2 +1575,2 @@ Author: Amit Kapila -Allow CREATE/ALTER PUBLICATION to publish all sequences (Vignesh C, Tomas Vondra) -§ +Report cases where an update is applied to a row that was already deleted on a subscriber (Zhijie Hou) +§ @@ -1556 +1580 @@ Allow CREATE/
  • ALL SEQUENCES clause. +This requires the subscriber have retain_dead_tuples enabled. @@ -1562 +1586 @@ Author: Amit Kapila -2025-10-23 [f0b3573c3] Introduce "REFRESH SEQUENCES" for subscriptions. +2025-09-15 [0d48d393d] Resume conflict-relevant data retention automatically. @@ -1567,6 +1591,2 @@ Author: Amit Kapila -Allow ALTER SUBSCRIPTION on publications to synchronize the existence of sequences on subscribers to match the publisher (Vignesh C) -§ - - - -This is enabled with the REFRESH SEQUENCES clause. +Re-enable retain_dead_tuples when the necessary transaction retention falls below max_retention_duration (Zhijie Hou) +§ @@ -1578,7 +1598 @@ Author: Amit Kapila -2026-03-20 [493f8c643] Add support for EXCEPT TABLE in ALTER PUBLICATION. -Author: Amit Kapila -2026-04-01 [6b0550c45] Fix miscellaneous issues in EXCEPT publication clause. -Author: Amit Kapila -2026-03-04 [fd366065e] Allow table exclusions in publications via EXCEPT TABLE. -Author: Amit Kapila -2026-03-31 [5984ea868] Change syntax of EXCEPT TABLE clause in publication comm +2025-09-02 [a850be2fe] Add max_retention_duration option to subscriptions. @@ -1589,5 +1603,2 @@ Author: Amit Kapila -Allow CREATE/ALTER PUBLICATION to exclude some tables (Vignesh C, Shlok Kyal) -§ -§ -§ -§ +Add subscription option max_retention_duration to limit retain_dead_tuples retention (Zhijie Hou) +§ @@ -1597 +1608 @@ Allow CREATE/
  • EXCEPT clause, and is useful when specifying ALL TABLES. +When the limit is reached, dead tuple retention is disabled until manually re-enabled or a new subscription is created. @@ -1603,3 +1614 @@ Author: Amit Kapila -2025-07-23 [228c37086] Preserve conflict-relevant data during logical replicati -Author: Amit Kapila -2025-09-15 [0d48d393d] Resume conflict-relevant data retention automatically. +2025-11-07 [f6a4c498d] Add seq_sync_error_count to subscription statistics. @@ -1607 +1616 @@ Author: Amit Kapila -2025-09-02 [a850be2fe] Add max_retention_duration option to subscriptions. +2025-11-18 [3edaf29fa] Rename two columns in pg_stat_subscription_stats. @@ -1612,8 +1621,3 @@ Author: Amit Kapila -Add CREATE/ALTER PUBLICATION setting retain_dead_tuples to retain information needed for conflict resolution (Zhijie Hou) -§ -§ -§ - - - -Also add setting max_retention_duration to limit retain_dead_tuples retention. +Add column pg_stat_subscription_stats.sync_seq_error_count to report sequence synchronization errors (Vignesh C) +§ +§ @@ -1624,2 +1628,2 @@ Also add setting CREATE SUBSCRIPTION to use foreign data wrapper connection parameters (Jeff Davis) -§ +Rename column sync_error_count to sync_table_error_count in system view pg_stat_subscription_stats (Vignesh C) +§ @@ -1635 +1639 @@ Allow CREATE SUBSCRIPTIONCREATE SUBSCRIPTION ... SERVER. +This is necessary since sequence errors are now also tracked. @@ -1640,2 +1644,6 @@ The connection parameters are referenced via wal_level is replica, allow automatic enablement of logical replication when needed (Masahiko Sawada) -§ +Add slot synchronization skip information to pg_stat_replication_slots and pg_replication_slots (Shlok Kyal) +§ +§ +§ @@ -1651 +1661 @@ When server variable wal_level< -New server variable effective_wal_level reports the effective WAL level. +The new columns are slotsync_skip_count, slotsync_last_skip, and slotsync_skip_reason. @@ -1696 +1706 @@ Author: Peter Eisentraut -Add FOR PORTION OF clause to UPDATE and DELETE (Paul A. Jungwirth) +Add UPDATE/DELETE FOR PORTION OF (Paul A. Jungwirth) @@ -1702 +1712 @@ Add FOR PORTION OF clause to -Add GROUP BY ALL syntax to SELECT to automatically group all non-aggregate and non-window-function target list parameters (David Christensen) +Add GROUP BY ALL syntax to automatically group all non-aggregate and non-window function target list parameters (David Christensen) @@ -1741 +1751 @@ Author: Tatsuo Ishii -Allow window functions to ignore NULLs with the IGNORE NULLS/RESPECT NULLS clause (Oliver Ford, Tatsuo Ishii) +Allow window functions to ignore NULLs with IGNORE NULLS/RESPECT NULLS option (Oliver Ford, Tatsuo Ishii) @@ -1746 +1756 @@ Allow window functions to ignore NULLs w -Supported window functions are lead(), lag(), first_value(), last_value(), and nth_value(). +Supported window functions are lead, lag, first_value, last_value and nth_value. @@ -1781 +1791 @@ Author: Álvaro Herrera -Add REPACK command which replaces VACUUM FULL and CLUSTER (Antonin Houska) +Create a REPACK command that replaces VACUUM FULL and CLUSTER (Antonin Houska) @@ -1786 +1796 @@ Add REPACK command which re -The two former commands did similar things, but with confusing names, so unify them as REPACK. The old commands have been retained for compatibility. +The two former commands did similar things, but with confusing names, so unify them as REPACK. @@ -1850 +1860 @@ Author: Tom Lane -Allow CREATE SCHEMA to create more types of objects in newly-created schemas (Kirill Reshke, Jian He, Tom Lane) +Allow CREATE SCHEMA to create more types of non-schema objects (Kirill Reshke, Jian He, Tom Lane) @@ -1901 +1911 @@ Author: Masahiko Sawada -Add memory usage and parallelism reporting to VACUUM (VERBOSE) and autovacuum logs (Tatsuya Kawata, Daniil Davydov) +Add memory usage and parallelism reporting to VACUUM (VERBOSE) and autovacuum logs (Tatsuya Kawata, Daniil Davydov) @@ -1999,2 +2008,0 @@ Author: Andrew Dunstan -Author: Andrew Dunstan -2026-03-20 [4c0390ac5] Add option force_array for COPY JSON FORMAT @@ -2006,0 +2015,11 @@ Allow COPY TO to output + + + + + + +Allow COPY TO in JSON format to output its results as a single JSON array (Joe Conway, Jian He) @@ -2011 +2030 @@ Allow COPY TO to output JSON output can also be a single JSON array using the COPY option FORCE_ARRAY. +The COPY option is FORCE_ARRAY. @@ -2066 +2085 @@ Author: Michael Paquier -Add WAL full-page write bytes reporting to EXPLAIN (ANALYZE, WAL) output (Shinya Kato) +Add WAL full page write bytes reporting to EXPLAIN (ANALYZE, WAL) (Shinya Kato) @@ -2083 +2102 @@ Add Memoize cache and lookup estimates to E -This can show why Memoize was chosen. +This will help illustrate why Memoize was chosen. @@ -2104 +2123 @@ Author: Michael Paquier -Add the 64-bit unsigned data type oid8 (Michael Paquier) +Add the 64-bit unsigned data type oid8 (Michael Paquier) @@ -2116 +2135 @@ Author: Andrew Dunstan -Add more jsonpath string methods (Florents Tselai, David E. Wheeler) +Add more jsonpath string methods (Florents Tselai, David E. Wheeler) @@ -2121 +2140 @@ Add more jsonpath string m -They are ltrim(), rtrim(), btrim(), lower(), upper(), initcap(), replace(), and split_part(). These are immutable like their non-JSON string variants. +They are l/r/btrim(), lower(), upper(), initcap(), replace(), and split_part(). These are immutable like their non-JSON string variants. @@ -2132 +2151 @@ Author: Masahiko Sawada -Allow casts between bytea and uuid data types (Dagfinn Ilmari Mannsåker, Aleksander Alekseev) +Allow casts between bytea and uuid data types (Dagfinn Ilmari Mannsåker, Aleksander Alekseev) @@ -2144 +2163 @@ Author: Nathan Bossart -Add ability to cast between database names and oid8s using regdatabase (Ian Lawrence Barwick) +Add ability to cast between database names and oids using regdatabase (Ian Lawrence Barwick) @@ -2156 +2175 @@ Author: Andres Freund -Add functions tid_block() and tid_offset() to extract block numbers and offsets from tid values (Ayush Tiwari) +Add functions tid_block() and tid_offset() to extract block numbers and offsets from tid values (Ayush Tiwari) @@ -2178 +2197 @@ Author: Dean Rasheed -Add date, timestamp, and timestamptz versions of random(min, max) (Damien Clochard, Dean Rasheed) +Add date, timestamp, and timestamptz versions of random(min, max) (Damien Clochard, Dean Rasheed) @@ -2195 +2214 @@ Author: Daniel Gustafsson -Allow encode() and decode() to process data in base64url and base32hex formats (Andrey Borodin, Aleksander Alekseev, Florents Tselai) +Allow encode() and decode() to process data in base64url and base32hex formats (Andrey Borodin, Aleksander Alekseev, Florents Tselai) @@ -2202 +2221 @@ Allow encode()base32. +This format retains ordering, unlike base32. @@ -2241 +2260 @@ Author: Andrew Dunstan -Allow IS JSON to work on domains defined over supported base types (Jian He) +Allow IS JSON to work on domains defined over supported base types (Jian He) @@ -2246 +2265 @@ Allow IS JSON t -The supported base types are TEXT, JSON, JSONB, and BYTEA. +The supported base types are TEXT, JSON, JSONB, and BYTEA. @@ -2257 +2276 @@ Author: Tom Lane -Add full text stemmers for Polish and Esperanto (Tom Lane) +Add full text stemmers for Polish and Esperanto (Tom Lane) @@ -2262 +2281 @@ Add full text stemmers for -The Dutch stemmer has also been updated. The old Dutch stemmer is available via dutch_porter. +The Dutch stemmer has also been updated. The old Dutch stemmer is available via dutch_porter. @@ -2329 +2348 @@ Author: Michael Paquier -Allow libpq connections to specify a service file via servicefile (Torsten Förtsch, Ryo Kanbayashi) +Allow libpq connections to specify a service file via servicefile (Torsten Förtsch, Ryo Kanbayashi) @@ -2365 +2384 @@ Author: Jacob Champion -Add libpq connection parameter oauth_ca_file to specify the OAUTH certificate authority file (Jonathan Gonzalez V., Jacob Champion) +Add libpq connection setting oauth_ca_file to specify the OAUTH certificate authority file (Jonathan Gonzalez V., Jacob Champion) @@ -2370 +2389 @@ Add libpq connection parameter PGOAUTHCAFILE environment variable. The default is to use curl's built-in certificates. +This can also be set via the PGOAUTHCAFILE environment variable. The default is to use curl's built-in certificates. @@ -2381 +2400 @@ Author: Jacob Champion -Allow custom OAUTH validators to register custom pg_hba.conf authentication options (Jacob Champion) +Allow custom OAUTH validators to register custom pg_hba.conf authentication options (Jacob Champion) @@ -2409 +2428 @@ Author: Jacob Champion -Allow libpq environment variable PGOAUTHDEBUG to specify particular debug options (Zsolt Parragi, Jacob Champion) +Allow libpq environment variable PGOAUTHDEBUG to specify particular debug options (Zsolt Parragi, Jacob Champion) @@ -2433 +2452 @@ Author: Nathan Bossart -Allow the search path to appear in the psql prompt via %S (Florents Tselai) +Allow the search path to appear in the psql prompt via %S (Florents Tselai) @@ -2438 +2457 @@ Allow the search path to appear in the psq -This works when psql is connected to PostgreSQL 18 or later. +This works when psql is connected to Postgres 18 or later. @@ -2449 +2468 @@ Author: Fujii Masao -Allow the hot standby status to appear in the psql prompt via %i (Jim Jones) +Allow the hot standby status to appear in the psql prompt via %i (Jim Jones) @@ -2466 +2485 @@ Modify psql backslash -The modified commands are \dRp+, \dRs+, and \dX+. +The modified commands are \dRp+, \dRs+, and \dX+. @@ -2482 +2501 @@ Allow control over how booleans are displayed in display_true and display_false. +The \pset variables are display_true and display_false. @@ -2493 +2512 @@ Author: Michael Paquier -Add psql variable SERVICEFILE to reference the service file location (Ryo Kanbayashi) +Add psql variable SERVICEFILE to reference the service file location (Ryo Kanbayashi) @@ -2505 +2524 @@ Author: Tom Lane -Allow psql to more accurately determine if the pagerl is needed (Erik Wienhold) +Allow psql to more accurately determine if the pager is needed (Erik Wienhold) @@ -2543 +2562,2 @@ Author: Álvaro Herrera -Add or improve psql tab completion (Yamaguchi Atsuo, Yugo Nagata, Haruna Miwa, Xuneng Zhou, Dagfinn Ilmari Mannsåker, Fujii Masao, Álvaro Herrera, Jian He, Tatsuya Kawata, Ian Lawrence Barwick, Vasuki M) +Add or improve psql tab completion (Yamaguchi Atsuo, Yugo Nagata, Haruna Miwa, Xuneng Zhou, Yugo Nagata, Dagfinn Ilmari Mannsåker, Fujii Masao, Álvaro Herrera, Jian He, Fujii Masao, +Tatsuya Kawata, Ian Lawrence Barwick, Vasuki M) @@ -2572,2 +2591,0 @@ Author: Fujii Masao -Author: Fujii Masao -2026-06-03 [95b6ec52e] vacuumdb: Fix - -analyze-in-stages skipping partitioned t @@ -2578 +2596 @@ Author: Fujii Masao -Change vacuumdb's and options to analyze partitioned tables when no targets are specified (Laurenz Albe, Mircea Cadariu, Chao Li) +Change vacuumdb's option to analyze partitioned tables when no targets are specified (Laurenz Albe, Mircea Cadariu) @@ -2580 +2597,0 @@ Change vacuumdb's -§ @@ -2607 +2624 @@ Author: Andrew Dunstan -Allow pg_verifybackup to read WAL files stored in tar archives (Amul Sul) +Allow pg_verifybackup to read WAL files stored in tar archives (Amul Sul) @@ -2623 +2640 @@ Author: Andrew Dunstan -Allow pg_waldump to read WAL files stored in tar archives (Amul Sul) +Allow pg_waldump to read WAL files stored in tar archives (Amul Sul) @@ -2628,41 +2644,0 @@ Allow pg_waldump to - - - - -Improve performance of pg_upgrade copying large object metadata (Nathan Bossart) -§ -§ -§ -§ - - - -Various methods are used, depending on the PostgreSQL version of the old cluster. - - - - - - - -Allow pg_upgrade to process non-default tablespaces stored in the PGDATA directory (Nathan Bossart) -§ - - - -Previously such tablespaces generated an error. - - - @@ -2724 +2700 @@ Allow pg_dumpallcustom, directory, or tar. +The new output formats are custom, directory, or tar. @@ -2744,2 +2720,73 @@ Allow pg_dump to in - - <link linkend="app-pgcreatesubscriber"><application>pg_createsubscriber</application></link> + + <xref linkend="pgupgrade"/> + + + + + + +Have pg_upgrade copy large object metadata files rather than using COPY (Nathan Bossart) +§ +§ + + + +This is possible when upgrading from Postgres 16 and later. + + + + + + + +Allow pg_upgrade to use COPY for large object metadata (Nathan Bossart) +§ + + + +This is used when upgrading from Postgres major versions 12-15. + + + + + + + +Improve pg_upgrade performance when restoring large object metadata for origin servers version 11 and earlier (Nathan Bossart) +§ + + + + + + + +Allow pg_upgrade to process non-default tablespaces stored in the PGDATA directory (Nathan Bossart) +§ + + + +Previously such tablespaces generated an error. + + + + + + + + + Logical Replication Applications @@ -2811 +2858 @@ Author: Tom Lane -Restore support for AIX (Aditya Kamath, Srirama Kucherlapati, Peter Eisentraut) +Restore support for AIX (Aditya Kamath, Srirama Kucherlapati, Peter Eisentraut) @@ -2817 +2864 @@ Restore support for Solaris to use unnamed POSIX semaphores (Tom Lane) +Change Solaris to use unnamed POSIX semaphores (Tom Lane) @@ -2844 +2891 @@ Author: Peter Eisentraut -Require Visual Studio 2019 or later (Peter Eisentraut) +Require Visual Studio 2019 or later (Peter Eisentraut) @@ -2856 +2903 @@ Author: Peter Eisentraut -Allow MSVC to create PL/Python using the Python Limited API (Bryan Green) +Allow MSVC to create PL/Python using the Python Limited API (Bryan Green) @@ -2868 +2915 @@ Author: Nathan Bossart -Allow building on AArch64 using MSVC (Niyas Sait, Greg Burd, Dave Cramer) +Allow building on AArch64 using MSVC (Niyas Sait, Greg Burd, Dave Cramer) @@ -2880 +2927 @@ Author: Álvaro Herrera -Allow execution stack backtraces on Windows using DbgHelp (Bryan Green) +Allow execution stack backtraces on Windows using DbgHelp (Bryan Green) @@ -2923 +2970 @@ Author: John Naylor -Use AVX2 CPU instructions for calculating page checksums (Matthew Sterrett, Andrew Kim) +Use AVX2 CPU instructions for calculating page checksums (Matthew Sterrett, Andrew Kim) @@ -2959 +3006 @@ Author: Peter Eisentraut -Require Meson version 0.57.2 or later (Peter Eisentraut) +Require Meson version 0.57.2 or later (Peter Eisentraut) @@ -2971 +3018 @@ Author: Peter Eisentraut -Add Meson option to build both shared and static libraries, or only shared (Peter Eisentraut) +Add Meson option to build both shared and static libraries, or only shared (Peter Eisentraut) @@ -2983 +3030 @@ Author: Peter Eisentraut -Update Unicode data to version 17.0.0 (Peter Eisentraut) +Update Unicode data to version 17.0.0 (Peter Eisentraut) @@ -2997 +3044 @@ Author: Robert Haas -Add hooks planner_setup_hook, planner_shutdown_hook, joinrel_setup_hook, and join_path_setup_hook (Robert Haas) +Add hooks planner_setup_hook, planner_shutdown_hook, joinrel_setup_hook, and join_path_setup_hook (Robert Haas) @@ -3010 +3057 @@ Author: Tom Lane -Allow extensions to replace set-returning functions in the FROM clause with SQL queries (Paul A. Jungwirth) +Allow extensions to replace set-returning functions in the FROM clause with SQL queries (Paul A. Jungwirth) @@ -3022 +3069 @@ Author: Heikki Linnakangas -Make multixid members 64-bit (Maxim Orlov) +Make multixid members 64-bit (Maxim Orlov) @@ -3034 +3081 @@ Author: Nathan Bossart -Change function prototypes to use uint* instead of bit* typedefs (Nathan Bossart) +Change function prototypes to use uint* instead of bit* typedefs (Nathan Bossart) @@ -3046 +3093 @@ Author: Álvaro Herrera -Allow logical decoding plugins to specify if they do not access shared catalogs (Antonin Houska) +Allow logical decoding plugins to specify if they do not access shared catalogs (Antonin Houska) @@ -3080,2 +3127,2 @@ Add server variable debug_exec_b -Author: Peter Eisentraut -2025-11-05 [e4d8a2af0] doc: Add section for temporal tables +Author: Michael Paquier +2026-03-12 [02976b0a1] doc: Document variables for path substitution in SQL tes @@ -3086,2 +3133,2 @@ Author: Peter Eisentraut -Add documentation section about temporal tables (Paul A. Jungwirth) -§ +Document the environment variables that control the regression tests (Michael Paquier) +§ @@ -3092,2 +3139,2 @@ Add documentation section about temporal tab -Author: Michael Paquier -2026-03-12 [02976b0a1] doc: Document variables for path substitution in SQL tes +Author: Peter Eisentraut +2025-11-05 [e4d8a2af0] doc: Add section for temporal tables @@ -3098,2 +3145,2 @@ Author: Michael Paquier -Document the environment variables that control the regression tests (Michael Paquier) -§ +Add documentation section about temporal tables (Paul A. Jungwirth) +§ @@ -3110 +3157 @@ Author: Peter Eisentraut -Update documented systemd example to include a restart setting (Andrew Jackson) +Update documented systemd example to include a restart setting (Andrew Jackson) @@ -3153,28 +3199,0 @@ Add extension to allow per-query-id advice to be - - - - -Show sizes of FETCH queries as constants in (Sami Imseih) -§ - - - -Fetches of different sizes will now be grouped together in output. - - - - - - - -Add generic and custom plan counts to (Sami Imseih) -§ - - - @@ -3221 +3240 @@ Author: Alexander Korotkov -Allow pushdown of array comparisons in prepared statements to foreign servers (Alexander Pyhalov) +Allow pushdown of array comparisons in prepared statements to foreign servers (Alexander Pyhalov) @@ -3233 +3252 @@ Author: Etsuro Fujita -Allow the retrieval of statistics from foreign data wrapper servers (Corey Huinker, Etsuro Fujita) +Allow the retrieval of statistics from foreign data wrapper servers (Corey Huinker, Etsuro Fujita) @@ -3238 +3257 @@ Allow the retrieval of statistics from by using the option restore_stats. The default is for ANALYZE to retrieve rows from the remote server to locally generate statistics. +This is enabled for by using the option restore_stats. The default is for ANALYZE to retrieve rows from the remote server to locally generate statistics. @@ -3330 +3349 @@ Author: Peter Eisentraut -Allow 's dmetaphone() to use single-byte encodings beyond ASCII (Peter Eisentraut) +Allow 's dmetaphone to use single-byte encodings beyond ASCII (Peter Eisentraut) @@ -3348,0 +3368,36 @@ Modify oid2name + <xref linkend="pgstatstatements"/> + + + + + + +Show sizes of FETCH queries as constants in (Sami Imseih) +§ + + + +Fetches of different sizes will now be grouped together in output. + + + + + + + +Add generic and custom plans counts to (Sami Imseih) +§ + + + + + + + diff --git a/doc/src/sgml/replication-origins.sgml b/doc/src/sgml/replication-origins.sgml index bb0fb624d25..a8b0f6f4599 100644 --- a/doc/src/sgml/replication-origins.sgml +++ b/doc/src/sgml/replication-origins.sgml @@ -86 +86 @@ - output plugin callbacks (see ) + diff --git a/doc/src/sgml/rowtypes.sgml b/doc/src/sgml/rowtypes.sgml index 0d2c1721ff3..c3e917b7005 100644 --- a/doc/src/sgml/rowtypes.sgml +++ b/doc/src/sgml/rowtypes.sgml @@ -132,2 +132 @@ CREATE TABLE inventory_item ( - the generic type constants discussed in . The constant is initially + . The constant is initially @@ -155,2 +154 @@ ROW('', 42, NULL) - The ROW expression syntax is discussed in more detail in . + For more detail, see . diff --git a/doc/src/sgml/rules.sgml b/doc/src/sgml/rules.sgml index 7f23962f524..368c384377e 100644 --- a/doc/src/sgml/rules.sgml +++ b/doc/src/sgml/rules.sgml @@ -309,2 +309 @@ CREATE RULE "_RETURN" AS ON SELECT TO myview DO INSTEAD - despite its lack of underlying storage. - This is discussed further below, in + despite its lack of underlying storage; see @@ -861,2 +860,2 @@ SELECT t1.a, t2.b, t1.ctid FROM t1, t2 WHERE t1.a = t2.a; - that updates one or more tables, rather than views. That is the topic - of . Note that this will not work with + that updates one or more tables, rather than views + (see ). Note that this will not work with diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml index dfa292c2c3a..6d0a3813831 100644 --- a/doc/src/sgml/runtime.sgml +++ b/doc/src/sgml/runtime.sgml @@ -82 +82 @@ - information about creating new databases within a cluster.) + more information.) @@ -137,2 +137 @@ - using pg_ctl for starting and stopping the - server (see ), so + using pg_ctl for , so @@ -193 +192,2 @@ postgres$ initdb -D /usr/local/pgsql/data - client authentication setup allows any local user to connect to the + setup allows any local user to + connect to the @@ -208,2 +208 @@ postgres$ initdb -D /usr/local/pgsql/data - or file system permissions to restrict connections. See for more information.) + or file system permissions to restrict connections.) @@ -217,2 +216,2 @@ postgres$ initdb -D /usr/local/pgsql/data - specify a different locale for the database; more information about - that can be found in . The default sort order used + specify a different locale for the database; for more information, + see . The default sort order used @@ -231 +230 @@ postgres$ initdb -D /usr/local/pgsql/data - locale setting. For details see . + locale setting; for more information, see . @@ -380,2 +379 @@ $ postgres -D /usr/local/pgsql/data >logfile 2>&1 & for a more thorough discussion of log - file handling.) + linkend="logfile-maintenance"/> for more information.) @@ -726 +724,2 @@ psql: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such - the server will refuse to start and + the server will refuse to start (see ) and @@ -728,2 +727 @@ psql: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: No such - and what to do about it. (See also .) The relevant kernel + and what to do about it. The relevant kernel @@ -1690,2 +1688,2 @@ $ kill -INT `head -1 /usr/local/pgsql/data/postmaster.pid`); pay particular attention to the section + All user-visible changes are listed in ; pay particular attention to the section @@ -2370,3 +2368,2 @@ pg_dumpall -p 5432 | psql -d postgres -p 5433 - Note that certificate chain validation is always ensured when the - cert authentication method is used - (see ). + Note that always ensures certificate chain + validation. @@ -2398,2 +2395,2 @@ pg_dumpall -p 5432 | psql -d postgres -p 5433 - The first approach makes use of the cert authentication - method for hostssl entries in pg_hba.conf, + The first approach makes use of for + hostssl entries in pg_hba.conf, @@ -2401 +2398 @@ pg_dumpall -p 5432 | psql -d postgres -p 5433 - providing ssl connection security. See for details. + providing ssl connection security. @@ -2762,2 +2759 @@ openssl x509 -req -in server.csr -text -days 365 \ - that which is necessary for GSSAPI authentication. (For more information - on configuring that, see .) + that which is necessary for . diff --git a/doc/src/sgml/sepgsql.sgml b/doc/src/sgml/sepgsql.sgml index ddac6253557..7250c3b892c 100644 --- a/doc/src/sgml/sepgsql.sgml +++ b/doc/src/sgml/sepgsql.sgml @@ -19,3 +19,3 @@ - The current implementation has significant limitations, and does not - enforce mandatory access control for all actions. See - . + The current implementation has significant + , and does not + enforce mandatory access control for all actions. diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml index 760f9b69d47..e5fe1bf68fb 100644 --- a/doc/src/sgml/sources.sgml +++ b/doc/src/sgml/sources.sgml @@ -436,2 +436 @@ ereport(level, errmsg_internal("format string", ...)); - Advice about writing good error messages can be found in - . + For more information, see . diff --git a/doc/src/sgml/spgist.sgml b/doc/src/sgml/spgist.sgml index 6af93719b84..ebc0db0ed46 100644 --- a/doc/src/sgml/spgist.sgml +++ b/doc/src/sgml/spgist.sgml @@ -235,3 +235,3 @@ - value. (Alternatively, an operator class can omit the node labels, if it - works with a fixed set of nodes for all inner tuples; - see .) + value. (Alternatively, an operator class can omit + , + if it works with a fixed set of nodes for all inner tuples.) @@ -614 +614,2 @@ typedef struct spgPickSplitOut - allTheSame to signify that this has happened. The + allTheSame to signify that this has happened; see + for more information. The @@ -617 +617,0 @@ typedef struct spgPickSplitOut - See for more information. diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml index 0263a700591..3e1c4383c77 100644 --- a/doc/src/sgml/start.sgml +++ b/doc/src/sgml/start.sgml @@ -33 +33 @@ - for instructions on installation, and return to + and return to diff --git a/doc/src/sgml/storage.sgml b/doc/src/sgml/storage.sgml index 6b6377503bf..25514c7da21 100644 --- a/doc/src/sgml/storage.sgml +++ b/doc/src/sgml/storage.sgml @@ -209,2 +209,2 @@ is the filenode number. In either case, in addition to the main file (a/k/a -main fork), each table and index has a free space map (see ), which stores information about free space available in +main fork), each table and index has a , which +stores information about free space available in @@ -213,5 +213,7 @@ number plus the suffix _fsm. Tables also have a -visibility map, stored in a fork with the suffix _vm, -to track which pages are known to have no dead tuples. The visibility map is -described further in . Unlogged tables and indexes -have a third fork, known as the initialization fork, which is stored in a fork -with the suffix _init (see ). +, stored in a fork with the suffix +_vm, +to track which pages are known to have no dead tuples. Unlogged tables and +indexes +have a third fork, known as , +which is stored in a fork +with the suffix _init. @@ -249 +251,2 @@ A table that has columns with potentially large entries will have an -associated TOAST table, which is used for out-of-line storage of +associated table, which is used for out-of-line +storage of @@ -253 +255,0 @@ its TOAST table, if any. -See for more information. @@ -399 +401 @@ when a tuple to be stored on disk is too large to be stored as-is. -Further details appear in . +see . @@ -401 +403,2 @@ Alternatively, a TOAST pointer datum can contain a pointer to -out-of-line data that appears elsewhere in memory. Such datums are +out-of-line data that appears elsewhere in memory, as described in +. Such datums are @@ -404 +406,0 @@ useful for avoiding copying and redundant processing of large data values. -Further details appear in . @@ -1073,2 +1075,2 @@ data. Empty in ordinary tables. - inline or in a TOAST table; - it might be compressed, too (see ). + inline or in a table; + it might be compressed, too. diff --git a/doc/src/sgml/stylesheet-common.xsl b/doc/src/sgml/stylesheet-common.xsl index a2e3db67a32..437073bf725 100644 --- a/doc/src/sgml/stylesheet-common.xsl +++ b/doc/src/sgml/stylesheet-common.xsl @@ -44 +44 @@ - + diff --git a/doc/src/sgml/stylesheet-html-common.xsl b/doc/src/sgml/stylesheet-html-common.xsl index 9dcf96c02e5..f5dc440f0ef 100644 --- a/doc/src/sgml/stylesheet-html-common.xsl +++ b/doc/src/sgml/stylesheet-html-common.xsl @@ -676,0 +677,15 @@ set toc,title + + + + + + + + + + + + + + + diff --git a/doc/src/sgml/syntax.sgml b/doc/src/sgml/syntax.sgml index 67482996861..264e727764a 100644 --- a/doc/src/sgml/syntax.sgml +++ b/doc/src/sgml/syntax.sgml @@ -102 +102 @@ INSERT INTO MY_TABLE VALUES (3, 'hi there'); - key words, that is, words that have a fixed + , that is, words that have a fixed @@ -111,2 +110,0 @@ INSERT INTO MY_TABLE VALUES (3, 'hi there'); - A complete list of key words can be found in . @@ -435,4 +433,3 @@ SELECT 'foo' 'bar'; - A useful alternative is to use Unicode escapes or the - alternative Unicode escape syntax, explained - in ; then the server - will check that the character conversion is possible. + A useful alternative is to use + ; + then the server will check that the character conversion is possible. @@ -889,2 +886 @@ CAST ( 'string' AS type ) - of an array. See for more information - on arrays. + of an array. See for more information. @@ -912,2 +908,2 @@ CAST ( 'string' AS type ) - slices from arrays. (See .) In certain SQL dialects (such as Embedded + slices from . In certain SQL + dialects (such as Embedded @@ -1284,2 +1280 @@ SELECT 3 OPERATOR(pg_catalog.+) 4; - rules. These generally have the semantics of a function or - operator and are explained in the appropriate location in for more about arrays. + See for more information. @@ -1622,2 +1617,2 @@ sqrt(2) - has the same syntax as for a query-level ORDER BY clause, as - described in , except that its expressions + has the same syntax as , except that its + expressions @@ -1748 +1743 @@ FROM generate_series(1,10) AS s(i); - The predefined aggregate functions are described in .) + error; see .) @@ -2201 +2196 @@ SELECT * FROM tbl WHERE (a > 'foo') COLLATE "C"; - row with one column. (See for information about writing queries.) + row with one column. (See .) @@ -2210 +2205 @@ SELECT * FROM tbl WHERE (a > 'foo') COLLATE "C"; - See also for other expressions involving subqueries. + See also . @@ -2252,2 +2247,2 @@ SELECT ARRAY[1,2,3+4]; - determined using the same rules as for UNION or - CASE constructs (see ). + determined using the same rules as for + . @@ -2265 +2260 @@ SELECT ARRAY[1,2,22.7]::integer[]; - For more on casting, see . + For more information, see . @@ -2355 +2350 @@ SELECT ARRAY(SELECT ARRAY[i, i*2] FROM generate_series(1,5) AS a(i)); - always begin with one. For more information about arrays, see + always begin with one. For more information, see @@ -2462 +2457 @@ SELECT getf1(CAST(ROW(11,'this is a test',2.5) AS myrowtype)); - using the standard comparison operators as described in , and to - use them in connection with subqueries, as discussed in , and to + use them in connection with subqueries, with CASE - construct (see ) can be + When it is essential to force evaluation order, + can be diff --git a/doc/src/sgml/system-views.sgml b/doc/src/sgml/system-views.sgml index 2ebec6928d5..650c2f33599 100644 --- a/doc/src/sgml/system-views.sgml +++ b/doc/src/sgml/system-views.sgml @@ -17 +17 @@ - The information schema () provides + provides @@ -1325,2 +1325 @@ AND c1.path[c2.level] = c2.path[c2.level]; - See for more information about the various - ways to change run-time parameters. + See for more information. @@ -1556,2 +1555 @@ AND c1.path[c2.level] = c2.path[c2.level]; - See for more information about - client authentication configuration. + See for more information. @@ -1677,2 +1675 @@ AND c1.path[c2.level] = c2.path[c2.level]; - See for more information about - client authentication configuration. + See for more information. @@ -2821 +2818 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - For more on replication slots, + For more information, @@ -3049,2 +3046,2 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - indicates the time when slot synchronization (see ) + indicates the time when @@ -3312,2 +3309 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - Role bypasses every row-level security policy, see - for more information. + Role bypasses all . @@ -4134,2 +4130 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - User bypasses every row-level security policy, see - for more information. + User bypasses all . @@ -4184,2 +4179 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - allocated by extensions using the mechanisms detailed in - . + allocated by extensions using . @@ -4280,2 +4274,2 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - by extensions using the mechanisms detailed in - . This view will output multiple rows + by extensions using . This view will + output multiple rows @@ -5500,2 +5494 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx - User bypasses every row-level security policy, see - for more information. + User bypasses all . diff --git a/doc/src/sgml/tableam.sgml b/doc/src/sgml/tableam.sgml index 9ccf5b739ed..a1e02b58ce1 100644 --- a/doc/src/sgml/tableam.sgml +++ b/doc/src/sgml/tableam.sgml @@ -117,2 +117 @@ my_tableam_handler(PG_FUNCTION_ARGS) - PostgreSQL's standard page layout as described in - . + PostgreSQL's . diff --git a/doc/src/sgml/tablesample-method.sgml b/doc/src/sgml/tablesample-method.sgml index c821941b71b..a0818bda136 100644 --- a/doc/src/sgml/tablesample-method.sgml +++ b/doc/src/sgml/tablesample-method.sgml @@ -33,4 +33,4 @@ method_name(internal) RETURNS tsm_handler - type TsmRoutine, which contains pointers to support functions for - the sampling method. These support functions are plain C functions and - are not visible or callable at the SQL level. The support functions are - described in . + type TsmRoutine, which contains pointers to + + for the sampling method. These support functions are plain C functions and + are not visible or callable at the SQL level. diff --git a/doc/src/sgml/textsearch.sgml b/doc/src/sgml/textsearch.sgml index d6d2ddeaacc..bbe6d4e8657 100644 --- a/doc/src/sgml/textsearch.sgml +++ b/doc/src/sgml/textsearch.sgml @@ -164,2 +164 @@ - functions and operators available for these data types - (), the most important of which is + , the most important of which is @@ -263 +262,2 @@ SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::t - As the above example suggests, a tsquery is not just raw + As the above example suggests, a is not + just raw @@ -267 +267 @@ SELECT 'fat & cow'::tsquery @@ 'a fat cat sat on a mat and ate a fat rat'::t - (For syntax details see .) There are + There are @@ -576 +576 @@ CREATE INDEX pgweb_idx ON pgweb USING GIN (to_tsvector('english', body)); - be used in expression indexes (). + be used in . @@ -729 +729 @@ SELECT to_tsvector('english', 'a fat cat sat on a mat - it ate a fat rats'); - dictionaries () is consulted, + is consulted, @@ -736 +736 @@ SELECT to_tsvector('english', 'a fat cat sat on a mat - it ate a fat rats'); - stop words (), which + , which @@ -822,2 +822,2 @@ to_tsquery( config - tsquery input, as described in . The difference is that while basic + input. The difference is that while basic @@ -1770 +1770 @@ SELECT querytree(to_tsquery('!defined')); - and thesaurus dictionaries (). + and . @@ -2594,2 +2594,2 @@ SELECT ts_lexize('public.simple_dict', 'The'); - word with a synonym. Phrases are not supported (use the thesaurus - template () for that). A synonym + word with a synonym. Phrases are not supported (use + for that). A synonym @@ -3246,2 +3246 @@ CREATE TEXT SEARCH DICTIONARY english_stem ( - is available, and there are several psql commands that display information - about text search objects (). + is available, and there is also . @@ -3515,2 +3514,2 @@ SELECT * FROM ts_debug('public.english', 'The Brightest supernovaes'); - english_ispell dictionary as a stop word () and will not be indexed. + english_ispell dictionary as + and will not be indexed. diff --git a/doc/src/sgml/trigger.sgml b/doc/src/sgml/trigger.sgml index 8a5e7278212..025f696a9cf 100644 --- a/doc/src/sgml/trigger.sgml +++ b/doc/src/sgml/trigger.sgml @@ -14,4 +14,4 @@ - PL/pgSQL (), - PL/Tcl (), - PL/Perl (), and - PL/Python (). + , + , + , and + . @@ -507 +507 @@ - Further information about data visibility rules can be found in + Further information can be found in diff --git a/doc/src/sgml/typeconv.sgml b/doc/src/sgml/typeconv.sgml index 96aa02e4fab..a699f248780 100644 --- a/doc/src/sgml/typeconv.sgml +++ b/doc/src/sgml/typeconv.sgml @@ -30,2 +30 @@ Refer to the relevant sections in and , since that will determine @@ -218 +216,0 @@ should use this new function and no longer do implicit conversion to use the old - See for more information. @@ -230 +228 @@ considered are those with the matching name and argument count that are -visible in the current search path (see ). +visible in . @@ -505,2 +503,2 @@ and range inclusion (anyelement <@ anyr -Since none of these polymorphic pseudo-types (see ) are considered preferred, the parser cannot +Since none of these are considered preferred, the parser cannot @@ -580 +578 @@ considered are those with the matching name and argument count that are -visible in the current search path (see ). +visible in . diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml index 0ec32700bd4..005dfa83f57 100644 --- a/doc/src/sgml/user-manag.sgml +++ b/doc/src/sgml/user-manag.sgml @@ -26,2 +26 @@ - More information about the effects of role privileges on various - database objects can be found in . + More information can be found in . @@ -132,2 +131,2 @@ SELECT rolname FROM pg_roles WHERE rolcanlogin; - is determined by the client authentication setup, as explained in - . (Thus, a client is not + is determined by . (Thus, a client is + not @@ -138,2 +137,2 @@ SELECT rolname FROM pg_roles WHERE rolcanlogin; - client, it is important to carefully configure privileges when setting up - a multiuser environment. + client, it is important to carefully configure privileges when setting up a + multiuser environment. @@ -314 +313 @@ CREATE USER name; - configuration settings described in . + session, as described in . @@ -782,3 +781,3 @@ GRANT pg_signal_backend TO admin_user; - cancel a query or terminate its session. Note that this role does not - permit signaling backends owned by a superuser. See - . + cancel a query or terminate its session (see + ). Note that this role does not + permit signaling backends owned by a superuser. diff --git a/doc/src/sgml/uuid-ossp.sgml b/doc/src/sgml/uuid-ossp.sgml index acd20a51f01..f1b2bed2603 100644 --- a/doc/src/sgml/uuid-ossp.sgml +++ b/doc/src/sgml/uuid-ossp.sgml @@ -16 +16 @@ - linkend="functions-uuid"/> for built-in ways to generate UUIDs. + linkend="functions-uuid"/>. diff --git a/doc/src/sgml/vacuumlo.sgml b/doc/src/sgml/vacuumlo.sgml index 26b764d54b7..1c094b20c27 100644 --- a/doc/src/sgml/vacuumlo.sgml +++ b/doc/src/sgml/vacuumlo.sgml @@ -196,2 +196,2 @@ - also uses the environment variables supported by libpq - (see ). + also uses the supported by + libpq. diff --git a/doc/src/sgml/wal.sgml b/doc/src/sgml/wal.sgml index 646076f7e39..c8814b66561 100644 --- a/doc/src/sgml/wal.sgml +++ b/doc/src/sgml/wal.sgml @@ -279 +279 @@ - + @@ -455,2 +455 @@ - WAL also makes it possible to support on-line - backup and point-in-time recovery, as described in WAL also makes it possible to support for general information about - setting server configuration parameters. + Consult for general information. @@ -760,2 +758 @@ - uses a replication slot will have the same effect (see - ). + uses will have the same effect. diff --git a/doc/src/sgml/xact.sgml b/doc/src/sgml/xact.sgml index 3aa7ee1383e..cb39d5c8150 100644 --- a/doc/src/sgml/xact.sgml +++ b/doc/src/sgml/xact.sgml @@ -102,2 +102,2 @@ - of multixact IDs (mxid; see ). + of + (mxid). diff --git a/doc/src/sgml/xaggr.sgml b/doc/src/sgml/xaggr.sgml index bdad8d3dc2b..4c12a85a775 100644 --- a/doc/src/sgml/xaggr.sgml +++ b/doc/src/sgml/xaggr.sgml @@ -165,2 +165 @@ CREATE AGGREGATE avg (float8) - and for information about use of - aggregate functions as window functions.) + and .) @@ -293,2 +292 @@ FROM (VALUES (1, 1.0e20::float8), - See - for an explanation of polymorphic functions. + See . @@ -386,2 +384,2 @@ CREATE AGGREGATE array_agg (anynonarray) - the same fashion as for regular functions; see - . The aggregate's transition + the same fashion as for . The + aggregate's transition diff --git a/doc/src/sgml/xfunc.sgml b/doc/src/sgml/xfunc.sgml index bae16d7fb53..b05d83c5074 100644 --- a/doc/src/sgml/xfunc.sgml +++ b/doc/src/sgml/xfunc.sgml @@ -18,2 +18 @@ - query language functions (functions written in - SQL) () + @@ -24 +23 @@ - procedural language functions (functions written in, for + (functions written in, for @@ -26 +24,0 @@ - () @@ -31 +29 @@ - internal functions () + @@ -36 +34 @@ - C-language functions () + @@ -240,3 +238,3 @@ CALL clean_emp(); - most convenient to use dollar quoting (see ) for the string constant. - If you choose to use regular single-quoted string constant syntax, + most convenient to use . + If you choose to use regular single-quoted + , @@ -245 +243 @@ CALL clean_emp(); - the function (see ). + the function. @@ -612,2 +610 @@ SELECT * FROM new_emp(); - The second way is described more fully in . + See . @@ -793 +790,3 @@ CALL tp1(17, 100.0, NULL); - When calling a procedure from PL/pgSQL, + When from + PL/pgSQL, @@ -795,2 +794 @@ CALL tp1(17, 100.0, NULL); - that will receive the procedure's output. See for details. + that will receive the procedure's output. @@ -1073,2 +1071 @@ SELECT * FROM sum_n_product_with_tab(10); - preferred way to do this is to use the LATERAL key word, - which is described in . + preferred way to do this is to use . @@ -1319 +1316 @@ $$ LANGUAGE SQL; - return the polymorphic types described in . If a collation is successfully identified + collations assigned to the actual arguments (see + ). If a collation is successfully identified @@ -1760,2 +1757,2 @@ CREATE FUNCTION test(int, int) RETURNS int - languages are generically called procedural - languages (PLs). + languages are generically called + (PLs). @@ -1765,2 +1761,0 @@ CREATE FUNCTION test(int, int) RETURNS int - See and following chapters for more - information. @@ -1788,2 +1783 @@ CREATE FUNCTION test(int, int) RETURNS int - server are declared during the initialization of the database cluster - (see ), + server are declared during , @@ -2675,2 +2669,2 @@ CREATE FUNCTION t_starts_with(text, text) RETURNS boolean - to return set results () and - implement trigger functions () and + to and + implement and @@ -2719,3 +2713 @@ CREATE FUNCTION t_starts_with(text, text) RETURNS boolean - requires special flags. See for a - detailed explanation of how to do it for your particular - operating system. + requires special flags. See . @@ -2807 +2799 @@ CREATE FUNCTION t_starts_with(text, text) RETURNS boolean - SPI (), and various hooks + , and various hooks @@ -2858,2 +2850,2 @@ CREATE FUNCTION t_starts_with(text, text) RETURNS boolean - changes will be communicated in the release notes (). + changes will be communicated in . @@ -2904,2 +2896,2 @@ CREATE FUNCTION t_starts_with(text, text) RETURNS boolean - Such changes will also be documented in the release notes (). + Such changes will also be documented in . @@ -3515 +3507 @@ CREATE OR REPLACE FUNCTION retcomposite(IN integer, IN integer, - return the polymorphic types described in ordering operators, - which typically don't return Boolean values; that feature is discussed - in .) + (Some index access methods also support + , + which typically don't return Boolean values.) @@ -412,2 +412 @@ - The requirements for these support functions are explained further in - . + See for requirements. @@ -518 +517,2 @@ - GiST indexes have twelve support functions, seven of which are optional, + have twelve support functions, seven of which are + optional, @@ -520 +519,0 @@ - (For more information see .) @@ -611 +610,2 @@ - SP-GiST indexes have six support functions, one of which is optional, as + have six support functions, one of which is + optional, as @@ -613 +612,0 @@ - (For more information see .) @@ -668 +667,2 @@ - GIN indexes have seven support functions, four of which are optional, + have seven support functions, four of which are + optional, @@ -670 +669,0 @@ - (For more information see .) @@ -745,2 +744,2 @@ - BRIN indexes have five basic support functions, one of which is optional, - as shown in . Some versions of + lists five basic + functions for BRIN indexes, one of which is optional. Some versions of @@ -827,2 +826,2 @@ - a set of operators. The procedure for defining operators was - discussed in . For an operator class on + a set of operators. See for the procedure. For an + operator class on @@ -1298 +1297 @@ SELECT * FROM mytable ORDER BY somecol USING ~<~; - for window functions (see ). + for . diff --git a/doc/src/sgml/xplang.sgml b/doc/src/sgml/xplang.sgml index 31d403c4806..13cb38ea34b 100644 --- a/doc/src/sgml/xplang.sgml +++ b/doc/src/sgml/xplang.sgml @@ -30,4 +30,4 @@ - PL/pgSQL (), - PL/Tcl (), - PL/Perl (), and - PL/Python (). + , + , + , and + . diff --git a/doc/src/sgml/xtypes.sgml b/doc/src/sgml/xtypes.sgml index df56d1c3ace..01a903ff71c 100644 --- a/doc/src/sgml/xtypes.sgml +++ b/doc/src/sgml/xtypes.sgml @@ -261,2 +261,2 @@ CREATE TYPE complex ( - usually desirable to make the data type TOAST-able (see ). You should do this even if the values are always + usually desirable to make the data type -able. + You should do this even if the values are always -- 2.53.0.windows.1