bug-gnu-emacs
[Top][All Lists]
Advanced

[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'.






reply via email to

[Prev in Thread] Current Thread [Next in Thread]