Re: [O] Unclear org-icompleting-read interface

[Rasmus]

Hi,

Nicolas Goaziou <address@hidden> writes:

> Rasmus <address@hidden> 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