emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nick Dokos <nicholas.dokos@hp.com>
To: Dave Abrahams <dave@boostpro.com>
Cc: nicholas.dokos@hp.com, emacs-orgmode@gnu.org
Subject: Re: Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]
Date: Wed, 28 Sep 2011 23:59:14 -0400	[thread overview]
Message-ID: <3103.1317268754@alphaville.dokosmarshall.org> (raw)
In-Reply-To: Message from Dave Abrahams <dave@boostpro.com> of "Wed, 28 Sep 2011 22:09:57 EDT." <m24nzwdrpm.fsf@pluto.luannocracy.com>

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
---
 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.
 
-- 
1.7.5.1.169.g505a1

  reply	other threads:[~2011-09-29  3:59 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-09-28 23:43 Dave Abrahams
2011-09-29  0:33 ` Nick Dokos
2011-09-29  2:09   ` Dave Abrahams
2011-09-29  3:59     ` Nick Dokos [this message]
2011-09-29 11:36       ` Dave Abrahams
2011-10-06  8:13       ` [Accepted] " Carsten Dominik

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=3103.1317268754@alphaville.dokosmarshall.org \
    --to=nicholas.dokos@hp.com \
    --cc=dave@boostpro.com \
    --cc=emacs-orgmode@gnu.org \
    --subject='Re: Bug: org-refile-targets doesn'\''t say whether it'\''s AND or OR [7.7 (release_7.7.351.gb8b5)]' \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).