From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#1478: 23.0.60; doc string of custom-unlispify-* Date: Sun, 10 Jul 2011 10:13:59 -0700 Message-ID: <6341B9EB0F2F47EDAE765CD8E01F748A@us.oracle.com> References: <002701c954da$22fdc570$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310318141 2311 80.91.229.12 (10 Jul 2011 17:15:41 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 10 Jul 2011 17:15:41 +0000 (UTC) To: 1478@emacsbugs.donarmstrong.com, 1478@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 10 19:15:35 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 1QfxbT-0004Gk-1W for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 19:15:35 +0200 Original-Received: from localhost ([::1]:39605 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfxbR-00075W-JD for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 13:15:33 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:47550) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qfxaz-0006zY-Eo for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:15:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qfxax-0000Vp-My for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:15:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49991) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qfxax-0000Vi-Bx for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:15:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qfxaw-0006ya-QD; Sun, 10 Jul 2011 13:15:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" 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 17:15: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 X-Debbugs-Original-To: <1478@emacsbugs.donarmstrong.com>, Original-Received: via spool by submit@debbugs.gnu.org id=B.131031809226777 (code B ref -1); Sun, 10 Jul 2011 17:15:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 10 Jul 2011 17:14:52 +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 1Qfxam-0006xp-BG for submit@debbugs.gnu.org; Sun, 10 Jul 2011 13:14:52 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qfxak-0006xe-NV for submit@debbugs.gnu.org; Sun, 10 Jul 2011 13:14:51 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:41797) by fencepost.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1Qfxaf-0004Nv-G5 for emacs-pretest-bug@gnu.org; Sun, 10 Jul 2011 13:14:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qfxad-0000TX-J8 for emacs-pretest-bug@gnu.org; Sun, 10 Jul 2011 13:14:44 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:51483) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qfxad-0000TK-3C for emacs-pretest-bug@gnu.org; Sun, 10 Jul 2011 13:14:43 -0400 Original-Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6AHEXdD016897 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Jul 2011 17:14:36 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6AHEWGB000360 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 10 Jul 2011 17:14:33 GMT Original-Received: from abhmt105.oracle.com (abhmt105.oracle.com [141.146.116.57]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6AHERRe000674; Sun, 10 Jul 2011 12:14:27 -0500 Original-Received: from dradamslap1 (/10.159.32.168) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 10 Jul 2011 10:14:26 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <002701c954da$22fdc570$0200a8c0@us.oracle.com> Thread-Index: AclU2iKeiyjnKG/CSyKdX9qm2SGE+IXUkswQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090204.4E19DDFC.0070:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 10 Jul 2011 13:15: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:48489 Archived-At: 1. I did not receive Lars's message explaining why he thinks this is not a bug. Something wrong with the bug tracker? I received a `close' message that said nothing more than it is closed. I had to go to the web site to see Lars's message. 2. I disagree with everything Lars wrote about this bug. a. This is about _doc strings_. It is not about the Customize UI. b. `custom-unlispify-menu-entries': Please mention in the doc string what menu is involved, and which menu entries. c. `custom-unlispify-tag-names': No, this is not only "for (very special) people who want to Customize low-level thingamabobs." Just because you might not be interested in understanding this function, do not assume that someone who wants to understand it intends to customize low-level Customize thingamabobs. I, as one user who wants to understand this, and who went to the trouble to file a detailed bug report about missing info, do not know what is meant by a "tag" in this context. I have no intention of changing a tag (esp. since I don't even know what is being referred to here by that name). But I want to understand this doc string. These doc strings are for users. So far, they are not comprehensible.