doc: update bgwriter description

This clarifies exactly what the bgwriter does, which should help with
tuning.

Reported-by: Chris Wilson
Discussion: https://postgr.es/m/160399562040.7809.7335281028960123489@wrigleys.postgresql.org

Backpatch-through: 9.5

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 7e4d8c39257ef08037538f82e78c0b8f0c899678..9b108abdbf55e9a9cd03348c627d32b66559b269 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -1781,8 +1781,11 @@ include_dir 'conf.d'
       There is a separate server
       process called the <firstterm>background writer</>, whose function
       is to issue writes of <quote>dirty</> (new or modified) shared
-      buffers.  It writes shared buffers so server processes handling
-      user queries seldom or never need to wait for a write to occur.
+      buffers.  When the number of clean shared buffers appears to be
+      insufficient, the background writer writes some dirty buffers to the
+      file system and marks them as clean.  This reduces the likelihood
+      that server processes handling user queries will be unable to find
+      clean buffers and have to write dirty buffers themselves.
       However, the background writer does cause a net overall
       increase in I/O load, because while a repeatedly-dirtied page might
       otherwise be written only once per checkpoint interval, the