Re: org-iswitchb documentation

[Carsten Dominik <carsten.dominik@gmail.com>]

Hi Stephen,

I think this is actually a bug.  Since the command is called ...- 
iswitchb,
I am sure the intention was to use iswitchbe.  Later, when we added ido
support as well, the function was rewritten using
org-icompleting-read, and in this way the iswitchb support was lost.


How about the following solution:

Check if either of org-completion-use-\(ido\|iswitchb\) is set.  If not,
bind org-completion-use-iswitchb around the call to org-icompleting- 
read.

- Carsten

On Jun 28, 2010, at 12:19 PM, Stephen Eglen wrote:

> Dear all,
>
> As the author of iswitchb, I was very happy to see M-x org-iswitchb
> included.  Further, it is recommended as a default keybinding in the
> manual:
>
> ----------------------------------------------------------------------
> 1.3 Activation
> ==============
>
> ...
>     (add-to-list 'auto-mode-alist '("\\.org\\'" . org-mode))
>     (global-set-key "\C-cl" 'org-store-link)
>     (global-set-key "\C-ca" 'org-agenda)
>     (global-set-key "\C-cb" 'org-iswitchb)
> ----------------------------------------------------------------------
>
> So I was surprised when trying org-iswitchb that I didn't see the
> iswitchb feedback when typing buffer names.  I eventually found that I
> needed to set either of the following variables to t so that this  
> would
> work:
>
>  org-completion-use-iswitchb, org-completion-use-ido
>
> These variables are not mentioned in the docstrings of either
> org-iswitchb or org-icompleting-read.   Here is a suggested patch to  
> the
> docstring for org-iswitchb.
>
> Thanks for all the good work, as ever!
>
> Stephen
>
> $ git diff org.el
>
> diff --git a/lisp/org.el b/lisp/org.el
> index 7bb4f45..67e0278 100644
> --- a/lisp/org.el
> +++ b/lisp/org.el
> @@ -15201,7 +15201,13 @@ changes from another.  I believe the  
> procedure must be l
> (defun org-iswitchb (&optional arg)
>   "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."
> +With two prefix arguments, restrict available buffers to agenda  
> files.
> +
> +To see feedback whilst typing the buffer name, you can use the
> +facilities of either the ido or iswitchb package.  Set either
> +`org-completion-use-iswitchb' or `org-completion-use-ido' to
> +non-nil and see documentation of those variables for further
> +details."
>   (interactive "P")
>   (let ((blist (cond ((equal arg '(4))  (org-buffer-list 'files))
>                      ((equal arg '(16)) (org-buffer-list 'agenda))
>
> _______________________________________________
> 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