emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Dave Abrahams <dave@boostpro.com>
To: nicholas.dokos@hp.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)]
Date: Wed, 28 Sep 2011 22:09:57 -0400	[thread overview]
Message-ID: <m24nzwdrpm.fsf@pluto.luannocracy.com> (raw)
In-Reply-To: <30476.1317256407@alphaville.dokosmarshall.org> (Nick Dokos's message of "Wed, 28 Sep 2011 20:33:27 -0400")


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

> Dave Abrahams <dave@boostpro.com> wrote:
>
>> 
>> 
>> Remember to cover the basics, that is, what you expected to happen and
>> what in fact did happen.  You don't know how to make a good report?  See
>> 
>>      http://orgmode.org/manual/Feedback.html#Feedback
>> 
>> Your bug report will be posted to the Org-mode mailing list.
>> ------------------------------------------------------------------------
>> 
>> The documentation doesn't specify whether the cons cells are ANDed or
>> ORed together when selecting refile targets.
>> 
>
> I'm not really sure what you mean, so let me tell you how I understand
> this variable and then come back to the question of what you would like
> to see.
>
> AFAIK, the variable is used to construct a set of possible targets: you
> select the items to refile and then you select *one* item from this
> set. There is completion: as you type, the set is cut down to whatever
> subset matches your current input - org does not let you finish until
> the refiling target has been specified uniquely.
>
> Each element of the org-refile-targets list generates a set of posssible
> targets. The whole set is the union of these partial sets. Since ORs map
> to unions and ANDs to intersections, I guess one could say that they are
> ORed together, but personally I find it confusing to think of it in
> these terms.

Then think of it / describe it in terms of set unions.  ORing predicates
creates a set union.

> Assuming that this is correct, does it help? 

Yes.

> And if it is correct and it does help, what would you change in the
> docs to incorporate this information? And how?

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.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com

  reply	other threads:[~2011-09-29  2:10 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 [this message]
2011-09-29  3:59     ` Nick Dokos
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=m24nzwdrpm.fsf@pluto.luannocracy.com \
    --to=dave@boostpro.com \
    --cc=emacs-orgmode@gnu.org \
    --cc=nicholas.dokos@hp.com \
    --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).