From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Re: org-iswitchb documentation Date: Tue, 29 Jun 2010 11:51:09 +0200 Message-ID: References: <20386.1277720390@maps> <2E246530-D91C-424E-82F1-D9BD5B18AD0B@gmail.com> <3065.1277727993@maps> <5159.1277799284@maps> Mime-Version: 1.0 (Apple Message framework v936) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from [140.186.70.92] (port=50094 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OTXTI-0007jE-1j for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:51:17 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OTXTH-0005ad-08 for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:51:15 -0400 Received: from mail-wy0-f169.google.com ([74.125.82.169]:57972) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OTXTG-0005aY-PZ for emacs-orgmode@gnu.org; Tue, 29 Jun 2010 05:51:14 -0400 Received: by wyb39 with SMTP id 39so4319137wyb.0 for ; Tue, 29 Jun 2010 02:51:13 -0700 (PDT) In-Reply-To: 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: Richard Riley Cc: emacs-orgmode@gnu.org On Jun 29, 2010, at 11:44 AM, Richard Riley wrote: > 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: This is a good proposal, but I prefer to not change the names of commands unless really necessary. Changing it will break the config of users. - Carsten > > ,---- > | 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. > > > > _______________________________________________ > Emacs-orgmode mailing list > Please use `Reply All' to send replies to the list. > Emacs-orgmode@gnu.org > http://lists.gnu.org/mailman/listinfo/emacs-orgmode - Carsten