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#9653: 24.0.50; `ucs-names' - Why all of the ("" . XXX) entries? Date: Mon, 3 Oct 2011 06:56:49 -0700 Message-ID: References: <74B14D2A03144E798C9415172D5FE01A@us.oracle.com><3EB320EE64B3419489F05F06AE8B3486@us.oracle.com><28E4630817FC4AA3AA0BF93ACEFB84DC@us.oracle.com> <87sjna1aay.fsf@gnu.org> 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 1317650277 13428 80.91.229.12 (3 Oct 2011 13:57:57 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 3 Oct 2011 13:57:57 +0000 (UTC) Cc: 'Juanma Barranquero' , 9653@debbugs.gnu.org To: "'Jason Rumney'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 03 15:57:52 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 1RAj1g-0005ZD-HN for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Oct 2011 15:57:48 +0200 Original-Received: from localhost ([::1]:35118 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RAj1g-0000uV-57 for geb-bug-gnu-emacs@m.gmane.org; Mon, 03 Oct 2011 09:57:48 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:36649) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RAj1c-0000uD-U8 for bug-gnu-emacs@gnu.org; Mon, 03 Oct 2011 09:57:45 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RAj1X-0008KX-2c for bug-gnu-emacs@gnu.org; Mon, 03 Oct 2011 09:57:44 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:38497) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RAj1W-0008KO-W0 for bug-gnu-emacs@gnu.org; Mon, 03 Oct 2011 09:57:39 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1RAj2r-0001NS-Vu for bug-gnu-emacs@gnu.org; Mon, 03 Oct 2011 09:59:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 03 Oct 2011 13:59:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9653 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 9653-submit@debbugs.gnu.org id=B9653.13176502965235 (code B ref 9653); Mon, 03 Oct 2011 13:59:01 +0000 Original-Received: (at 9653) by debbugs.gnu.org; 3 Oct 2011 13:58:16 +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 1RAj27-0001MN-0C for submit@debbugs.gnu.org; Mon, 03 Oct 2011 09:58:15 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1RAj24-0001MF-8s for 9653@debbugs.gnu.org; Mon, 03 Oct 2011 09:58:13 -0400 Original-Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p93DujTD012189 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 3 Oct 2011 13:56:47 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p93DuiR4029156 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 3 Oct 2011 13:56:45 GMT Original-Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p93DucoV003124; Mon, 3 Oct 2011 08:56:39 -0500 Original-Received: from dradamslap1 (/10.159.61.165) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 03 Oct 2011 06:56:38 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87sjna1aay.fsf@gnu.org> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 Thread-Index: AcyBzz94SYg+/GnmTn2HCXBj+64wkAAAe9YA X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090207.4E89BF20.0062,ss=1,re=0.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 03 Oct 2011 09:59:01 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) 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:52111 Archived-At: > > It should be obvious that a data structure such as > > `ucs-names' is useful even outside of reading a > > character name with `read-char-by-name'. > > > > I predict that we'll find that the former is in fact > > more generally useful than the latter. > > It should be obvious that any variable with scant documentation that > starts off "Alist of cached..." is internal to something, and > probably not very useful outside of that. Bzzzzt! No, but thanks for playing. Scant documentation does not necessarily mean anything in particular - it can mean anything at all. And just because a variable caches a value does not necessarily mean that it is internal to something and is useless outside that something. More importantly, this is not so much about the variable as the function that is its front end. It is really about the combination of the two, which together act as a (constant) data structure. If you are only trying to say that the var is internal to the function of the same name, then fine. Thus we (properly) document the function, mentioning its cache variable: "Return [an] alist of...pairs cached in `ucs-names'." It is that doc that could be enhanced, to help users. But if you, like Juanma, are trying to say that `ucs-names' is internal to function `read-char-by-name', then no. This is a good example of the falsehood of such claims. `ucs-names' is used by 3rd-party code, and in situations where `read-char-by-name' is not used at all.