From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: (fn ...) - please fill it at the point of generation Date: Sun, 30 Dec 2007 02:26:05 +0900 Message-ID: <87ir2h4dle.fsf@catnip.gol.com> References: <8763yhk4nn.fsf@catnip.gol.com> Reply-To: Miles Bader NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1198949193 26871 80.91.229.12 (29 Dec 2007 17:26:33 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 29 Dec 2007 17:26:33 +0000 (UTC) Cc: Emacs-Devel To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 29 18:26:46 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1J8fSM-0007LB-AH for ged-emacs-devel@m.gmane.org; Sat, 29 Dec 2007 18:26:42 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J8fS0-0004hI-Kp for ged-emacs-devel@m.gmane.org; Sat, 29 Dec 2007 12:26:20 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1J8fRv-0004f8-Q4 for emacs-devel@gnu.org; Sat, 29 Dec 2007 12:26:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1J8fRu-0004dB-Bb for emacs-devel@gnu.org; Sat, 29 Dec 2007 12:26:15 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J8fRu-0004d2-2X for emacs-devel@gnu.org; Sat, 29 Dec 2007 12:26:14 -0500 Original-Received: from smtp02.dentaku.gol.com ([203.216.5.72]) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1J8fRq-0006dR-05; Sat, 29 Dec 2007 12:26:10 -0500 Original-Received: from 203-216-100-219.dsl.gol.ne.jp ([203.216.100.219] helo=catnip.gol.com) by smtp02.dentaku.gol.com with esmtpa (Dentaku) id 1J8fRn-0004XB-JA; Sun, 30 Dec 2007 02:26:07 +0900 Original-Received: by catnip.gol.com (Postfix, from userid 1000) id EAD562FF7; Sun, 30 Dec 2007 02:26:05 +0900 (JST) System-Type: i686-pc-linux-gnu In-Reply-To: (Drew Adams's message of "Sat, 29 Dec 2007 07:53:17 -0800") Original-Lines: 21 X-Abuse-Complaints: abuse@gol.com X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:85618 Archived-At: "Drew Adams" writes: >> It's really not part of the doc string as such, it's an interface >> description. > > That's a good feint. This part of the doc string isn't right, so to fix > things we'll just say it's not part of the doc string. No, it was always intended as a function signature, not a text string for display. It's put into the _raw_ docstring because that's a convenient place to put it, but it is intended that this be filtered appropriately for display. > Oh, you mean where you simply declare it not to be part of the doc string? No, the part where I tell you how things have been designed. -Miles -- `To alcohol! The cause of, and solution to, all of life's problems' --Homer J. Simpson