* org.el (org-refile): minor rewriting.

This commit is contained in:
Bastien Guerry 2011-07-17 08:16:59 +02:00
parent c59da42c4e
commit 5dec19fe5b
1 changed files with 12 additions and 11 deletions

View File

@ -10331,25 +10331,24 @@ the *old* location.")
(defvar org-capture-last-stored-marker) (defvar org-capture-last-stored-marker)
(defun org-refile (&optional goto default-buffer rfloc) (defun org-refile (&optional goto default-buffer rfloc)
"Move the entry at point to another heading. "Move the entry or entries at point to another heading.
The list of target headings is compiled using the information in The list of target headings is compiled using the information in
`org-refile-targets', which see. This list is created before each use `org-refile-targets', which see.
and will therefore always be up-to-date.
At the target location, the entry is filed as a subitem of the target heading. At the target location, the entry is filed as a subitem of the target
Depending on `org-reverse-note-order', the new subitem will either be the heading. Depending on `org-reverse-note-order', the new subitem will
first or the last subitem. either be the first or the last subitem.
If there is an active region, all entries in that region will be moved. If there is an active region, all entries in that region will be moved.
However, the region must fulfill the requirement that the first heading However, the region must fulfill the requirement that the first heading
is the first one sets the top-level of the moved text - at most siblings is the first one sets the top-level of the moved text - at most siblings
below it are allowed. below it are allowed.
With prefix arg GOTO, the command will only visit the target location, With prefix arg GOTO, the command will only visit the target location
not actually move anything. and not actually move anything.
With a double prefix arg \\[universal-argument] \\[universal-argument], \ With a double prefix arg \\[universal-argument] \\[universal-argument], \
go to the location where the last refiling go to the location where the last refiling operation has put the subtree.
operation has put the subtree.
With a prefix argument of `2', refile to the running clock. With a prefix argument of `2', refile to the running clock.
RFLOC can be a refile location obtained in a different way. RFLOC can be a refile location obtained in a different way.
@ -10358,7 +10357,9 @@ See also `org-refile-use-outline-path' and `org-completion-use-ido'.
If you are using target caching (see `org-refile-use-cache'), If you are using target caching (see `org-refile-use-cache'),
You have to clear the target cache in order to find new targets. You have to clear the target cache in order to find new targets.
This can be done with a 0 prefix: `C-0 C-c C-w'" This can be done with a 0 prefix (`C-0 C-c C-w') or a triple
prefix argument (`C-u C-u C-u C-c C-w')."
(interactive "P") (interactive "P")
(if (member goto '(0 (64))) (if (member goto '(0 (64)))
(org-refile-cache-clear) (org-refile-cache-clear)