Add pg_service.conf documentation for libpq.

diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 8362208600defbf36cd0ef210542a0536dd30fea..9c48948c868d204914fd3b40a7042c0b9b64f919 100644 (file)
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -1,5 +1,5 @@
 
 
  
@@ -298,9 +298,7 @@ PGconn *PQconnectdb(const char *conninfo);
       Service name to use for additional parameters.  It specifies a service
       name in pg_service.conf that holds additional connection parameters.
       This allows applications to specify only a service name so connection parameters 
-      can be centrally maintained.  See 
-      share/pg_service.conf.sample in the installation
-      directory for information on how to set up the file.
+      can be centrally maintained. See .
      
      
     
@@ -4031,6 +4029,35 @@ however.)
 
 
 
+
+The Connection Service File
+
+
+ connection service file
+
+
+ pg_service.conf
+
+
+
+The connection service file allows libpq connection parameters to be
+associated with a single service name. That service name can then be
+specified by a libpq connection, and the associated settings will be
+used. This allows connection parameters to be modified without requiring
+a recompile of the libpq application. The service name can also be
+specified using the PGSERVICE environment variable.
+
+
+To use this feature, copy
+share/pg_service.conf.sample to
+etc/pg_service.conf and edit the file to add
+service names and parameters. This file can be used for client-only
+installs too. The file's location can also be specified by the
+PGSYSCONFDIR environment variable.
+
+
+
+
 
 SSL Support