diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml index a3c989b6fb..873ba6b2f2 100644 --- a/doc/src/sgml/sources.sgml +++ b/doc/src/sgml/sources.sgml @@ -1,4 +1,4 @@ - + PostgreSQL Coding Conventions @@ -22,10 +22,10 @@ The src/tools directory contains sample settings - files that can be used with the emacs, - xemacs or vim - editors to help ensure that they format code according to these - conventions. + files that can be used with the emacs, + xemacs or vim + editors to help ensure that they format code according to these + conventions. @@ -606,17 +606,13 @@ BETTER: unrecognized node type: 42 - May/Can/Might + May vs. Can vs. Might - May suggests permission (e.g. "You may borrow my rake.") + 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 + today."). Using the proper word clarifies meaning and assists translation.