From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.devel Subject: Re: Leading * in docstrings of defcustoms. Date: Mon, 24 Nov 2008 15:36:43 -0500 Message-ID: <87wses3lpg.fsf@cyd.mit.edu> References: <8763mfsgks.fsf@speer.lan> <000601c94e55$7f997580$c2b22382@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1227560277 26751 80.91.229.12 (24 Nov 2008 20:57:57 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 24 Nov 2008 20:57:57 +0000 (UTC) Cc: 'Glenn Morris' , emacs-devel@gnu.org, 'Stefan Monnier' , 'Lute Kamstra' , 'Juanma Barranquero' To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Nov 24 21:58:57 2008 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 1L4iVq-0005O9-0E for ged-emacs-devel@m.gmane.org; Mon, 24 Nov 2008 21:58:30 +0100 Original-Received: from localhost ([127.0.0.1]:56686 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L4iUg-0001gg-BL for ged-emacs-devel@m.gmane.org; Mon, 24 Nov 2008 15:57:18 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L4iAV-00051W-9X for emacs-devel@gnu.org; Mon, 24 Nov 2008 15:36:27 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L4iAU-000517-Rx for emacs-devel@gnu.org; Mon, 24 Nov 2008 15:36:26 -0500 Original-Received: from [199.232.76.173] (port=44787 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L4iAU-000513-Gg for emacs-devel@gnu.org; Mon, 24 Nov 2008 15:36:26 -0500 Original-Received: from cyd.mit.edu ([18.115.2.24]:40754) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1L4iAS-00051q-HC; Mon, 24 Nov 2008 15:36:24 -0500 Original-Received: by cyd.mit.edu (Postfix, from userid 1000) id C349457E1C8; Mon, 24 Nov 2008 15:36:43 -0500 (EST) In-Reply-To: <000601c94e55$7f997580$c2b22382@us.oracle.com> (Drew Adams's message of "Mon, 24 Nov 2008 08:55:46 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: Genre and OS details not recognized. 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:106119 Archived-At: "Drew Adams" writes: > If you do remove `*' from defcustoms, please also update the manuals > accordingly. They should already be omitted, or strongly deprecated, in the manuals. For example, the Variable Definitions node in the Lisp manual says There is no need to start [the docstring] with a `*', because `defcustom' automatically marks `option' as a "user option" If you find a spot in the manual that still follows the old convention, please let us know. > Why is it that `*' should be removed from defcustoms? Is it simply > because they don't need it? Yes.