[Uim] Suggestion: im-label-name

[YamaKen]

At Sat, 15 Jan 2005 04:34:38 +0900,
tkng at xem.jp wrote:
> 
> On Fri, 14 Jan 2005 05:21:52 +0900
> YamaKen <yamaken at bp.iij4u.or.jp> wrote:
> 
> > I welcome better name. But human-readable-name is not. It makes
> > confusion since im-name is also human readable (e.g. 'anthy).
> 
> IMHO the existence of uim_get_im_human_readable_name doesn't mean
> im-name is not human readable.

Existence of im-name means that the word "human readable"
provides no information about its role since im-name may be an
human readable name.

If we can revise the uim API, im-name should also be renamed to
more specific one such as im-idname to indicate its role. But
now is not the time, so we have to indicate the difference of
the two functions by naming latter one obviously.

> > At Fri, 14 Jan 2005 03:58:30 +0900,
> > tkng at xem.jp wrote:
> > >  Label is already used elsewhere. (prop_label, custom_label,
> > according> and so on.)
> > 
> > Both prop_label and custom-label contatins the name 'label'
> > since they are intended to be used as "label of widget".
> 
> I guessed what you mean by the word label, and noticed that why I'm
> uncomfortable with label-name. If I'm according to your words, we should
> use uim_get_im_label or uim_get_im_name_label, not _label_name. Since
> label_name is suggestive of 'name of label'.

I've understood what you felt. Okay, label-name is having
ambiguous meaning and we should rename it.

> > The name im-label-name is also. So there is no reason
> > distinguishing them, I think. I'll search for another solution
> > if you are still feeling odd.
> 
> As described above, I can allow uim_get_im_label or
> uim_get_im_name_label. But IMHO human_readable_name is better. How about
> uim_get_im_name_for_display?

Feeling not enough. I suggest im-explanatory-name. Would you
accept it?

By the way, do you mean that C API
(uim_get_im_explanatory_name()) is also required?

-------------------------------
YamaKen  yamaken at bp.iij4u.or.jp