Re: [BUG] results from org-prepare-dblock make clocktable unusable

[Ihor Radchenko <yantar92@posteo.net>]

"Mark A. Hershberger" <mah@everybody.org> writes:

> Ihor Radchenko <yantar92@posteo.net> writes:
>
>> You need to put tag into quotes.
>> I guess we may document this, but I am not sure where.
>
> I did figure this out and meant to follow up.
>
> As far as documentation, in the infodoc under "7.5.3 Capturing column
> view", we have this:
>
>     ‘:match’
>          When set to a string, use this as a tags/property match filter to
>          select only a subset of the headlines in the scope set by the ‘:id’
>          parameter.

So, we clearly say that :match should be set to a string here.
Is it confusing for you?

> And, under "8.4.2 The clock table":
>
>     ‘:match’
>          A tags match to select entries that should contribute.  See *note
>          Matching tags and properties:: for the match syntax.

I guess we may specify that the value must be a string here.
Would you be interested to write a small patch that improves the description?

> I'm looking through "11.3.3 Matching tags and properties" and the only
> reference there to double-quotes is this:
>
>    • If the comparison value is enclosed in double-quotes, a string
>      comparison is done, and the same operators are allowed.
>
> and
>
>    • If the comparison value is enclosed in double-quotes _and_ angular
>      brackets (like ‘DEADLINE<​="<2008-12-24 18:30>"’), both values are
>      assumed to be date/time specifications in the standard Org way, and
>      the comparison is done accordingly.  Valid values also include
>      ‘"<now>"’ for now (including time), ‘"<today>"’, and ‘"<tomorrow>"’
>      for these days at 0:00 hours, i.e., without a time specification.
>      You can also use strings like ‘"<+5d>"’ or ‘"<-2m>"’ with units
>      ‘d’, ‘w’, ‘m’, and ‘y’ for day, week, month, and year,
>      respectively.

This is not related. This part is talking about quoting value _inside_
the match syntax. Like :match "DEADLINE>=\"+1d\"".

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>