Re: Unclear org-icompleting-read interface

[Rasmus <rasmus@gmx.us>]

Hi,

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:

> Rasmus <rasmus@gmx.us> writes:
>
>> I agree.  It's confusing how the docstring and the λ is written, but it's
>> just a "front-end" for completing-read.  A reference to completing-read
>> should be added to the docstring.
>
> Isn't it already the case?

I don't know.  I have been saying stupid things recently.  Lack of sleep
is probably the reason, but I like to think that somehow my org version is
messed up.


     org-icompleting-read is a compiled Lisp function in /usr/share/emacs/site-lisp/org/

     (org-icompleting-read &rest ARGS)

     Completing-read using ‘ido-mode’ or ‘iswitchb’ speedups if available.

A lot of older org functions have terrible documentation.  I had to study
the code, several calls of org-icompleting-read, and completion-read to
understand what it was doing.

>> That was my "feeling" about org-icompleting-read as well last time I
>> looked at it (also a message by Oleh).  For org 8.4 we can also get rid of
>> all the iswitchb stuff.  Good times ahead...
>
> Indeed. Can't wait...

Me to.  I hope I will have more time in Eternal September.

Rasmus

-- 
May the Force be with you