org-iswitchb documentation

[Stephen Eglen <S.J.Eglen@damtp.cam.ac.uk>]

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))