[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#10868: 24.0.93; `comment-style' needs to be explained
From: |
Drew Adams |
Subject: |
bug#10868: 24.0.93; `comment-style' needs to be explained |
Date: |
Wed, 22 Feb 2012 10:06:02 -0800 |
> > The problem is that variable `comment-style' is not explained.
>
> comment-style is a variable defined in `newcomment.el'.
> Its value is indent
>
> Documentation:
> Style to be used for `comment-region'.
> See `comment-styles' for a list of available styles.
>
> comment-styles is a variable defined in `newcomment.el'.
> [...]
> ((plain nil nil nil nil "Start in column 0 (do not indent),
> as in Emacs-20")
> (indent-or-triple nil nil nil multi-char "Start in column 0,
> but only for single-char starters")
> (indent nil nil nil t "Full comment per line, ends not aligned")
> (aligned nil t nil t "Full comment per line, ends aligned")
> (box nil t t t "Full comment per line, ends aligned, + top
> and bottom")
> (extra-line t nil t t "One comment for all lines, end on a
> line by itself")
> (multi-line t nil nil t "One comment for all lines, end on
> last commented line")
> (box-multi t t t t "One comment for all lines, + top and bottom"))
You are just parroting the existing, insufficient doc.
Read the bug #3370 thread, if you want to understand the problem. There is no
_explanation_ of `comment-style'.
- bug#10868: 24.0.93; `comment-style' needs to be explained, Drew Adams, 2012/02/22
- bug#10868: 24.0.93; `comment-style' needs to be explained, Glenn Morris, 2012/02/22
- bug#10868: 24.0.93; `comment-style' needs to be explained,
Drew Adams <=
- bug#10868: 24.0.93; `comment-style' needs to be explained, Glenn Morris, 2012/02/22
- bug#10868: 24.0.93; `comment-style' needs to be explained, Drew Adams, 2012/02/22
- bug#10868: 24.0.93; `comment-style' needs to be explained, Lawrence Mitchell, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Stefan Monnier, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Drew Adams, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Stefan Monnier, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Drew Adams, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Chong Yidong, 2012/02/24
- bug#10868: 24.0.93; `comment-style' needs to be explained, Glenn Morris, 2012/02/23
- bug#10868: 24.0.93; `comment-style' needs to be explained, Glenn Morris, 2012/02/23