From mboxrd@z Thu Jan 1 00:00:00 1970 From: Dave Abrahams 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 Message-ID: References: <30476.1317256407@alphaville.dokosmarshall.org> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([140.186.70.92]:50018) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R964Y-00009k-Bc for emacs-orgmode@gnu.org; Wed, 28 Sep 2011 22:10:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1R964W-0003an-PJ for emacs-orgmode@gnu.org; Wed, 28 Sep 2011 22:10:02 -0400 Received: from mail-vw0-f41.google.com ([209.85.212.41]:47954) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1R964W-0003ag-Mr for emacs-orgmode@gnu.org; Wed, 28 Sep 2011 22:10:00 -0400 Received: by vws16 with SMTP id 16so113031vws.0 for ; Wed, 28 Sep 2011 19:09:59 -0700 (PDT) In-Reply-To: <30476.1317256407@alphaville.dokosmarshall.org> (Nick Dokos's message of "Wed, 28 Sep 2011 20:33:27 -0400") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: nicholas.dokos@hp.com Cc: emacs-orgmode@gnu.org on Wed Sep 28 2011, Nick Dokos wrote: > Dave Abrahams 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