]> granicus.if.org Git - postgresql/commit
Improve the documentation about commit_delay.
authorTom Lane <tgl@sss.pgh.pa.us>
Fri, 15 Mar 2013 21:41:47 +0000 (17:41 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Fri, 15 Mar 2013 21:41:47 +0000 (17:41 -0400)
commit70ec2f8f4392f4e3d379c2c759789d631ffeec10
tree50bfd7dd704bf49e6e96cf0debeaadcd839b6049
parentdcafdbcde1baf256891be6af77868b84889b435d
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
contrib/pg_test_fsync/pg_test_fsync.c
doc/src/sgml/config.sgml
doc/src/sgml/pgtestfsync.sgml
doc/src/sgml/wal.sgml