From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lute Kamstra Newsgroups: gmane.emacs.devel Subject: Re: Documenting define-generic-mode. Date: Fri, 29 Apr 2005 08:58:24 +0200 Message-ID: <87oebyjchb.fsf@xs4all.nl> References: <87mzrqpzye.fsf@xs4all.nl> <87ekcvxb5t.fsf@xs4all.nl> <200504290015.j3T0FWA07161@raven.dms.auburn.edu> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1114757858 12765 80.91.229.2 (29 Apr 2005 06:57:38 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 29 Apr 2005 06:57:38 +0000 (UTC) Cc: rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Apr 29 08:57:34 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DRPRC-0005v9-2K for ged-emacs-devel@m.gmane.org; Fri, 29 Apr 2005 08:57:22 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DRPXS-000294-Ai for ged-emacs-devel@m.gmane.org; Fri, 29 Apr 2005 03:03:50 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DRPVC-0001wa-OK for emacs-devel@gnu.org; Fri, 29 Apr 2005 03:01:31 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DRPV7-0001vu-7u for emacs-devel@gnu.org; Fri, 29 Apr 2005 03:01:27 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DRPV3-00087E-10 for emacs-devel@gnu.org; Fri, 29 Apr 2005 03:01:22 -0400 Original-Received: from [194.109.24.33] (helo=smtp-vbr13.xs4all.nl) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DRPWe-0007W2-3T; Fri, 29 Apr 2005 03:03:00 -0400 Original-Received: from pijl (a80-127-67-124.adsl.xs4all.nl [80.127.67.124]) by smtp-vbr13.xs4all.nl (8.12.11/8.12.11) with ESMTP id j3T6wPJF038547; Fri, 29 Apr 2005 08:58:25 +0200 (CEST) (envelope-from Lute.Kamstra@xs4all.nl) Original-Received: from lute by pijl with local (Exim 3.36 #1 (Debian)) id 1DRPSC-000165-00; Fri, 29 Apr 2005 08:58:24 +0200 Original-To: Luc Teirlinck In-Reply-To: <200504290015.j3T0FWA07161@raven.dms.auburn.edu> (Luc Teirlinck's message of "Thu, 28 Apr 2005 19:15:32 -0500 (CDT)") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) Original-Lines: 26 X-Virus-Scanned: by XS4ALL Virus Scanner 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:36493 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:36493 Luc Teirlinck writes: > Lute Kamstra wrote: > > This macro creates a new generic mode. The argument @var{mode} is > the name of the command for the generic mode; it need not be quoted. > > "Name" sounds like a string. "need not" sounds like it is up to the > user whether he quotes it or not. Is this really correct or is it > true that it must not be quoted? Of course, the same problems apply > to the docstring from which the above quote was copied. I wrote the docstring too. :-) It's true that it is up to the user to quote the symbol or not. define-generic-mode used to be a function, so MODE needed to be quoted. When I rewrote it into a macro, I opted for an unquoted MODE. Similar defining macros use unquoted symbols too. To be backward compatible, quoting the symbol is still allowed. > What about: > > This macro creates a new generic mode. @var{mode} (an unquoted symbol) > is the major mode command. That's fine with me. Lute.