Improve documentation of postgres -C option

Clarify help (s/return/print/), and explain that this option is for
use by other programs, not for user-facing use (it does not print
units).

diff --git a/doc/src/sgml/ref/postgres-ref.sgml b/doc/src/sgml/ref/postgres-ref.sgml
index 9869a1f5262c2d1c8a43167d498163631edda41c..d8e9825d13ebb335bf870a5c74d14561fb4f9800 100644 (file)
--- a/doc/src/sgml/ref/postgres-ref.sgml
+++ b/doc/src/sgml/ref/postgres-ref.sgml
@@ -144,13 +144,20 @@ PostgreSQL documentation
       -C name
       
        
-        Returns the value of a named run-time parameter, and exits.
+        Prints the value of the named run-time parameter, and exits.
         (See the -c option above for details.)  This can
         be used on a running server, and returns values from
         postgresql.conf, modified by any parameters
         supplied in this invocation.  It does not reflect parameters
         supplied when the cluster was started.
        
+
+       
+        This option is meant for other programs that interact with a server
+        instance, such as , to query configuration
+        parameter values.  User-facing applications should instead use 
+        linkend="sql-show"> or the pg_settings view.
+       
       
      
 


diff --git a/src/backend/main/main.c b/src/backend/main/main.c

index a63ebe3d108986584782c256e358d9bd77299248..7203481a04b7ffb003c5bf32e35307aa80c5aa44 100644 (file)

--- a/src/backend/main/main.c
+++ b/src/backend/main/main.c
@@ -279,7 +279,7 @@ help(const char *progname)
 #endif
    printf(_("  -B NBUFFERS        number of shared buffers\n"));
    printf(_("  -c NAME=VALUE      set run-time parameter\n"));
-   printf(_("  -C NAME            return run-time parameter\n"));
+   printf(_("  -C NAME            print value of run-time parameter, then exit\n"));
    printf(_("  -d 1-5             debugging level\n"));
    printf(_("  -D DATADIR         database directory\n"));
    printf(_("  -e                 use European date input format (DMY)\n"));

diff --git a/src/backend/main/main.c b/src/backend/main/main.c
index a63ebe3d108986584782c256e358d9bd77299248..7203481a04b7ffb003c5bf32e35307aa80c5aa44 100644 (file)
--- a/src/backend/main/main.c
+++ b/src/backend/main/main.c
@@ -279,7 +279,7 @@ help(const char *progname)
 #endif
    printf(_("  -B NBUFFERS        number of shared buffers\n"));
    printf(_("  -c NAME=VALUE      set run-time parameter\n"));
-   printf(_("  -C NAME            return run-time parameter\n"));
+   printf(_("  -C NAME            print value of run-time parameter, then exit\n"));
    printf(_("  -d 1-5             debugging level\n"));
    printf(_("  -D DATADIR         database directory\n"));
    printf(_("  -e                 use European date input format (DMY)\n"));