Doc: improve cross-references for SET/SHOW.

The corresponding functions set_config and current_setting were
mostly not hyperlinked.  Clarify their descriptions a tad, too.

Discussion: https://postgr.es/m/161183356250.4077.687338658090583892@wrigleys.postgresql.org

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 97610de287d77d2dc4f91a3d3e9cb085a484d440..6999c4a2a368fa03708a786928d474d200f98d61 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -263,8 +263,9 @@ shared_buffers = 128MB
      
      
       The  command allows inspection of the
-      current value of all parameters.  The corresponding function is
-      current_setting(setting_name text).
+      current value of any parameter.  The corresponding SQL function is
+      current_setting(setting_name text)
+      (see ).
      
      
 
@@ -273,8 +274,9 @@ shared_buffers = 128MB
        The  command allows modification of the
        current value of those parameters that can be set locally to a
        session; it has no effect on other sessions.
-       The corresponding function is
-       set_config(setting_name, new_value, is_local).
+       The corresponding SQL function is
+       set_config(setting_name, new_value, is_local)
+       (see ).
       
      
     

diff --git a/doc/src/sgml/func.sgml b/doc/src/sgml/func.sgml
index 7ba867b1b5cf40599bd456a9250335877a07c41a..6f1133365b8e5434833dafdbe80a0fc87ab39b09 100644 (file)
--- a/doc/src/sgml/func.sgml
+++ b/doc/src/sgml/func.sgml
@@ -23930,8 +23930,9 @@ SELECT collation for ('foo' COLLATE "de_DE");
         setting setting_name.  If there is no such
         setting, current_setting throws an error
         unless missing_ok is supplied and
-        is true.  This function corresponds to
-        the SQL command SHOW.
+        is true (in which case NULL is returned).
+        This function corresponds to
+        the SQL command .
        
        
         current_setting('datestyle')
@@ -23954,10 +23955,10 @@ SELECT collation for ('foo' COLLATE "de_DE");
         Sets the parameter setting_name
         to new_value, and returns that value.
         If is_local is true, the new
-        value will only apply for the current transaction. If you want the new
-        value to apply for the current session, use false
-        instead. This function corresponds to the SQL
-        command SET>.
+        value will only apply during the current transaction. If you want the
+        new value to apply for the rest of the current session,
+        use false instead. This function corresponds to
+        the SQL command >.
        
        
         set_config('log_statement_stats', 'off', false)

diff --git a/doc/src/sgml/ref/set.sgml b/doc/src/sgml/ref/set.sgml
index 63f312e812a8725653eb0f2a26c847456988872f..339ee9eec94803a2831d490d6051cf05acd32da2 100644 (file)
--- a/doc/src/sgml/ref/set.sgml
+++ b/doc/src/sgml/ref/set.sgml
@@ -267,7 +267,7 @@ SELECT setseed(value);
 
   
    The function set_config provides equivalent
-   functionality; see .
+   functionality; see -set"/>.
    Also, it is possible to UPDATE the
    pg_settings
    system view to perform the equivalent of SET.

diff --git a/doc/src/sgml/ref/show.sgml b/doc/src/sgml/ref/show.sgml
index 945b0491b14ec90d8a1de7ebabab0f2300d08383..93789ee0be058c88712933cdf98ba4eba4390dd6 100644 (file)
--- a/doc/src/sgml/ref/show.sgml
+++ b/doc/src/sgml/ref/show.sgml
@@ -129,7 +129,7 @@ SHOW ALL
 
   
    The function current_setting produces
-   equivalent output; see .
+   equivalent output; see -set"/>.
    Also, the
    pg_settings
    system view produces the same information.