From mboxrd@z Thu Jan 1 00:00:00 1970 Path: quimby.gnus.org!not-for-mail From: Andreas Schwab Newsgroups: gmane.emacs.devel Subject: Re: lost argument and doc string Date: Wed, 13 Feb 2002 14:40:30 +0100 Message-ID: References: NNTP-Posting-Host: quimby2.netfonds.no Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: quimby2.netfonds.no 1013608426 6435 195.204.10.66 (13 Feb 2002 13:53:46 GMT) X-Complaints-To: usenet@quimby2.netfonds.no NNTP-Posting-Date: 13 Feb 2002 13:53:46 GMT Cc: Tak Ota , jasonr@gnu.org, lektu@terra.es, emacs-devel@gnu.org, andrewi@gnu.org Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby2.netfonds.no with esmtp (Exim 3.12 #1 (Debian)) id 16azqz-0001fh-00 for ; Wed, 13 Feb 2002 14:53:45 +0100 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.33 #1 (Debian)) id 16azfp-0001SM-00; Wed, 13 Feb 2002 08:42:13 -0500 Original-Received: from ns.suse.de ([213.95.15.193] helo=Cantor.suse.de) by fencepost.gnu.org with smtp (Exim 3.33 #1 (Debian)) id 16azeN-0001MK-00; Wed, 13 Feb 2002 08:40:43 -0500 Original-Received: from Hermes.suse.de (Hermes.suse.de [213.95.15.136]) by Cantor.suse.de (Postfix) with ESMTP id F14321E690; Wed, 13 Feb 2002 14:40:38 +0100 (MET) X-Authentication-Warning: sykes.suse.de: schwab set sender to schwab@suse.de using -f Original-To: Eli Zaretskii X-Yow: Gee, I feel kind of LIGHT in the head now, knowing I can't make my satellite dish PAYMENTS! In-Reply-To: (Eli Zaretskii's message of "Wed, 13 Feb 2002 07:43:56 +0200 (IST)") Original-Lines: 32 User-Agent: Gnus/5.090005 (Oort Gnus v0.05) Emacs/21.2.50 (ia64-suse-linux) Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.5 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: quimby.gnus.org gmane.emacs.devel:1063 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:1063 Eli Zaretskii writes: |> On Tue, 12 Feb 2002, Tak Ota wrote: |> |> > I did the same experiment, running make-docfile manually on simple.el, |> > and got surprised. And the source file is requesting the sequence |> > `dquote bslash newline' as the beginning of the valid doc string in |> > case of el files. I don't think this is right. Starting doc string |> > that way is only optional I believe. |> |> Please make sure that any changes you make in this don't break |> loaddefs.el. I believe loaddefs is the reason for that requirement of |> how the doc string should begin (since loaddefs is generated by a |> program, there's no problem satisfying that requirement in that case). I |> imagine that there was some reason to require such a format, in which |> case we should avoid breaking that. |> |> Richard, do you recall why this format was required? I'd guess it's just so that you don't need a full Lisp parser in make-docfile. Especially for defvar there can be an arbitrary lisp expression before the doc string, which you would have to skip carefully. With the current format you can just skip to end of line and identify the doc string immediately. Andreas. -- Andreas Schwab, SuSE Labs, schwab@suse.de SuSE GmbH, Deutschherrnstr. 15-19, D-90429 Nürnberg Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different." _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://mail.gnu.org/mailman/listinfo/emacs-devel