From ee37fb57c02afcfe6b2b2c75b39aeb86c28f7ac8 Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Mon, 28 Jun 2010 17:48:26 +0000 Subject: [PATCH] Add guidelines for formatting errcontext strings --- doc/src/sgml/sources.sgml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/src/sgml/sources.sgml b/doc/src/sgml/sources.sgml index 342f8e4ef7..ec33170f69 100644 --- a/doc/src/sgml/sources.sgml +++ b/doc/src/sgml/sources.sgml @@ -1,4 +1,4 @@ - + PostgreSQL Coding Conventions @@ -444,6 +444,12 @@ Hint: the addendum inappropriate in other languages). + + Error context strings: Do not capitalize the first letter and do + not end the string with a period. Context strings should normally + not be complete sentences. + + Rationale: Avoiding punctuation makes it easier for client applications to embed the message into a variety of grammatical contexts. Often, primary