emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Richard Riley <rileyrg@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: org-iswitchb documentation
Date: Tue, 29 Jun 2010 11:44:55 +0200	[thread overview]
Message-ID: <i0cfan$43g$1@dough.gmane.org> (raw)
In-Reply-To: F201167E-8258-40ED-AEA7-E5C61DA1851D@gmail.com

Carsten Dominik <carsten.dominik@gmail.com> 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.

  reply	other threads:[~2010-06-29  9:45 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-06-28 10:19 org-iswitchb documentation Stephen Eglen
2010-06-28 12:09 ` Livin Stephen Sharma
2010-06-28 12:22 ` Carsten Dominik
2010-06-28 12:26   ` Stephen Eglen
2010-06-29  7:26     ` Carsten Dominik
2010-06-29  8:14       ` Stephen Eglen
2010-06-29  8:43         ` Carsten Dominik
2010-06-29  9:44           ` Richard Riley [this message]
2010-06-29  9:51             ` Carsten Dominik
2010-07-02  7:14             ` Carsten Dominik
2010-06-29 22:46       ` Eric S Fraga
2010-06-28 13:00   ` Stephen Eglen
2010-06-28 15:14     ` Kim F. Storm

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='i0cfan$43g$1@dough.gmane.org' \
    --to=rileyrg@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).