From mboxrd@z Thu Jan 1 00:00:00 1970 From: Richard Riley Subject: Re: org-iswitchb documentation Date: Tue, 29 Jun 2010 11:44:55 +0200 Message-ID: References: <20386.1277720390@maps> <2E246530-D91C-424E-82F1-D9BD5B18AD0B@gmail.com> <3065.1277727993@maps> <5159.1277799284@maps> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from [140.186.70.92] (port=48931 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OTXNL-0006XU-Hc for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:45:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OTXNK-0004kt-9n for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:45:07 -0400 Received: from lo.gmane.org ([80.91.229.12]:36630) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OTXNJ-0004ka-VZ for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:45:06 -0400 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1OTXNH-0005Q4-MR for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 11:45:03 +0200 Received: from 85.183.18.158 ([85.183.18.158]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 29 Jun 2010 11:45:03 +0200 Received: from rileyrg by 85.183.18.158 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 29 Jun 2010 11:45:03 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Carsten Dominik writes: > On Jun 29, 2010, at 10:14 AM, Stephen Eglen wrote: > >>> THe doc string now reads: >>> >>> "Use `org-icompleting-read' to prompt for an Org buffer to switch >>> to. >>> With a prefix argument, restrict available to files. >>> With two prefix arguments, restrict available buffers to agenda >>> files. >>> >>> This will either use ido or iswitchb for buffer name completion, >>> depending on the variables `org-completion-use-iswitchb' and >>> `org-completion-use-ido'. If both are nil, we will still use >>> iswitchb >>> for this special application." >> >> Hmmm... this sounds a bit confusing! why not just have >> org-completion-use-ido, and if that is non-nil, we use ido, else we >> use >> iswitchb. Unless these variables are also used in other contexts >> (which >> I doubt)? > > Oh yes, the are used in *many* contexts. Whenever Org offers > completion which would not be made worse by using one of these packages, > it will offer that special kind of completion. > >> >> how about changing the 2nd para to: >> >> This will use iswitchb for buffer name completion, unless >> `org-completion-use-ido' is non-nil, to select ido completion I would suggest changing the function name to org-switchb (alias org-iswitchb to use it) and then the documentation reads: ,---- | Switches between org buffers. Defaults to iswitchb for buffer name | completion. Set `org-completion-use-ido' to non nil to use ido | completion instead. `---- As an aside I found iswitchb to be a subset of ido and the ido fuzzy completion invaluable in refiling to various org targets.