From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dave Abrahams Subject: Re: Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)] Date: Thu, 29 Sep 2011 07:36:28 -0400 Message-ID: References: <30476.1317256407@alphaville.dokosmarshall.org> <3103.1317268754@alphaville.dokosmarshall.org> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([140.186.70.92]:51044) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R9Euq-0002sP-09 for emacs-orgmode@gnu.org; Thu, 29 Sep 2011 07:36:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1R9Eul-0007WS-Fo for emacs-orgmode@gnu.org; Thu, 29 Sep 2011 07:36:35 -0400 Received: from mail-vw0-f41.google.com ([209.85.212.41]:38023) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R9Eul-0007V0-Bo for emacs-orgmode@gnu.org; Thu, 29 Sep 2011 07:36:31 -0400 Received: by mail-vw0-f41.google.com with SMTP id 16so426873vws.0 for ; Thu, 29 Sep 2011 04:36:30 -0700 (PDT) In-Reply-To: <3103.1317268754@alphaville.dokosmarshall.org> (Nick Dokos's message of "Wed, 28 Sep 2011 23:59:14 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: nicholas.dokos@hp.com Cc: emacs-orgmode@gnu.org Beautiful on Wed Sep 28 2011, Nick Dokos wrote: > Dave Abrahams wrote: > >> I would change the doc for org-refile-targets to say that the resulting >> list of targets is the union of all the targets matched by each cons >> cell. I think you could take that pretty much verbatim. >> > > How's this? > > Nick > > --------------------------------------------------------------------------- > From f853b04fb474493b3b7b8857794c9f120c5f7822 Mon Sep 17 00:00:00 2001 > From: Nick Dokos > Date: Wed, 28 Sep 2011 23:49:13 -0400 > Subject: [PATCH] Amplify the doc for org-refile-targets > > * lisp/org.el: (org-refile-targets) Elaborated the documentation of > the variable as suggested by Dave Abrahams. > > TINYCHANGE > --- > lisp/org.el | 6 +++++- > 1 files changed, 5 insertions(+), 1 deletions(-) > > diff --git a/lisp/org.el b/lisp/org.el > index 945d759..68c6912 100644 > --- a/lisp/org.el > +++ b/lisp/org.el > @@ -1864,7 +1864,7 @@ (defcustom org-log-refile nil > > (defcustom org-refile-targets nil > "Targets for refiling entries with \\[org-refile]. > -This is list of cons cells. Each cell contains: > +This is a list of cons cells. Each cell contains: > - a specification of the files to be considered, either a list of files, > or a symbol whose function or variable value will be used to retrieve > a file name or a list of file names. If you use `org-agenda-files' for > @@ -1886,6 +1886,10 @@ (defcustom org-refile-targets nil > Note that, when `org-odd-levels-only' is set, level corresponds to > order in hierarchy, not to the number of stars. > > +Each element of this list generates a set of possible targets. > +The union of these sets is presented (with completion) to > +the user by `org-refile'. > + > You can set the variable `org-refile-target-verify-function' to a function > to verify each headline found by the simple criteria above. -- Dave Abrahams BoostPro Computing http://www.boostpro.com