GNU bug report logs - #23060
Elisp Manual: Appendix D.7, comment tips

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Tianxiang Xiong <tianxiang.xiong <at> gmail.com>
Cc: 23060 <at> debbugs.gnu.org
Subject: bug#23060: Elisp Manual: Appendix D.7, comment tips
Date: Mon, 29 Jul 2019 14:47:27 +0200

Tianxiang Xiong <tianxiang.xiong <at> 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.