(error): Doc fix.

1 files changed, 4 insertions, 1 deletions

diff --git a/lisp/subr.el b/lisp/subr.el
index f73a29ad11b..f96351e6e4d 100644
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -704,7 +704,10 @@ This function accepts any number of arguments, but ignores them."
   nil)
 
 (defun error (&rest args)
-  "Signal an error, making error message by passing all args to `format'."
+  "Signal an error, making error message by passing all args to `format'.
+In Emacs, the convention is that error messages start with a capital
+letter but *do not* end with a period.  Please follow this convention
+for the sake of consistency."
   (while t
     (signal 'error (list (apply 'format args)))))