From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#1478: 23.0.60; doc string of custom-unlispify-* Date: Tue, 2 Dec 2008 16:00:21 -0800 Message-ID: <002701c954da$22fdc570$0200a8c0@us.oracle.com> Reply-To: Drew Adams , 1478@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1228263087 23473 80.91.229.12 (3 Dec 2008 00:11:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 3 Dec 2008 00:11:27 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 03 01:12:30 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L7fLn-0000ZA-4a for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Dec 2008 01:12:19 +0100 Original-Received: from localhost ([127.0.0.1]:49936 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L7fKc-0001qV-N6 for geb-bug-gnu-emacs@m.gmane.org; Tue, 02 Dec 2008 19:11:06 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L7fJr-0000rq-2k for bug-gnu-emacs@gnu.org; Tue, 02 Dec 2008 19:10:19 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L7fJp-0000oU-BK for bug-gnu-emacs@gnu.org; Tue, 02 Dec 2008 19:10:17 -0500 Original-Received: from [199.232.76.173] (port=36527 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L7fJo-0000o5-0b for bug-gnu-emacs@gnu.org; Tue, 02 Dec 2008 19:10:16 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:46232) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L7fJn-0002Rv-Es for bug-gnu-emacs@gnu.org; Tue, 02 Dec 2008 19:10:15 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mB30ACGj014152; Tue, 2 Dec 2008 16:10:13 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mB305522012250; Tue, 2 Dec 2008 16:05:05 -0800 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Wed, 03 Dec 2008 00:05:04 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1478 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.122826242711328 (code B ref -1); Wed, 03 Dec 2008 00:05:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 3 Dec 2008 00:00:27 +0000 Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mB300OsE011233 for ; Tue, 2 Dec 2008 16:00:25 -0800 Original-Received: from mail.gnu.org ([199.232.76.166]:44514 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1L7f9q-0000Lk-4F for emacs-pretest-bug@gnu.org; Tue, 02 Dec 2008 18:59:58 -0500 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1L7fAF-0001h5-07 for emacs-pretest-bug@gnu.org; Tue, 02 Dec 2008 19:00:24 -0500 Original-Received: from rcsinet12.oracle.com ([148.87.113.124]:41049 helo=rgminet12.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L7fAE-0001gz-MN for emacs-pretest-bug@gnu.org; Tue, 02 Dec 2008 19:00:22 -0500 Original-Received: from acsinet13.oracle.com (acsinet13.oracle.com [141.146.126.235]) by rgminet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mB30076d022165 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 3 Dec 2008 00:00:09 GMT Original-Received: from acsmt707.oracle.com (acsmt707.oracle.com [141.146.40.85]) by acsinet13.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mB300beG001150 for ; Wed, 3 Dec 2008 00:00:38 GMT Original-Received: from dradamslap1 (/141.144.65.247) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 02 Dec 2008 16:00:15 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AclU2iKeiyjnKG/CSyKdX9qm2SGE+A== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt707.oracle.com [141.146.40.85] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A09020A.4935CC11.0130:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Tue, 02 Dec 2008 19:10:17 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:22869 gmane.emacs.pretest.bugs:23438 Archived-At: 1. The doc string of `custom-unlispify-menu-entries' says only this: "Display menu entries as words instead of symbols if non-nil." What menu entries? Which menu? It took me a while, searching and experimenting, to find that this is about the `Custom' menu's submenus. Please clarify what this is for in the doc string. 2. The doc string of `custom-unlispify-tag-names' says only this: "Display tag names as words instead of symbols if non-nil." What's a tag name? This won't make much sense to an Emacs user who isn't savvy to Emacs Lisp, `defcustom' :type, and :tag. Please explain this better. A simple illustrative example never hurts: show what happens if it's nil vs if it's non-nil. These doc strings are all the user has to go on, since these options are not described in any manual. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-11-24 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping'