emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Modern Conventions for Emacs Lisp files?


From: Barry OReilly
Subject: Re: Modern Conventions for Emacs Lisp files?
Date: Tue, 9 Apr 2013 10:00:56 -0400

>>> 1. File structuring with outcommented Org-mode headlines (;; * Headline)
>>
>> There is already a standard for that:
>>
>>    ;;; Headline
>>    ;;;; SubHeadline
>>    ;;;;; SubSubHeadline
>
> But the lisp convention is the opposite:

Perhaps the Elisp manual needs an update, because it doesn't at all describe what Stefan does.

http://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Comment-Tips

"Comments that start with four semicolons, ‘;;;;’ ... are used for headings of major sections".

"Comments that start with three semicolons, ‘;;;’ ... are used, occasionally, for comments within functions [and] sometimes for comments that are between functions."



reply via email to

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