From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#1478: 23.0.60; doc string of custom-unlispify-* Date: Sun, 10 Jul 2011 14:57:14 +0200 Message-ID: References: <002701c954da$22fdc570$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310302954 23808 80.91.229.12 (10 Jul 2011 13:02:34 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 10 Jul 2011 13:02:34 +0000 (UTC) Cc: 1478@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 10 15:02:30 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QfteX-00060a-O1 for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 15:02:29 +0200 Original-Received: from localhost ([::1]:43272 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfteW-0003N9-EM for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 09:02:28 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:35549) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qfte8-0003Md-UW for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 09:02:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qfte7-0007zi-Ep for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 09:02:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60350) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qfte7-0007ze-9B for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 09:02:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qfte6-0002X6-Rw; Sun, 10 Jul 2011 09:02:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Magne Ingebrigtsen Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 10 Jul 2011 13:02:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 1478 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug Original-Received: via spool by 1478-submit@debbugs.gnu.org id=B1478.13103028779675 (code B ref 1478); Sun, 10 Jul 2011 13:02:02 +0000 Original-Received: (at 1478) by debbugs.gnu.org; 10 Jul 2011 13:01:17 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QftdM-0002W0-6m for submit@debbugs.gnu.org; Sun, 10 Jul 2011 09:01:16 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QftdK-0002Vb-DH for 1478@debbugs.gnu.org; Sun, 10 Jul 2011 09:01:14 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qftcz-0008V9-94; Sun, 10 Jul 2011 15:00:53 +0200 In-Reply-To: <002701c954da$22fdc570$0200a8c0@us.oracle.com> (Drew Adams's message of "Tue, 2 Dec 2008 16:00:21 -0800") User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Baby Dee's _Regifted Light_: "The Pie Song" X-Hashcash: 1:23:110710:drew.adams@oracle.com::CpVdm5zg5/fjsFNy:000000000000000000000000000000000000000074zy X-Hashcash: 1:23:110710:1478@debbugs.gnu.org::0VlhWjzzCKYKeIeH:00000000000000000000000000000000000000000Vmgu X-MailScanner-ID: 1Qftcz-0008V9-94 MailScanner-NULL-Check: 1310907654.33784@tCHv0Jac3/LY/Nk/tWvJlg X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 10 Jul 2011 09:02:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48458 Archived-At: "Drew Adams" writes: > 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. I disagree. The grouping is `custom-menu', so what else could it be referring to? This would be like if all dired variables and commands had doc strings starting with "In Dired...". > 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. This is for (very special) people who want to customize the Customize low-level thingamabobs. I think they probably know what a tag is, if they want to change it. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/