From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eric S. Raymond" Newsgroups: gmane.emacs.devel Subject: Re: Comment conventions, adding an explicit Header. Date: Thu, 30 Oct 2014 07:59:51 -0400 Organization: Eric Conspiracy Secret Labs Message-ID: <20141030115949.GB7645@thyrsus.com> References: <87d299eu1d.fsf@newcastle.ac.uk> Reply-To: esr@thyrsus.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1414781925 1247 80.91.229.3 (31 Oct 2014 18:58:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 31 Oct 2014 18:58:45 +0000 (UTC) Cc: emacs-devel@gnu.org To: Phillip Lord Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 31 19:58:39 2014 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 1XkHPC-0006WZ-RS for ged-emacs-devel@m.gmane.org; Fri, 31 Oct 2014 19:58:38 +0100 Original-Received: from localhost ([::1]:41288 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XkHPC-0006VW-F3 for ged-emacs-devel@m.gmane.org; Fri, 31 Oct 2014 14:58:38 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51188) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XkET4-0006Cz-F9 for emacs-devel@gnu.org; Fri, 31 Oct 2014 11:51:15 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XjoOQ-00055C-UK for emacs-devel@gnu.org; Thu, 30 Oct 2014 08:00:00 -0400 Original-Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:39624 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XjoOQ-000556-QY for emacs-devel@gnu.org; Thu, 30 Oct 2014 07:59:54 -0400 Original-Received: by snark.thyrsus.com (Postfix, from userid 1000) id 167703834E0; Thu, 30 Oct 2014 07:59:52 -0400 (EDT) Content-Disposition: inline In-Reply-To: <87d299eu1d.fsf@newcastle.ac.uk> X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.5.21 (2010-09-15) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 71.162.243.5 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:176136 Archived-At: Phillip Lord : > I have written a mode which transforms an Emacs-Lisp file into an > org-mode file. So you can view (and edit) your comments in org-mode, > while maintaining a normal elisp file (i.e. it doesn't require tangling > as an org-mode babel file would). In this process ";;; Commentary:" > lines get transformed into Org mode section one headers. This works > nicely, but the lack of a ";;; Header:" line, means that the metadata > and copyright is outside of the org-mode structure. Adding a ";;; > Header:" is a simple way of circumventing this. I believe I was the person who made the ";;; Commentary" header general across the Lisp library, back around '92 or '93. (Possibly I generalized it from previous sporadic examples rather than inventing it; I don't remember.) When I did so, I was thinking explicitly of enabling text analysis by introducing a structural semantic clue. I did not anticipate org mode, but you are extending the concept in the direction I intended. +1 -- Eric S. Raymond