From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thorsten Jolitz Newsgroups: gmane.emacs.devel Subject: Re: Modern Conventions for Emacs Lisp files? Date: Wed, 10 Apr 2013 22:04:38 +0200 Message-ID: <87k3oaxicp.fsf@gmail.com> References: <87hajhswdh.fsf@gmail.com> <8738v0fxw7.fsf@kuiper.lan.informatimago.com> <87bo9mdx3l.fsf@kuiper.lan.informatimago.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1365624290 21967 80.91.229.3 (10 Apr 2013 20:04:50 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Apr 2013 20:04:50 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Apr 10 22:04:54 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UQ1GH-0007uT-Sz for ged-emacs-devel@m.gmane.org; Wed, 10 Apr 2013 22:04:54 +0200 Original-Received: from localhost ([::1]:49380 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UQ1GH-0001AL-GQ for ged-emacs-devel@m.gmane.org; Wed, 10 Apr 2013 16:04:53 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:52939) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UQ1GE-0001A5-3h for emacs-devel@gnu.org; Wed, 10 Apr 2013 16:04:51 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UQ1GC-0000Kz-IY for emacs-devel@gnu.org; Wed, 10 Apr 2013 16:04:50 -0400 Original-Received: from plane.gmane.org ([80.91.229.3]:59481) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UQ1GC-0000Kv-C6 for emacs-devel@gnu.org; Wed, 10 Apr 2013 16:04:48 -0400 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1UQ1GA-0007oC-W9 for emacs-devel@gnu.org; Wed, 10 Apr 2013 22:04:47 +0200 Original-Received: from g231226235.adsl.alicedsl.de ([92.231.226.235]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 10 Apr 2013 22:04:46 +0200 Original-Received: from tjolitz by g231226235.adsl.alicedsl.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Wed, 10 Apr 2013 22:04:46 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 45 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: g231226235.adsl.alicedsl.de User-Agent: Gnus/5.130002 (Ma Gnus v0.2) Emacs/24.3 (gnu/linux) Cancel-Lock: sha1:aVQDs6TVDWVCDr9XDM+eBbIPedg= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:158829 Archived-At: "Pascal J. Bourguignon" writes: > Stefan Monnier writes: > >>> But the lisp convention is the opposite: >> >> Right, that's because Lisp didn't think it through. >> Luckily, we're only dealing with Elisp, > > I think it was thought through: don't use more than four levels! But, citing your earlier post, the following example gives you only 2 levels for headlines plus two types of comments, and taking into account that the file comment only appears once at the beginning of the file, there is only one level left (;;;) for headlines. Thus in the actual main (code) section of the library no hierarchical tree structure can be build. I would not want to structure a 4000+ lines .emacs file with only one level of headlines, in such big files I rather end up using 4 or 5 level or so. ------------------------------------------------------------------------ ;;;; -*- mode:lisp -*- ;;;; ;;;; File comment ;;;; ;;; ;;; Section comment ;;; (defun code () ;; indented comment (form) ; inline comment (form2) ; long inline comment ;; indented comment (form3)) ------------------------------------------------------------------------ -- cheers, Thorsten