comment-add

[Stephen Berman]

Since this change:

2007-09-17  Richard Stallman  <address@hidden>

        * newcomment.el (comment-add): New arg EXTRA.
        (comment-region-default): Pass EXTRA if not indenting lines.

the docstring of the variable comment-add:

  How many more comment chars should be inserted by `comment-region'.
  This determines the default value of the numeric argument of `comment-region'.
  This should generally stay 0, except for a few modes like Lisp where
  it can be convenient to set it to 1 so that regions are commented with
  two semi-colons.
  
doesn't reflect the default behavior in Lisp mode, which is now to
comment regions with three semi-colons, given the default
comment-style 'plain.  If the default comment-style were changed to
'indent, then the doctring would (once again) be accurate.  If the
default comment-style is kept 'plain, the change in behavior should be
mentioned in NEWS.

In case anyone's tallying votes on this, I am in favor of making the
default comment-style 'indent.

Steve Berman