Re: [O] Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

[Dave Abrahams]

Beautiful

on Wed Sep 28 2011, Nick Dokos <nicholas.dokos-AT-hp.com> wrote:

> Dave Abrahams <address@hidden> 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 <address@hidden>
> 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