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: Wed, 9 Sep 2015 07:57:13 -0700 (PDT) Message-ID: 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 1441820519 32597 80.91.229.3 (9 Sep 2015 17:41:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 9 Sep 2015 17:41:59 +0000 (UTC) To: 21448@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Sep 09 19:41:46 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 1ZZjNR-0006GN-Iu for geb-bug-gnu-emacs@m.gmane.org; Wed, 09 Sep 2015 19:41:45 +0200 Original-Received: from localhost ([::1]:43621 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZhnL-0003SH-82 for geb-bug-gnu-emacs@m.gmane.org; Wed, 09 Sep 2015 12:00:23 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59079) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZhnB-0003Ou-Eo for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 12:00:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZZhn3-0001bL-Ot for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 12:00:09 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33580) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZhn3-0001a7-MV for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 12:00:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZZhn2-00073a-H6 for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 12:00:04 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 09 Sep 2015 16:00:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 21448 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.144181434427028 (code B ref -1); Wed, 09 Sep 2015 16:00:04 +0000 Original-Received: (at submit) by debbugs.gnu.org; 9 Sep 2015 15:59:04 +0000 Original-Received: from localhost ([127.0.0.1]:54023 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZZhm3-00071r-EY for submit@debbugs.gnu.org; Wed, 09 Sep 2015 11:59:03 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:48656) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZZhm1-00071S-6P for submit@debbugs.gnu.org; Wed, 09 Sep 2015 11:59:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZZhlw-0001DL-Ql for submit@debbugs.gnu.org; Wed, 09 Sep 2015 11:59:00 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:55362) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZhlw-0001DH-NH for submit@debbugs.gnu.org; Wed, 09 Sep 2015 11:58:56 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:57231) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZgoM-0006qX-Bc for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 10:57:27 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZZgoH-0001X9-4w for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 10:57:22 -0400 Original-Received: from userp1040.oracle.com ([156.151.31.81]:22659) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZgoG-0001Wv-Sy for bug-gnu-emacs@gnu.org; Wed, 09 Sep 2015 10:57:17 -0400 Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t89EvEeu013921 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 9 Sep 2015 14:57:15 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t89EvEbo012524 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Wed, 9 Sep 2015 14:57:14 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserv0121.oracle.com (8.13.8/8.13.8) with ESMTP id t89EvE7u023230 for ; Wed, 9 Sep 2015 14:57:14 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: aserv0021.oracle.com [141.146.126.233] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). 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:106315 Archived-At: 1. In node `Categories' you give an example that is incomprehensible, as it uses function `unicode-property-table-internal', which is not explained anywhere in the manual. With just the doc string of that function to go on, it is difficult, if not impossible, to understand the example. There is a cross-reference to node `Bidirectional Display', but that node, although quite long (and with large, verbose paragraphs) does not seem to help with understanding the example. It didn't help me, at least. Please consider adding a little explanation of the example, including, for instance, what table `uniprop-table' is being used for. Adding a docstring for the `defvar' would also help. 2. The example also not indented properly - see the second `let' binding (which also needs to be on two lines, as it is too long if indented properly). 3. Please consider also adding to the description of each of the functions described in this node the statement that TABLE defaults to the current buffer=3DA1=3DAFs category table - as opposed to having this statement only in the sentence preceding the individual function descriptions. Each description acts somewhat like a doc string - it would help if it were pretty much self-contained. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-08-16 on LEG570 Bzr revision: f7ee23e587b01f179284b5554c67d579a2def676 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --host=3D3Di686-pc-mingw32 --enable-checking=3D3Dyes,glyphs'