@@ -316,16 +316,22 @@ PostgreSQL documentation
316316 </varlistentry>
317317
318318 <varlistentry>
319- <term><option>--wal-segsize=<replaceable>SEGSIZE </replaceable></option></term>
319+ <term><option>--wal-segsize=<replaceable>size </replaceable></option></term>
320320 <listitem>
321321 <para>
322- Set the <firstterm>WAL segment size</firstterm>, in megabytes. This is
323- the size of each individual file in the WAL log. It may be useful
324- to adjust this size to control the granularity of WAL log shipping.
325- This option can only be set during initialization, and cannot be
326- changed later.
327- The default size is 16 megabytes.
328- The value must be a power of 2 between 1 and 1024 (megabytes).
322+ Set the <firstterm>WAL segment size</firstterm>, in megabytes. This
323+ is the size of each individual file in the WAL log. The default size
324+ is 16 megabytes. The value must be a power of 2 between 1 and 1024
325+ (megabytes). This option can only be set during initialization, and
326+ cannot be changed later.
327+ </para>
328+
329+ <para>
330+ It may be useful to adjust this size to control the granularity of
331+ WAL log shipping or archiving. Also, in databases with a high volume
332+ of WAL, the sheer number of WAL files per directory can become a
333+ performance and management problem. Increasing the WAL file size
334+ will reduce the number of WAL files.
329335 </para>
330336 </listitem>
331337 </varlistentry>