diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index 5d9043a16a7b72ce008e4d66b2981a01d9dd5b15..65652dd3053b6525607f817ad01d83dd1d3ef8f2 100644
--- a/doc/src/sgml/sources.sgml
+++ b/doc/src/sgml/sources.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/sources.sgml,v 2.28 2007/03/02 23:37:22 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/sources.sgml,v 2.29 2007/11/07 13:12:21 petere Exp $ -->
 
  <chapter id="source">
   <title>PostgreSQL Coding Conventions</title>
@@ -375,7 +375,9 @@ Hint:       the addendum
 
    <para>
     Detail and hint messages: Use complete sentences, and end each with
-    a period.  Capitalize the first word of sentences.
+    a period.  Capitalize the first word of sentences.  Put two spaces after
+    the period if another sentence follows (for English text; might be
+    inappropriate in other languages).
    </para>
 
    <para>