bug#23060: Elisp Manual: Appendix D.7, comment tips

[Lars Ingebrigtsen]

Tianxiang Xiong <tianxiang.xiong@gmail.com> writes:

> For triple semicolons, the manual says:
>
>     Comments that start with three semicolons, ‘;;;’, should start at
>     the left margin. We use them for comments which should be considered
>     a “heading” by Outline minor mode.
>
> For quadruple semicolons, the manual says:
>
>     Comments that start with four semicolons, ‘;;;;’, should be aligned
>     to the left margin and are used for headings of major sections of a
>     program. For example:
>     
>     ;;;; The kill ring
>
> This does not make clear what the difference between the two are.

(I'm going through old Emacs bug reports that haven't received any
response.)

I've now added some clarification to the manual in Emacs 27 on this
point.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no