From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: phillip.lord@newcastle.ac.uk (Phillip Lord) Newsgroups: gmane.emacs.devel Subject: Re: Comment conventions, adding an explicit Header. Date: Fri, 31 Oct 2014 10:02:28 +0000 Message-ID: <87r3xoo8uj.fsf@newcastle.ac.uk> References: <87d299eu1d.fsf@newcastle.ac.uk> <87a94dd5hi.fsf@newcastle.ac.uk> <87r3xpbjhb.fsf@newcastle.ac.uk> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1414775622 19824 80.91.229.3 (31 Oct 2014 17:13:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 31 Oct 2014 17:13:42 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 31 18:13:35 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 1XkFlW-0008Qg-Nh for ged-emacs-devel@m.gmane.org; Fri, 31 Oct 2014 18:13:34 +0100 Original-Received: from localhost ([::1]:39628 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XkFlW-0005bq-3G for ged-emacs-devel@m.gmane.org; Fri, 31 Oct 2014 13:13:34 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:38317) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XkDoU-00062i-S7 for emacs-devel@gnu.org; Fri, 31 Oct 2014 11:08:57 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xk92M-00085f-Rx for emacs-devel@gnu.org; Fri, 31 Oct 2014 06:02:35 -0400 Original-Received: from cheviot22.ncl.ac.uk ([128.240.234.22]:43616) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xk92M-000820-Lk for emacs-devel@gnu.org; Fri, 31 Oct 2014 06:02:30 -0400 Original-Received: from smtpauth-vm.ncl.ac.uk ([10.8.233.129] helo=smtpauth.ncl.ac.uk) by cheviot22.ncl.ac.uk with esmtp (Exim 4.63) (envelope-from ) id 1Xk92K-00048M-F8; Fri, 31 Oct 2014 10:02:28 +0000 Original-Received: from jangai.ncl.ac.uk ([10.66.67.223] helo=localhost) by smtpauth.ncl.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.63) (envelope-from ) id 1Xk92K-00081q-FB; Fri, 31 Oct 2014 10:02:28 +0000 In-Reply-To: (Stefan Monnier's message of "Thu, 30 Oct 2014 13:13:58 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 128.240.234.22 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:176096 Archived-At: Stefan Monnier writes: >> Indeed. These will not currently be treated as sections. I could make >> them so. > > That would be good, since that's a common case and it also agrees with > the official convention (which says that anything that starts with > "^;;;+ [^ \n]" is a sectioning comment). > >> All good feedback. Can I conclude that so far there would be no show >> stopping problem with adding a ";;; Header:" line where it was wanted? > > I must say I don't like the idea of adding ";;; Header:" to every Elisp > file, no. At least not without a very strong argument for it. Oh, it doesn't need to be there. I am wondering whether it *can* be there and iff it is, does it break everything. Without it, in org-mode you would see this: ---- # # blah.el --- Dull file This file is not part of Emacs Author: Phillip Lord Other: GPL Text * Commentary... * Code... ---- With it, you get this... ---- # # blah.el -- Dull file * Header... * Commentary... * Code... ---- I think the latter is nicer, that's all. Phil