Document of org-map-entries

Document of org-map-entries

[York Zhao]

[-- Attachment #1: Type: text/plain, Size: 216 bytes --]

Hi list,

I wanted to know how to use the MATCH parameter in `org-map-entries'. I've
searched extensively, but was unable to find much useful information. Can
somebody please shed some lights on this?

Thanks,

York

[-- Attachment #2: Type: text/html, Size: 305 bytes --]

Re: Document of org-map-entries

[Nick Dokos]

York Zhao <gtdplatform@gmail.com> writes:


> I wanted to know how to use the MATCH parameter in
> `org-map-entries'. I've searched extensively, but was unable to find
> much useful information. Can somebody please shed some lights on
> this?
>

See

   (info "(org) Using the mapping API")

and

   (info "(org) Matching tags and properties")

-- 
Nick

Re: Document of org-map-entries

[York Zhao]

[-- Attachment #1: Type: text/plain, Size: 705 bytes --]

Thank you very much Nick.

(info "(org) Using the mapping API") was the first doc I read which has
very little information on how to use the "match" parameter.  (info "(org)
Matching tags and properties") does have a lot more detail though.


On Thu, Oct 13, 2016 at 12:46 AM, Nick Dokos <ndokos@gmail.com> wrote:

> York Zhao <gtdplatform@gmail.com> writes:
>
>
> > I wanted to know how to use the MATCH parameter in
> > `org-map-entries'. I've searched extensively, but was unable to find
> > much useful information. Can somebody please shed some lights on
> > this?
> >
>
> See
>
>    (info "(org) Using the mapping API")
>
> and
>
>    (info "(org) Matching tags and properties")
>
> --
> Nick
>
>
>

[-- Attachment #2: Type: text/html, Size: 1285 bytes --]

Re: Document of org-map-entries

[York Zhao]

[-- Attachment #1: Type: text/plain, Size: 1019 bytes --]

One more question: how do I map only the entries that has a specific
property
defined? The following code didn't work.

(org-map-entries
     (lambda () (...))
     "mytag+myproperty<>nil")

Thanks,


On Thu, Oct 13, 2016 at 1:00 AM, York Zhao <gtdplatform@gmail.com> wrote:

> Thank you very much Nick.
>
> (info "(org) Using the mapping API") was the first doc I read which has
> very little information on how to use the "match" parameter.  (info "(org)
> Matching tags and properties") does have a lot more detail though.
>
>
> On Thu, Oct 13, 2016 at 12:46 AM, Nick Dokos <ndokos@gmail.com> wrote:
>
>> York Zhao <gtdplatform@gmail.com> writes:
>>
>>
>> > I wanted to know how to use the MATCH parameter in
>> > `org-map-entries'. I've searched extensively, but was unable to find
>> > much useful information. Can somebody please shed some lights on
>> > this?
>> >
>>
>> See
>>
>>    (info "(org) Using the mapping API")
>>
>> and
>>
>>    (info "(org) Matching tags and properties")
>>
>> --
>> Nick
>>
>>
>>
>

[-- Attachment #2: Type: text/html, Size: 2011 bytes --]

Re: Document of org-map-entries

[John Kitchin]

Try this instead:

#+BEGIN_SRC emacs-lisp
(org-map-entries (lambda () (org-heading-components)) "myproperty<>\"\"")
#+END_SRC

Empty properties get returned as "" not nil I think.

York Zhao writes:

> One more question: how do I map only the entries that has a specific
> property
> defined? The following code didn't work.
>
> (org-map-entries
>      (lambda () (...))
>      "mytag+myproperty<>nil")
>
> Thanks,
>
>
> On Thu, Oct 13, 2016 at 1:00 AM, York Zhao <gtdplatform@gmail.com> wrote:
>
>> Thank you very much Nick.
>>
>> (info "(org) Using the mapping API") was the first doc I read which has
>> very little information on how to use the "match" parameter.  (info "(org)
>> Matching tags and properties") does have a lot more detail though.
>>
>>
>> On Thu, Oct 13, 2016 at 12:46 AM, Nick Dokos <ndokos@gmail.com> wrote:
>>
>>> York Zhao <gtdplatform@gmail.com> writes:
>>>
>>>
>>> > I wanted to know how to use the MATCH parameter in
>>> > `org-map-entries'. I've searched extensively, but was unable to find
>>> > much useful information. Can somebody please shed some lights on
>>> > this?
>>> >
>>>
>>> See
>>>
>>>    (info "(org) Using the mapping API")
>>>
>>> and
>>>
>>>    (info "(org) Matching tags and properties")
>>>
>>> --
>>> Nick
>>>
>>>
>>>
>>


-- 
Professor John Kitchin
Doherty Hall A207F
Department of Chemical Engineering
Carnegie Mellon University
Pittsburgh, PA 15213
412-268-7803
@johnkitchin
http://kitchingroup.cheme.cmu.edu

Re: Document of org-map-entries

[Nick Dokos]

York Zhao <gtdplatform@gmail.com> writes:

> Thank you very much Nick.
>
> (info "(org) Using the mapping API") was the first doc I read which has very little information on how
> to use the "match" parameter.  (info "(org) Matching tags and properties") does have a lot more detail
> though.
>

Understood - I like to give more complete information for two reasons:

1) I don't know what you have seen already, so maybe I can save an
   exchange or two on the list by being more complete - and if you
   have seen it already, no harm done.

2) Perhaps I'm fooling myself, but I like to think that somebody down
   the line is going to have the same question, and if gmane ever
   comes back :-), they might be able to search the list and find the
   information that they need without having to send an email to the
   list (or even if they do, somebody might be around who remembers
   and can do the search and reply with "See this message").

So no disparagement/offense meant at all, that is just my modus operandi.
   
Regards,
-- 
Nick

Re: Document of org-map-entries

[York Zhao]

[-- Attachment #1: Type: text/plain, Size: 1625 bytes --]

@Nick:

Thanks for the explanation, it's very kind of you!

@John:

You are right, this actually works. However, this will also exclude the
trees
whose property value is empty, for example, the following tree will be
excluded,
which will not be excluded if "myproperty<>nil" syntax works:

* Tree
:PROPERTIES:
:myproperty:
:END:

But there's probably no point to have such empty property after all. So you
approach is acceptable. Thanks!

Regards,

York


On Thu, Oct 13, 2016 at 11:57 AM, Nick Dokos <ndokos@gmail.com> wrote:

> York Zhao <gtdplatform@gmail.com> writes:
>
> > Thank you very much Nick.
> >
> > (info "(org) Using the mapping API") was the first doc I read which has
> very little information on how
> > to use the "match" parameter.  (info "(org) Matching tags and
> properties") does have a lot more detail
> > though.
> >
>
> Understood - I like to give more complete information for two reasons:
>
> 1) I don't know what you have seen already, so maybe I can save an
>    exchange or two on the list by being more complete - and if you
>    have seen it already, no harm done.
>
> 2) Perhaps I'm fooling myself, but I like to think that somebody down
>    the line is going to have the same question, and if gmane ever
>    comes back :-), they might be able to search the list and find the
>    information that they need without having to send an email to the
>    list (or even if they do, somebody might be around who remembers
>    and can do the search and reply with "See this message").
>
> So no disparagement/offense meant at all, that is just my modus operandi.
>
> Regards,
> --
> Nick
>
>
>

[-- Attachment #2: Type: text/html, Size: 2349 bytes --]