Improve the documentation about commit_delay.

Tom Lane <tgl@sss.pgh.pa.us>

Commit: 70ec2f8f4392f4e3d379c2c759789d631ffeec10
Author: Tom Lane <tgl@sss.pgh.pa.us>
Date: 2013-03-15T21:41:47Z
Releases: 9.3.0
Improve the documentation about commit_delay.

Clarify the docs explaining what commit_delay does, and add a
recommendation about a useful value for it, namely half of the single-page
fsync time reported by pg_test_fsync.  This is informed by testing of
the new-in-9.3 implementation of commit_delay; in prior versions it
was far harder to arrive at a useful setting.

In passing, do some wordsmithing and markup-fixing in the same general
area.

Also, change pg_test_fsync's default time-per-test from 2 seconds to 5.
The old value was about the minimum at which the results could be taken
seriously at all, and so seems a tad optimistic as a default.

Peter Geoghegan, reviewed by Noah Misch; some additional editing by me

Files

PathChange+/−
contrib/pg_test_fsync/pg_test_fsync.c modified +1 −1
doc/src/sgml/config.sgml modified +5 −4
doc/src/sgml/pgtestfsync.sgml modified +4 −4
doc/src/sgml/wal.sgml modified +108 −61