From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: Defcustoms, how do users find them? Date: Tue, 17 Nov 2009 18:56:22 +0100 Message-ID: References: <87ocn1fnko.fsf@mail.jurta.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1258480628 22092 80.91.229.12 (17 Nov 2009 17:57:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 17 Nov 2009 17:57:08 +0000 (UTC) Cc: Juri Linkov , Emacs-Devel devel To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 17 18:57:01 2009 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 1NASIW-0008Dh-5a for ged-emacs-devel@m.gmane.org; Tue, 17 Nov 2009 18:57:00 +0100 Original-Received: from localhost ([127.0.0.1]:60355 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NASIV-0001No-RP for ged-emacs-devel@m.gmane.org; Tue, 17 Nov 2009 12:56:59 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NASIQ-0001L0-38 for emacs-devel@gnu.org; Tue, 17 Nov 2009 12:56:54 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NASIL-0001D0-JS for emacs-devel@gnu.org; Tue, 17 Nov 2009 12:56:53 -0500 Original-Received: from [199.232.76.173] (port=59269 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NASIL-0001Ck-ER for emacs-devel@gnu.org; Tue, 17 Nov 2009 12:56:49 -0500 Original-Received: from mail-yx0-f191.google.com ([209.85.210.191]:60034) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NASIL-0006wZ-3C for emacs-devel@gnu.org; Tue, 17 Nov 2009 12:56:49 -0500 Original-Received: by yxe29 with SMTP id 29so286324yxe.14 for ; Tue, 17 Nov 2009 09:56:48 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :from:date:message-id:subject:to:cc:content-type; bh=bckMS3PhXFpC4fAJJLKUPL+Kfasf8LBNBvUBzANQgqA=; b=EcH96xsqEeGBAS+KfN/hkhXhyQ+46SqVqF8IO9uDadUNOyN9GoaslWRSNJYRKFqTvh EU/M6KEl2+tM7prHjgeB7vlE+CLi2hml2LeaWy3tUIKPRHK3Pam+ljTbqQqiM9D/NOyY Z02EGvkv+ReLstMEuMJaidoj9JyMCiHO3ViCY= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; b=qrNhdMEoEz4nD3QRO7NrGv9/IMo7pemK3SEyuNQPa1yqSGiPHGVWvxYbt2Y7oOTPIP y2uXGg32VrnP9N6/y1iBqf4iyKZWBp0NhS+eFlw52FbtSO1rjKKvrT80LdKfHGAkHdQp GpmpH/R/58xadcy1J4/MUJubWILprgASaOrOU= Original-Received: by 10.101.113.4 with SMTP id q4mr3638168anm.64.1258480602230; Tue, 17 Nov 2009 09:56:42 -0800 (PST) In-Reply-To: X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) 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:117109 Archived-At: On Tue, Nov 17, 2009 at 6:49 PM, Drew Adams wrote: > I agree with Lennart that it would be beneficial for users to have the _doc > strings_ of all (or at least most, if there are particular problems for some) > vanilla Emacs options available at startup. > > IMO, this is as important (no - more important) for `C-h v' and apropos as it is > for `customize-variable'. The latter would let you see a list of options, but it > wouldn't tell you anything about them. In this I disagree with Lennart, who said > that providing all options for completion by `customize-variable' would be > sufficient. I also said that help and apropos should load the libraries like customize do. That would provide the doc strings for those functions, or? If it does not then using (put 'foo 'variable-documentation "Helpful doc for `foo'.") as you suggested might be a way.