From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rasmus Subject: Re: Unclear org-icompleting-read interface Date: Thu, 25 Jun 2015 18:39:06 +0200 Message-ID: <871tgzlp3p.fsf@gmx.us> References: <87vbecudww.fsf@gmail.com> <877fqryjyh.fsf@nicolasgoaziou.fr> <87twtvlusk.fsf@gmx.us> <87y4j7wy0w.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:52279) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z8ALx-0003xo-Bf for emacs-orgmode@gnu.org; Thu, 25 Jun 2015 12:50:18 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Z8ALu-00051h-GE for emacs-orgmode@gnu.org; Thu, 25 Jun 2015 12:50:17 -0400 Received: from plane.gmane.org ([80.91.229.3]:36141) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Z8ALu-00050w-9P for emacs-orgmode@gnu.org; Thu, 25 Jun 2015 12:50:14 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Z8ABI-0005Ms-QA for emacs-orgmode@gnu.org; Thu, 25 Jun 2015 18:39:16 +0200 Received: from 90.163.164.75 ([90.163.164.75]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 25 Jun 2015 18:39:16 +0200 Received: from rasmus by 90.163.164.75 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 25 Jun 2015 18:39:16 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hi, Nicolas Goaziou writes: > Rasmus 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