From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Re: org-iswitchb documentation Date: Fri, 2 Jul 2010 09:14:47 +0200 Message-ID: <72725E63-EC84-4178-A403-6D8F9048437C@gmail.com> 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=35214 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OUayn-0006Iy-5C for emacs-orgmode@gnu.org; Fri, 02 Jul 2010 03:48:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OUayl-0002jv-IW for emacs-orgmode@gnu.org; Fri, 02 Jul 2010 03:48:08 -0400 Received: from mail-ew0-f41.google.com ([209.85.215.41]:46725) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OUayl-0002jk-9T for emacs-orgmode@gnu.org; Fri, 02 Jul 2010 03:48:07 -0400 Received: by ewy28 with SMTP id 28so1190384ewy.0 for ; Fri, 02 Jul 2010 00:48:06 -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: > > ,---- > | Switches between org buffers. Defaults to iswitchb for buffer name > | completion. Set `org-completion-use-ido' to non nil to use ido > | completion instead. > `---- Richard, Eric, sorry for not listening earlier, you are right, and I am npw following Richard's proposal for both naming and docstring. - Carsten