Add "May/Can/Might" section to error message style guidlines, and

"can't" -> "cannot" section.

diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml
index c9cbd68d42fb9e8bcae879a4a576c05e1f72e317..a3c989b6fb668f6ebdec731836cf8464c56391a0 100644 (file)
--- a/doc/src/sgml/sources.sgml
+++ b/doc/src/sgml/sources.sgml
@@ -1,4 +1,4 @@
-
+
 
  
   PostgreSQL Coding Conventions
@@ -605,6 +605,30 @@ BETTER: unrecognized node type: 42
    
   
 
+  
+    May/Can/Might
+   
+    May suggests permission (e.g. "You may borrow my rake.")
+    and has little use in documentation or error messages.
+    Can suggests ability (e.g. "I can lift that log."),
+    and might suggests possibility (e.g. "It might rain
+    today.").
+   
+
+   
+    Rationale: Using the proper word clarifies meaning and assists
+    translation.
+   
+  
+
+  
+    Contractions
+   
+    Avoid contractions, like can't;  use
+    cannot instead.
+   
+  
+