all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Kenichi Handa <handa@m17n.org>
To: Stefan Monnier <monnier@IRO.UMontreal.CA>
Cc: 9653@debbugs.gnu.org
Subject: bug#9653: 24.0.50; `ucs-names' - Why all of the ("" . XXX) entries?
Date: Wed, 05 Oct 2011 17:59:06 +0900	[thread overview]
Message-ID: <tl7wrcjak6d.fsf@m17n.org> (raw)
In-Reply-To: <74B14D2A03144E798C9415172D5FE01A@us.oracle.com>

You wrote:

> >> - even less so when it talks about internal APIs rather than about
> >> externally-visible behavior.
> > I think that UCD is talking about external visible behaviour.
> 
> If so, it doesn't apply to the behavior of (get-char-code-property CHAR
> 'name) which is an internal detail.

I think what get-char-code-proeprty returns belongs to an
external API, and currently I put this docstring to `name'
property.

"Unicode character name.
Property value is a string."

So, when one wants to know a Unicode name of a character, he
can call get-char-code-proeprty and it should return "".

> >> - "null string" can mean nil just as well as it can mean "".
> > But, as I wrote, nil usually means
> > no-value/not-specified/unassigned/unknown, which is
> > different from the explicit "".
> 
> Indeed, and that's why I prefer nil: a char's name should be pretty much
> unique and descriptive, so "" really isn't a char name, it just means
> "this char doesn't have a name" and in Elisp we usually represent this
> with nil.

Perhaps we are requesting two functionalities to
get-char-code-property.  One is to return the specific name
of a character or nil if it doesn't have such a name, the
other is to just return a name that Unicode defines for a
character.  As there's just one function at the moment, we
should find which functionality is more useful.

> >> So was there some other motivation (e.g. simpler implementation?
> > No.
> 
> Then please revert it to using nil.

So, your opinion is that the former functionality is more
useful, right?

Then, ok, I'll change it back, and, change the above
docstring accordingly.

> >> Simpler code somewhere else?)?
> > Yes, hypothetically.  You can safely write, for instance,
> >   (search-forward (get-char-code-property CHAR 'name) ...)
> > or
> >   (insert (get-char-code-property CHAR 'name) ...)
> > without checking the return value.
> 
> I doubt there will ever be code that can do the above because the ""
> case will need special treatment.
> 
> So we end comparing things like
> 
>   (insert (or (get-char-code-property CHAR 'name) "<Unnamed>"))
> with
>   (insert (let ((name (get-char-code-property CHAR 'name)))
>             (if (equal name "") "<Unnamed>" name)))
> 
> where nil is clearly a more convenient choice.

I'll repeat that when one want to know what Unicode says
about the name of a character, the answer is "", not
"<Unnamed>".

> >> If not (i.e. all things being equal) I'd prefer to use nil which is
> >> ever so slightly closer to usual Elisp practice,
> > Really?  I've thought nil and "" are rather different object in Elisp.
> 
> Of course they are, nil usually means "not found" or something like
> that, and I think it suits this case perfectly.

I'm not sure because there are multiple use-cases of
get-char-code-property, and nil is better only in some of
them.  But, it's just "I'm not sure".  If you are sure, as I
wrote above, I'll change it back.

---
Kenichi Handa
handa@m17n.org





  parent reply	other threads:[~2011-10-05  8:59 UTC|newest]

Thread overview: 49+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <<74B14D2A03144E798C9415172D5FE01A@us.oracle.com>
     [not found] ` <<tl7fwe65odg.fsf@m17n.org>
2011-10-02 16:36   ` bug#9653: 24.0.50; `ucs-names' - Why all of the ("" . XXX) entries? Drew Adams
2011-10-02 17:38     ` Drew Adams
2011-10-02 22:31       ` Juanma Barranquero
2011-10-02 22:51         ` Drew Adams
2011-10-02 22:55           ` Juanma Barranquero
2011-10-03 13:20           ` Jason Rumney
2011-10-03 13:56             ` Drew Adams
2011-10-03 14:00               ` Juanma Barranquero
2011-10-02 18:09     ` Thierry Volpiatto
2011-10-03  1:28     ` Stefan Monnier
2011-10-03  4:23       ` Kenichi Handa
2011-10-03  8:22         ` Andreas Schwab
2011-10-04  1:14           ` Kenichi Handa
2011-10-03 13:31         ` Stefan Monnier
2011-10-04  1:59           ` Kenichi Handa
2011-10-04 12:56             ` Stefan Monnier
2011-10-06  3:53             ` Kevin Rodgers
2011-10-06 12:19               ` Juanma Barranquero
2011-10-06 13:02                 ` Andreas Schwab
2011-10-06 13:47                   ` Juanma Barranquero
2011-10-06 14:01                     ` Andreas Schwab
2011-10-06 14:02                       ` Juanma Barranquero
2011-10-04  2:19         ` Drew Adams
2011-10-04  4:02           ` Kenichi Handa
2011-10-04 13:43             ` Drew Adams
2011-10-04 17:34               ` Drew Adams
2011-10-04 18:19                 ` Eli Zaretskii
2011-10-04 18:30                   ` Drew Adams
2011-10-04 20:55                     ` Eli Zaretskii
2011-10-04 21:39                     ` Stefan Monnier
2011-10-04 22:03                       ` Drew Adams
2011-10-05  4:11                         ` Eli Zaretskii
2011-10-05 13:20                           ` Drew Adams
2011-10-05 17:24                             ` Eli Zaretskii
2011-10-05  8:59     ` Kenichi Handa [this message]
2011-10-05 10:20       ` Eli Zaretskii
2011-10-05 12:40         ` Stefan Monnier
2011-10-06 18:02           ` Eli Zaretskii
2011-10-06 20:56             ` Stefan Monnier
2012-01-14 18:35               ` Drew Adams
2012-02-17 15:55     ` Drew Adams
2018-02-13 23:35     ` Drew Adams
2018-02-15  1:11       ` Noam Postavsky
2018-02-15  3:17         ` Drew Adams
     [not found] <tl74nupdi7g.fsf@m17n.org>
2012-02-17 15:25 ` Stefan Monnier
     [not found]   ` <7CCDEE21B0ED42B097600BB24692952A@us.oracle.com>
2012-02-17 23:42     ` Stefan Monnier
2012-02-18  0:05       ` Drew Adams
     [not found]         ` <8339a8wp2m.fsf@gnu.org>
2012-02-18 19:08           ` Drew Adams
2012-02-20  0:39   ` Kenichi Handa

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=tl7wrcjak6d.fsf@m17n.org \
    --to=handa@m17n.org \
    --cc=9653@debbugs.gnu.org \
    --cc=monnier@IRO.UMontreal.CA \
    /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.