From mboxrd@z Thu Jan 1 00:00:00 1970 From: Stephen Eglen Subject: org-iswitchb documentation Date: Mon, 28 Jun 2010 11:19:50 +0100 Message-ID: <20386.1277720390@maps> Return-path: Received: from [140.186.70.92] (port=38946 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OTBRS-0002K0-0m for emacs-orgmode@gnu.org; Mon, 28 Jun 2010 06:19:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OTBRQ-0008UC-WF for emacs-orgmode@gnu.org; Mon, 28 Jun 2010 06:19:53 -0400 Received: from ppsw-31.csi.cam.ac.uk ([131.111.8.131]:45603) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OTBRQ-0008Ty-RO for emacs-orgmode@gnu.org; Mon, 28 Jun 2010 06:19:52 -0400 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: emacs-orgmode@gnu.org Cc: Stephen Eglen 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))