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#21448: 25.0.50; `unicode-property-table-internal' in Elisp manual Date: Thu, 10 Sep 2015 08:27:46 -0700 (PDT) Message-ID: References: <> <<83io7j5rye.fsf@gnu.org>> <<029d2a95-ca25-48be-bf19-2159ed753d81@default>> <<83fv2n573m.fsf@gnu.org>> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1441898927 11416 80.91.229.3 (10 Sep 2015 15:28:47 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 10 Sep 2015 15:28:47 +0000 (UTC) Cc: 21448@debbugs.gnu.org To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Sep 10 17:28:34 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Za3m2-0001rO-4b for geb-bug-gnu-emacs@m.gmane.org; Thu, 10 Sep 2015 17:28:30 +0200 Original-Received: from localhost ([::1]:49830 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Za3m1-0006sK-D4 for geb-bug-gnu-emacs@m.gmane.org; Thu, 10 Sep 2015 11:28:29 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47187) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Za3le-0006Hf-42 for bug-gnu-emacs@gnu.org; Thu, 10 Sep 2015 11:28:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Za3la-0008Eu-2c for bug-gnu-emacs@gnu.org; Thu, 10 Sep 2015 11:28:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:34869) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Za3lZ-0008EG-W9 for bug-gnu-emacs@gnu.org; Thu, 10 Sep 2015 11:28:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1Za3lZ-0004oZ-KH for bug-gnu-emacs@gnu.org; Thu, 10 Sep 2015 11:28:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 10 Sep 2015 15:28:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 21448 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 21448-submit@debbugs.gnu.org id=B21448.144189887418492 (code B ref 21448); Thu, 10 Sep 2015 15:28:01 +0000 Original-Received: (at 21448) by debbugs.gnu.org; 10 Sep 2015 15:27:54 +0000 Original-Received: from localhost ([127.0.0.1]:55311 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Za3lR-0004oB-MJ for submit@debbugs.gnu.org; Thu, 10 Sep 2015 11:27:53 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:39266) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1Za3lP-0004o0-PH for 21448@debbugs.gnu.org; Thu, 10 Sep 2015 11:27:52 -0400 Original-Received: from aserv0022.oracle.com (aserv0022.oracle.com [141.146.126.234]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t8AFRnVj027151 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 10 Sep 2015 15:27:50 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by aserv0022.oracle.com (8.13.8/8.13.8) with ESMTP id t8AFRmRB011909 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL); Thu, 10 Sep 2015 15:27:48 GMT Original-Received: from abhmp0013.oracle.com (abhmp0013.oracle.com [141.146.116.19]) by userv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t8AFRmTf006153; Thu, 10 Sep 2015 15:27:48 GMT In-Reply-To: <<83fv2n573m.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0022.oracle.com [141.146.126.234] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.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:106345 Archived-At: > OK, then please provide more details about what information should be > added to explain the example. I think the code is straightforward, it > just loops over a char-table, which is clear from the code. What is > missing? >=20 > I really need that help, if you want any changes. Just repeating that > the example is not clear enough doesn't cut it. Thank you for looking into this. Let me start by saying that the first part of the node, which explains categories, is very clear and well put. I think that all that is missing wrt explaining the example is to say (in this node) what `uniprop-table' is here, and why and how it is used. A minor help might be to rename variable `uniprop-table' to, say, `bidi-class-table' or `bidi-table'. I don't know enough about bidi or `unicode-property-table-internal' to really know what this char-table is: what its char entries are mapped to. Something to do with character property `bidi-class' (a property I am not familiar with). Maybe it means that a char entry is mapped by the table to all of the chars in its bidi class? These bidi things are clear to you, but not necessarily to a reader of this node. A few words about this might help. If the use of `bidi-class-table' is clarified (explained a bit) then I think the example becomes clear. You iterate over `bidi-class-table', and for any char that the table maps to R, AL, or RLO, you modify that same char's entry in the new `category-table', so that the char gets mapped in `category-table' to the character ?R (which represents its category) . It might also help if function `modify-category-entry' were presented before this example, but that's not critical. HTH. Feel free to close the bug if you disagree about adding some explanation here. (Well, it's already closed, I guess.)