[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Modern Conventions for Emacs Lisp files?
From: |
Thorsten Jolitz |
Subject: |
Re: Modern Conventions for Emacs Lisp files? |
Date: |
Tue, 09 Apr 2013 01:42:45 +0200 |
User-agent: |
Gnus/5.130002 (Ma Gnus v0.2) Emacs/24.3 (gnu/linux) |
"Pascal J. Bourguignon" <address@hidden> writes:
> Stefan Monnier <address@hidden> writes:
>
>>> 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:
>
> ------------------------------------------------------------------------
> ;;;; -*- mode:lisp -*-
>
>
> ;;;;
> ;;;; File comment
> ;;;;
>
> ;;;
> ;;; Section comment
> ;;;
>
> (defun code ()
> ;; indented comment
> (form) ; inline comment
> (form2) ; long inline comment
> ;; indented comment
> (form3))
>
> ------------------------------------------------------------------------
If thats true (and I think it actually might be) it would be a very
inconvenient convention, because one would need to know the number of
heading levels in advance, and would have to change all other headers if
a new level is introduced at the bottom:
,-------------------------------------------
| > ;;;; -*- mode:lisp -*- ; * level 1
| >
| > ;;;;
| > ;;;; File comment ; * level 1
| > ;;;;
| >
| > ;;;
| > ;;; Section comment ; ** level 3
| > ;;;
`-------------------------------------------
,----------------------------------------------
| > ;;;;; -*- mode:lisp -*- ; * level 1
| >
| > ;;;;;
| > ;;;;; File comment ; * level 1
| > ;;;;;
| >
| > ;;;;
| > ;;;; Section comment ; ** level 2
| > ;;;;
| >
| > ;;;
| > ;;; Subsection comment ; *** level 3
| > ;;;
`----------------------------------------------
--
cheers,
Thorsten
- Re: Modern Conventions for Emacs Lisp files?, (continued)
- Re: Modern Conventions for Emacs Lisp files?, Bastien, 2013/04/15
- Naming internal functions (was: Modern Conventions for Emacs Lisp files?), Christopher Schmidt, 2013/04/08
- Re: Naming internal functions, Stefan Monnier, 2013/04/08
- Re: Naming internal functions, Christopher Schmidt, 2013/04/15
- Re: Naming internal functions, Eli Zaretskii, 2013/04/15
- Re: Naming internal functions, Christopher Schmidt, 2013/04/15
- Re: Naming internal functions, Eli Zaretskii, 2013/04/15
- Re: Naming internal functions, Christopher Schmidt, 2013/04/15
- Re: Naming internal functions, xfq, 2013/04/15
Re: Modern Conventions for Emacs Lisp files?, Pascal J. Bourguignon, 2013/04/08
Re: Modern Conventions for Emacs Lisp files?, Pascal J. Bourguignon, 2013/04/10
Re: Modern Conventions for Emacs Lisp files?, Thorsten Jolitz, 2013/04/10
Re: Modern Conventions for Emacs Lisp files?, Leo Liu, 2013/04/09
Re: Modern Conventions for Emacs Lisp files?, Barry OReilly, 2013/04/09