From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: Function attributes for make-docfile Date: Sun, 11 Jan 2015 21:49:02 -0800 Organization: UCLA Computer Science Department Message-ID: <54B3604E.9020304@cs.ucla.edu> References: <54B348E8.7080203@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1421041773 22002 80.91.229.3 (12 Jan 2015 05:49:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 12 Jan 2015 05:49:33 +0000 (UTC) To: Dmitry Antipov , Emacs development discussions Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 12 06:49:27 2015 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 1YAXsU-0006Zh-Tl for ged-emacs-devel@m.gmane.org; Mon, 12 Jan 2015 06:49:27 +0100 Original-Received: from localhost ([::1]:60466 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YAXsU-0007lb-9a for ged-emacs-devel@m.gmane.org; Mon, 12 Jan 2015 00:49:26 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:44822) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YAXsH-0007kb-87 for emacs-devel@gnu.org; Mon, 12 Jan 2015 00:49:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YAXsB-00047y-W8 for emacs-devel@gnu.org; Mon, 12 Jan 2015 00:49:13 -0500 Original-Received: from smtp.cs.ucla.edu ([131.179.128.62]:56958) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YAXsB-00047s-RY for emacs-devel@gnu.org; Mon, 12 Jan 2015 00:49:07 -0500 Original-Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp.cs.ucla.edu (Postfix) with ESMTP id EE733A6004C; Sun, 11 Jan 2015 21:49:06 -0800 (PST) X-Virus-Scanned: amavisd-new at smtp.cs.ucla.edu Original-Received: from smtp.cs.ucla.edu ([127.0.0.1]) by localhost (smtp.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id zZFzPN5+16cm; Sun, 11 Jan 2015 21:49:06 -0800 (PST) Original-Received: from [192.168.1.9] (pool-173-55-11-52.lsanca.fios.verizon.net [173.55.11.52]) by smtp.cs.ucla.edu (Postfix) with ESMTPSA id A75DDA6000B; Sun, 11 Jan 2015 21:49:06 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.3.0 In-Reply-To: <54B348E8.7080203@yandex.ru> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 131.179.128.62 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:181169 Archived-At: Dmitry Antipov wrote: > DEFUN ("eq", Feq, Seq, 2, 2, 0, > doc: /* Return t if the two args are the same Lisp object. */) > +/* CONST */ Good idea, but I worry that the comments are fragile. How about the following idea for improving the proposed syntax? Move the directives to be inside the DEFUN, making it clearer that they're part of the function definition mechanism. Something like this, say: DEFUN ("eq", Feq, Seq, 2, 2, 0, doc: /* Return t if the two args are the same Lisp object. */ attribute: const) and similarly for 'noreturn' instead of (or in addition to) 'const'.