summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNick Dokos <nicholas.dokos@hp.com>2011-09-29 08:59:14 +0000
committerCarsten Dominik <carsten.dominik@gmail.com>2011-10-06 10:13:05 +0200
commit1d65423da8317ff24785e3edc9984ccfd68a7745 (patch)
tree64c36c7579925ccd395d52a09ef7c1de1fd11ca9
parentc18896841ef91216ca37e4fa8071752ba2a0eeb8 (diff)
downloadorg-mode-1d65423da8317ff24785e3edc9984ccfd68a7745.tar.gz
Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]
Dave Abrahams <dave@boostpro.com> 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 <nick@dokosmarshall.org> 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
-rw-r--r--lisp/org.el6
1 files changed, 5 insertions, 1 deletions
diff --git a/lisp/org.el b/lisp/org.el
index 7e6735e..28e2c9c 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -1864,7 +1864,7 @@ will temporarily be changed to `time'."
(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 @@ This is list of cons cells. Each cell contains:
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.