Index: doc/src/sgml/runtime.sgml
===================================================================
RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.165
diff -c -r1.165 runtime.sgml
*** doc/src/sgml/runtime.sgml	27 Dec 2002 14:06:34 -0000	1.165
--- doc/src/sgml/runtime.sgml	8 Jan 2003 18:22:01 -0000
***************
*** 380,390 ****
  <screen>
  IpcSemaphoreCreate: semget(key=5440026, num=16, 01600) failed: No space left on device
  </screen>
!      does <emphasis>not</emphasis> mean you've run out of disk space. It
!      means your kernel's limit on the number of System V semaphores is
!      smaller than the number <productname>PostgreSQL</productname> wants
!      to create. As above, you may be able to work around the problem by
!      starting the postmaster with a reduced number of allowed connections
       (<option>-N</option> switch), but you'll eventually want to
       increase the kernel limit.
      </para>
--- 380,391 ----
  <screen>
  IpcSemaphoreCreate: semget(key=5440026, num=16, 01600) failed: No space left on device
  </screen>
!      does <emphasis>not</emphasis> mean you've run out of disk
!      space. It means your kernel's limit on the number of <systemitem
!      class="osname">System V</> semaphores is smaller than the number
!      <productname>PostgreSQL</productname> wants to create. As above,
!      you may be able to work around the problem by starting the
!      postmaster with a reduced number of allowed connections
       (<option>-N</option> switch), but you'll eventually want to
       increase the kernel limit.
      </para>
***************
*** 1838,1846 ****
        <listitem>
         <para>
          Sets the number of shared memory buffers used by the database
!         server. The default is 64. Each buffer is typically 8192 bytes.
          This option can only be set at server start.
         </para>
        </listitem>
       </varlistentry>
  
--- 1839,1858 ----
        <listitem>
         <para>
          Sets the number of shared memory buffers used by the database
!         server. The default is 64. Each buffer is typically 8192
!         bytes. This must be greater than 16, as well as at least twice
!         the value of <varname>MAX_CONNECTIONS</varname>; however, a
!         higher value can often improve performance on modern machines.
          This option can only be set at server start.
         </para>
+ 
+        <para>
+         Increasing this parameter may cause <productname>PostgreSQL</>
+         to request more <systemitem class="osname">System V</> shared
+         memory than your operating system's default configuration
+         allows. See <xref linkend="sysvipc"> for information on how to
+         adjust these parameters, if necessary.
+        </para>
        </listitem>
       </varlistentry>
  
***************
*** 2165,2172 ****
        <term><varname>WAL_BUFFERS</varname> (<type>integer</type>)</term>
        <listitem>
         <para>
!         Number of disk-page buffers in shared memory for WAL logging.
! 	This option can only be set at server start.
         </para>
        </listitem>
       </varlistentry>
--- 2177,2185 ----
        <term><varname>WAL_BUFFERS</varname> (<type>integer</type>)</term>
        <listitem>
         <para>
!         Number of disk-page buffers in shared memory for WAL
!         logging. The default is 4. This option can only be set at
!         server start.
         </para>
        </listitem>
       </varlistentry>
Index: src/backend/utils/misc/postgresql.conf.sample
===================================================================
RCS file: /var/lib/cvs/pgsql-server/src/backend/utils/misc/postgresql.conf.sample,v
retrieving revision 1.61
diff -c -r1.61 postgresql.conf.sample
*** src/backend/utils/misc/postgresql.conf.sample	27 Dec 2002 14:06:34 -0000	1.61
--- src/backend/utils/misc/postgresql.conf.sample	8 Jan 2003 18:12:08 -0000
***************
*** 47,53 ****
  #
  #	Shared Memory Size
  #
! #shared_buffers = 64		# 2*max_connections, min 16, typically 8KB each
  #max_fsm_relations = 1000	# min 10, fsm is free space map, ~40 bytes
  #max_fsm_pages = 10000		# min 1000, fsm is free space map, ~6 bytes
  #max_locks_per_transaction = 64	# min 10
--- 47,53 ----
  #
  #	Shared Memory Size
  #
! #shared_buffers = 64		# at least 2*max_connections, min 16, 8KB each
  #max_fsm_relations = 1000	# min 10, fsm is free space map, ~40 bytes
  #max_fsm_pages = 10000		# min 1000, fsm is free space map, ~6 bytes
  #max_locks_per_transaction = 64	# min 10