From: Eli Zaretskii <eliz@gnu.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: 21448@debbugs.gnu.org
Subject: bug#21448: 25.0.50; `unicode-property-table-internal' in Elisp manual
Date: Wed, 09 Sep 2015 22:10:49 +0300 [thread overview]
Message-ID: <83io7j5rye.fsf@gnu.org> (raw)
In-Reply-To: <bb3f44a8-1141-4e3c-8694-26fe89e134e5@default>
> Date: Wed, 9 Sep 2015 07:57:13 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
>
> 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.
The doc string of unicode-property-table-internal says:
(unicode-property-table-internal PROP)
Return a char-table for Unicode character property PROP.
What exactly is unclear about that? That's an honest question: this
sounds crystal clear to me.
> 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.
That cross-reference is for those who don't know what is "strong
right-to-left directionality".
> Please consider adding a little explanation of the example, including,
> for instance, what table `uniprop-table' is being used for.
It is used as an argument to map-char-table, as should be clear from
the example. Once again, I don't see what should be explained about
that.
> Adding a docstring for the `defvar' would also help.
This text before the example:
Here's an example of defining a new category for characters that
have strong right-to-left directionality
is all that can be said about that defvar.
> 2. The example also not indented properly - see the second `let' binding
Fixed (someone left TABs in the Texinfo source, which is a no-no).
> 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's category table - as opposed to having this
> statement only in the sentence preceding the individual function
> descriptions.
I don't see why this should be an issue -- that sentence immediately
precedes the description of the functions.
next prev parent reply other threads:[~2015-09-09 19:10 UTC|newest]
Thread overview: 9+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-09-09 14:57 bug#21448: 25.0.50; `unicode-property-table-internal' in Elisp manual Drew Adams
2015-09-09 19:10 ` Eli Zaretskii [this message]
[not found] <<bb3f44a8-1141-4e3c-8694-26fe89e134e5@default>
[not found] ` <<83io7j5rye.fsf@gnu.org>
2015-09-09 20:07 ` Drew Adams
2015-09-10 2:41 ` Eli Zaretskii
[not found] ` <<029d2a95-ca25-48be-bf19-2159ed753d81@default>
[not found] ` <<83fv2n573m.fsf@gnu.org>
2015-09-10 15:27 ` Drew Adams
2015-09-10 15:30 ` Drew Adams
2015-09-10 17:12 ` Eli Zaretskii
[not found] ` <<a7354d8a-de19-45f5-843c-792465d2a123@default>
[not found] ` <<831te65hcc.fsf@gnu.org>
2015-09-10 17:23 ` Drew Adams
2015-09-10 17:40 ` Eli Zaretskii
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=83io7j5rye.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=21448@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.