From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: doc elisp intro cross reference fixes Date: Tue, 18 Nov 2003 23:28:53 -0600 (CST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200311190528.hAJ5SrK02553@raven.dms.auburn.edu> References: <87wua28zux.fsf@zip.com.au> <87ad6vdsxi.fsf@mail.jurta.org> <200311190418.hAJ4ITC02466@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1069220322 20827 80.91.224.253 (19 Nov 2003 05:38:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 19 Nov 2003 05:38:42 +0000 (UTC) Cc: bob@rattlesnake.com, rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Nov 19 06:38:38 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AML30-0006Le-00 for ; Wed, 19 Nov 2003 06:38:38 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AML2t-00014Q-00 for ; Wed, 19 Nov 2003 06:38:31 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AMLxC-00051Y-8x for emacs-devel@quimby.gnus.org; Wed, 19 Nov 2003 01:36:42 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AMLx7-00051M-Av for emacs-devel@gnu.org; Wed, 19 Nov 2003 01:36:37 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AMLwb-0004zC-O0 for emacs-devel@gnu.org; Wed, 19 Nov 2003 01:36:36 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AMLwb-0004z7-F2; Wed, 19 Nov 2003 01:36:05 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id hAJ5YhKk015246; Tue, 18 Nov 2003 23:34:43 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id hAJ5SrK02553; Tue, 18 Nov 2003 23:28:53 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: monnier@IRO.UMontreal.CA In-reply-to: (message from Stefan Monnier on 18 Nov 2003 23:29:51 -0500) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:17909 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17909 Stefan Monnier wrote: After (defcustom foobar 1 "hello"), set-variable is quite happy to let me set the variable `foobar'. On second thought, I believe that is a bug. >>From (elisp)Variable Definitions: - Macro: defcustom option default doc [keyword value]... Declare OPTION as a customizable user option variable. Do not quote OPTION. The argument DOC specifies the documentation string for the variable. It should often start with a `*' to mark it as a "user option" (*note Defining Variables::). Do not start the documentation string with `*' for options which cannot or normally should not be set with `set-variable'; examples of the former are global minor mode options such as `global-font-lock-mode' and examples of the latter are hooks. Sincerely, Luc.