* newcomment.el (comment-region): Doc fix (Bug#3370).

2 files changed, 13 insertions, 5 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 7f07f5f5608..b15c72614cd 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2009-05-26  Chong Yidong  <cyd@stupidchicken.com>
+
+        * newcomment.el (comment-region): Doc fix (Bug#3370).
+
 2009-05-24  Roland Winkler  <Roland.Winkler@physik.uni-erlangen.de>
 
         * mail/smtpmail.el: Indent code properly to make it more readable.
diff --git a/lisp/newcomment.el b/lisp/newcomment.el
index 3c922b8d1c1..c7ad8821b6f 100644
--- a/lisp/newcomment.el
+++ b/lisp/newcomment.el
@@ -1046,12 +1046,16 @@ the region rather than at left margin."
 With just \\[universal-argument] prefix arg, uncomment each line in region BEG .. END.
 Numeric prefix ARG means use ARG comment characters.
 If ARG is negative, delete that many comment characters instead.
-By default, comments start at the left margin, are terminated on each line,
-even for syntax in which newline does not end the comment and blank lines
-do not get comments.  This can be changed with `comment-style'.
 
-The strings used as comment starts are built from
-`comment-start' without trailing spaces and `comment-padding'."
+The strings used as comment starts are built from `comment-start'
+and `comment-padding'; the strings used as comment ends are built
+from `comment-end' and `comment-padding'.
+
+By default, the `comment-start' markers are inserted at the
+current indentation of the region, and comments are terminated on
+each line (even for syntaxes in which newline does not end the
+comment and blank lines do not get comments).  This can be
+changed with `comment-style'."
   (interactive "*r\nP")
   (comment-normalize-vars)
   (if (> beg end) (let (mid) (setq mid beg beg end end mid)))