Minor copy-editing.
authorTom Lane
Mon, 9 Jul 2007 01:08:09 +0000 (01:08 +0000)
committerTom Lane
Mon, 9 Jul 2007 01:08:09 +0000 (01:08 +0000)
doc/src/sgml/ref/postgres-ref.sgml

index e67042b1622c53c25de9b02048f6009986ba57f9..0024c43cc5a5a2c638c9f235c3642d2d908f962a 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -33,17 +33,17 @@ PostgreSQL documentation
    postgres is the
    PostgreSQL database server.  In order
    for a client application to access a database it connects (over a
-   network or locally) to a running postgres process.
+   network or locally) to a running postgres instance.
    The postgres instance then starts a separate server
    process to handle the connection.
   
 
   
-   One postgres instance always manages the data from
+   One postgres instance always manages the data of
    exactly one database cluster.  A database cluster is a collection
    of databases that is stored at a common file system location (the
    data area).  More than one
-   postgres process can run on a system at one
+   postgres instance can run on a system at one
    time, so long as they use different data areas and different
    communication ports (see below).  When
    postgres starts it needs to know the location
@@ -119,8 +119,9 @@ PostgreSQL documentation
        
         Sets the number of shared buffers for use by the server
         processes.  The default value of this parameter is chosen
-        automatically by initdb; refer to 
-        linkend="runtime-config-resource-memory"> for more information.
+        automatically by initdb.
+        Specifying this option is equivalent to setting the
+         configuration parameter.
        
       
      
@@ -256,13 +257,9 @@ PostgreSQL documentation
       
        
         Sets the maximum number of client connections that this
-        server will accept.  By
-        default, this value is 32, but it can be set as high as your
-        system will support.  (Note that
-         is required to be at least twice
-        .  See  for a discussion of
-        system resource requirements for large numbers of client
-        connections.) Specifying this option is equivalent to setting the
+        server will accept.  The default value of this parameter is chosen
+        automatically by initdb.
+        Specifying this option is equivalent to setting the
          configuration parameter.
        
       
@@ -272,7 +269,7 @@ PostgreSQL documentation
       
       
        
-        The command line-style options specified in 
+        The command-line-style options specified in 
         class="parameter">extra-options are passed to
         all server processes started by this
         postgres process.  If the option string contains
@@ -354,11 +351,11 @@ PostgreSQL documentation
     Semi-internal Options
 
     
-     There are several other options that can be specified, used
-     mainly for debugging purposes and in some cases to assist with
+     The options described here are used
+     mainly for debugging purposes, and in some cases to assist with
      recovery of severely damaged databases. There should be no reason
-     to use them in a production database setup.  These are listed
-     here only for the use by PostgreSQL
+     to use them in a production database setup.  They are listed
+     here only for use by PostgreSQL
      system developers.  Furthermore, these options might
      change or be removed in a future release without notice.
     
@@ -500,8 +497,9 @@ PostgreSQL documentation
       database
       
        
-        Specifies the name of the database to be accessed.  If it is
-        omitted it defaults to the user name.   
+        Specifies the name of the database to be accessed.  This must be
+        the last argument on the command line.  If it is
+        omitted it defaults to the user name.
        
       
      
@@ -647,6 +645,12 @@ PostgreSQL documentation
 
  
   Notes
+
+  
+   The utility command  can be used to
+   start and shut down the postgres server
+   safely and comfortably.
+  
   
   
    If at all possible, do not use
@@ -665,16 +669,14 @@ PostgreSQL documentation
    all clients to terminate before quitting, the second will
    forcefully disconnect all clients, and the third will quit
    immediately without proper shutdown, resulting in a recovery run
-   during restart.  The SIGHUP signal will reload
-   the server configuration files.  It is also possible to send
-   SIGHUP to an individual server process, but that
-   is usually not sensible.
+   during restart.
   
 
   
-   The utility command  can be used to
-   start and shut down the postgres server
-   safely and comfortably.
+   The SIGHUP signal will reload
+   the server configuration files.  It is also possible to send
+   SIGHUP to an individual server process, but that
+   is usually not sensible.