doc PG 18 relnotes: add links for server variables
authorBruce Momjian
Thu, 19 Jun 2025 01:19:42 +0000 (21:19 -0400)
committerBruce Momjian
Thu, 19 Jun 2025 01:20:04 +0000 (21:20 -0400)
doc/src/sgml/release-18.sgml

index ab83b1554001e82e09241de2519338ac7ab114b4..e89a86b1aa8134bc8387bdd0933f778892625bbd 100644 (file)
@@ -83,7 +83,7 @@ Change time zone abbreviation handling (Tom Lane)
 
 
 
-The system will now favor the current session's time zone abbreviations before checking the server variable <varname>timezone_abbreviations>. Previously timezone_abbreviations was
+The system will now favor the current session's time zone abbreviations before checking the server variable <xref linkend="guc-timezone-abbreviations"/>. Previously timezone_abbreviations was
 checked first.
 
 
@@ -101,7 +101,7 @@ Deprecate MD5 password authentication (Nathan Bossart)
 
 
 Support for MD5 passwords will be removed in a future major version release.  CREATE ROLE and ALTER ROLE now emit deprecation warnings when setting MD5 passwords.
-These warnings can be disabled by setting the <varname>md5_password_warnings> parameter to off.
+These warnings can be disabled by setting the <xref linkend="guc-md5-password-warnings"/> parameter to off.
 
 
 
@@ -263,7 +263,7 @@ Automatically remove some unnecessary table self-joins (Andrey Lepikhov, Alexand
 
 
 
-This optimization can be disabled using server variable <varname>enable_self_join_elimination>.
+This optimization can be disabled using server variable <xref linkend="guc-enable-self-join-elimination"/>.
 
 
 
@@ -324,7 +324,7 @@ Allow the keys of SELECT DISTINCT to be internally reordered
 
 
 
-This optimization can be disabled using <varname>enable_distinct_reordering>.
+This optimization can be disabled using <xref linkend="guc-enable-distinct-reordering"/>.
 
 
 
@@ -606,8 +606,8 @@ Add an asynchronous I/O subsystem (Andres Freund, Thomas Munro, Nazir Bilal Yavu
 
 
 This feature allows backends to queue multiple read requests, which allows for more efficient sequential scans, bitmap heap scans, vacuums, etc.
-This is enabled by server variable <varname>io_method, with server variables io_combine_limit and io_max_combine_limit> added to control it.  This also enables
-<varname>effective_io_concurrency and maintenance_io_concurrency> values greater than zero for systems without fadvise() support.  The new system view pg_aios shows the file handles being used
+This is enabled by server variable <xref linkend="guc-io-method"/>, with server variables  and > added to control it.  This also enables
+<xref linkend="guc-effective-io-concurrency"/> and > values greater than zero for systems without fadvise() support.  The new system view pg_aios shows the file handles being used
 for asynchronous I/O.
 
 
@@ -667,7 +667,7 @@ Allow normal vacuums to freeze some pages, even though they are all-visible (Mel
 
 
 
-This reduces the overhead of later full-relation freezing.  The aggressiveness of this can be controlled by server variable and per-table setting <varname>vacuum_max_eager_freeze_failure_rate>.
+This reduces the overhead of later full-relation freezing.  The aggressiveness of this can be controlled by server variable and per-table setting <xref linkend="guc-vacuum-max-eager-freeze-failure-rate"/>.
 Previously vacuum never processed all-visible pages until freezing was required.
 
 
@@ -679,7 +679,7 @@ Author: Nathan Bossart 
 
 
 
-Add server variable <varname>vacuum_truncate> to control file truncation during VACUUM (Nathan Bossart, Gurjeet Singh)
+Add server variable <xref linkend="guc-vacuum-truncate"/> to control file truncation during VACUUM (Nathan Bossart, Gurjeet Singh)
 §
 
 
@@ -697,7 +697,7 @@ Author: Melanie Plageman 
 
 
 
-Increase server variables <varname>effective_io_concurrency's and maintenance_io_concurrency>'s default values to 16 (Melanie Plageman)
+Increase server variables <xref linkend="guc-effective-io-concurrency"/>'s and >'s default values to 16 (Melanie Plageman)
 §
 §
 
@@ -723,7 +723,7 @@ Author: Melanie Plageman 
 
 
 
-Increase the logging granularity of server variable <varname>log_connections> (Melanie Plageman)
+Increase the logging granularity of server variable <xref linkend="guc-log-connections"/> (Melanie Plageman)
 §
 
 
@@ -751,7 +751,7 @@ Author: Tom Lane 
 
 
 
-Add <varname>log_line_prefix> escape %L to output the client IP address (Greg Sabino Mullane)
+Add <xref linkend="guc-log-line-prefix"/> escape %L to output the client IP address (Greg Sabino Mullane)
 §
 
 
@@ -763,7 +763,7 @@ Author: Fujii Masao 
 
 
 
-Add server variable <varname>log_lock_failures> to log lock acquisition failures (Yuki Seino)
+Add server variable <xref linkend="guc-log-lock-failures"/> to log lock acquisition failures (Yuki Seino)
 §
 
 
@@ -804,7 +804,7 @@ Add delay time reporting to VACUUM and ANALYZE
 
 
 This information appears in the autovacuum logs, the system views pg_stat_progress_vacuum and pg_stat_progress_analyze, and the output of VACUUM and ANALYZE when in VERBOSE
-mode; tracking must be enabled with the server variable <varname>track_cost_delay_timing>.
+mode; tracking must be enabled with the server variable <xref linkend="guc-track-cost-delay-timing"/>.
 
 
 
@@ -900,7 +900,7 @@ Author: Michael Paquier 
 
 
 
-Change server variable <varname>track_wal_io_timing> to control tracking WAL timing in pg_stat_io instead of pg_stat_wal (Bertrand Drouvot)
+Change server variable <xref linkend="guc-track-wal-io-timing"/> to control tracking WAL timing in pg_stat_io instead of pg_stat_wal (Bertrand Drouvot)
 §
 
 
@@ -1144,7 +1144,7 @@ Add support for the OAuth authentication method (Jacob Champion, Daniel Gustafss
 
 
 
-This adds an oauth authentication method to pg_hba.conf, libpq OAuth options, a server variable <varname>oauth_validator_libraries> to load token validation libraries, and
+This adds an oauth authentication method to pg_hba.conf, libpq OAuth options, a server variable <xref linkend="guc-oauth-validator-libraries"/> to load token validation libraries, and
 a configure flag  to add the required compile-time libraries.
 
 
@@ -1156,7 +1156,7 @@ Author: Daniel Gustafsson 
 
 
 
-Add server variable <varname>ssl_tls13_ciphers> to allow specification of multiple colon-separated TLSv1.3 cipher suites (Erica Zhang, Daniel Gustafsson)
+Add server variable <xref linkend="guc-ssl-tls13-ciphers"/> to allow specification of multiple colon-separated TLSv1.3 cipher suites (Erica Zhang, Daniel Gustafsson)
 §
 
 
@@ -1168,7 +1168,7 @@ Author: Daniel Gustafsson 
 
 
 
-Change server variable <varname>ssl_groups>'s default to include elliptic curve X25519 (Daniel Gustafsson, Jacob Champion)
+Change server variable <xref linkend="guc-ssl-groups"/>'s default to include elliptic curve X25519 (Daniel Gustafsson, Jacob Champion)
 §
 
 
@@ -1180,7 +1180,7 @@ Author: Daniel Gustafsson 
 
 
 
-Rename server variable ssl_ecdh_curve to <varname>ssl_groups> and allow multiple colon-separated ECDH curves to be specified (Erica Zhang, Daniel Gustafsson)
+Rename server variable ssl_ecdh_curve to <xref linkend="guc-ssl-groups"/> and allow multiple colon-separated ECDH curves to be specified (Erica Zhang, Daniel Gustafsson)
 §
 
 
@@ -1226,12 +1226,12 @@ Author: Nathan Bossart 
 
 
 
-Add server variable <varname>autovacuum_worker_slots> to specify the maximum number of background workers (Nathan Bossart)
+Add server variable <xref linkend="guc-autovacuum-worker-slots"/> to specify the maximum number of background workers (Nathan Bossart)
 §
 
 
 
-With this variable set, <varname>autovacuum_max_workers> can be adjusted at runtime up to this maximum without a server restart.
+With this variable set, <xref linkend="guc-autovacuum-max-workers"/> can be adjusted at runtime up to this maximum without a server restart.
 
 
 
@@ -1247,7 +1247,7 @@ Allow specification of the fixed number of dead tuples that will trigger an auto
 
 
 
-The server variable is <varname>autovacuum_vacuum_max_threshold>.  Percentages are still used for triggering.
+The server variable is <xref linkend="guc-autovacuum-vacuum-max-threshold"/>.  Percentages are still used for triggering.
 
 
 
@@ -1258,7 +1258,7 @@ Author: Andres Freund 
 
 
 
-Change server variable <varname>max_files_per_process> to limit only files opened by a backend (Andres Freund)
+Change server variable <xref linkend="guc-max-files-per-process"/> to limit only files opened by a backend (Andres Freund)
 §
 
 
@@ -1274,7 +1274,7 @@ Author: Nathan Bossart 
 
 
 
-Add server variable <varname>num_os_semaphores> to report the required number of semaphores (Nathan Bossart)
+Add server variable <xref linkend="guc-num-os-semaphores"/> to report the required number of semaphores (Nathan Bossart)
 §
 
 
@@ -1292,7 +1292,7 @@ Author: Peter Eisentraut 
 
 
 
-Add server variable <varname>extension_control_path> to specify the location of extension control files (Peter Eisentraut, Matheus Alcantara)
+Add server variable <xref linkend="guc-extension-control-path"/> to specify the location of extension control files (Peter Eisentraut, Matheus Alcantara)
 §
 §
 
@@ -1314,7 +1314,7 @@ Author: Amit Kapila 
 
 
 
-Allow inactive replication slots to be automatically invalided using server variable <varname>idle_replication_slot_timeout> (Nisha Moond, Bharath Rupireddy)
+Allow inactive replication slots to be automatically invalided using server variable <xref linkend="guc-idle-replication-slot-timeout"/> (Nisha Moond, Bharath Rupireddy)
 §
 
 
@@ -1326,12 +1326,12 @@ Author: Masahiko Sawada 
 
 
 
-Add server variable <varname>max_active_replication_origins> to control the maximum active replication origins (Euler Taveira)
+Add server variable <xref linkend="guc-max-active-replication-origins"/> to control the maximum active replication origins (Euler Taveira)
 §
 
 
 
-This was previously controlled by <varname>max_replication_slots>, but this new setting allows a higher origin count in cases where fewer slots are required.
+This was previously controlled by <xref linkend="guc-max-replication-slots"/>, but this new setting allows a higher origin count in cases where fewer slots are required.
 
 
 
@@ -1583,7 +1583,7 @@ Author: Thomas Munro 
 
 
 
-Add server variable <varname>file_copy_method> to control the file copying method (Nazir Bilal Yavuz)
+Add server variable <xref linkend="guc-file-copy-method"/> to control the file copying method (Nazir Bilal Yavuz)
 §
 
 
@@ -2271,7 +2271,7 @@ Author: Tomas Vondra 
 
 
 
-Report <varname>search_path> changes to the client (Alexander Kukushkin, Jelte Fennema-Nio, Tomas Vondra)
+Report <xref linkend="guc-search-path"/> changes to the client (Alexander Kukushkin, Jelte Fennema-Nio, Tomas Vondra)
 §
 §