dotime property on non-dated item

dotime property on non-dated item

[Florian Lindner]

Hello,

Given a simple org file:

* TODO dated item
SCHEDULED: <2024-07-04 Do 14:00>
* TODO undated item

which is in org-agenda-files. Using "org-agenda t" and executing "C-x 
C-x =" (what-cursor-position) yields "dotime t" for both entries.

I have found no documentation on the "dotime" property, my understanding 
is that the "undated item" should have this property set to nil.

Some background:

org-super-agenda uses this property to determine if items are to appear 
on the time grid, when using the time-grid property, see that discussion 
https://github.com/alphapapa/org-super-agenda/issues/264

What is the definition of the dotime property?
Is there maybe another property or way to determine if entries should 
appear on the time time grid?

Versions are:

Org mode version 9.7.6 (9.7.6-7a4527 @ 
/home/florian/Cloud.XGM/super-agenda/elpa/org-9.7.6/)
GNU Emacs 29.4 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.42, 
cairo version 1.18.0)

Best Thanks,
Florian

Re: dotime property on non-dated item

[Ihor Radchenko]

Florian Lindner <mailinglists@xgm.de> writes:

> * TODO dated item
> SCHEDULED: <2024-07-04 Do 14:00>
> * TODO undated item
>
> which is in org-agenda-files. Using "org-agenda t" and executing "C-x 
> C-x =" (what-cursor-position) yields "dotime t" for both entries.
>
> I have found no documentation on the "dotime" property, my understanding 
> is that the "undated item" should have this property set to nil.
>
> Some background:
>
> org-super-agenda uses this property to determine if items are to appear 
> on the time grid, when using the time-grid property, see that discussion 
> https://github.com/alphapapa/org-super-agenda/issues/264
>
> What is the definition of the dotime property?
> Is there maybe another property or way to determine if entries should 
> appear on the time time grid?

DOTIME is an internal property storing arguments to
`org-ageda-format-item'.

Use 'time-of-day instead.

-- 
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>

Re: dotime property on non-dated item

[Florian Lindner]

Am 14.07.24 um 11:46 schrieb Ihor Radchenko:
> Florian Lindner <mailinglists@xgm.de> writes:
>
>> * TODO dated item
>> SCHEDULED: <2024-07-04 Do 14:00>
>> * TODO undated item
>>
>> which is in org-agenda-files. Using "org-agenda t" and executing "C-x
>> C-x =" (what-cursor-position) yields "dotime t" for both entries.
>>
>> I have found no documentation on the "dotime" property, my understanding
>> is that the "undated item" should have this property set to nil.
>>
>> Some background:
>>
>> org-super-agenda uses this property to determine if items are to appear
>> on the time grid, when using the time-grid property, see that discussion
>> https://github.com/alphapapa/org-super-agenda/issues/264
>>
>> What is the definition of the dotime property?
>> Is there maybe another property or way to determine if entries should
>> appear on the time time grid?
> DOTIME is an internal property storing arguments to
> `org-ageda-format-item'.
>
> Use 'time-of-day instead.

Thanks for advise! However, I was unable to get something else but nil 
for time-of-day for these entries:

* TODO dated and timed item
SCHEDULED: <2024-07-14 So 14:00>
* TODO timed item
<2024-07-14 So>
* TODO undated item

  using the procedure described above.

Best,
Florian

Re: dotime property on non-dated item

[Ihor Radchenko]

Florian Lindner <mailinglists@xgm.de> writes:

>> Use 'time-of-day instead.
>
> Thanks for advise! However, I was unable to get something else but nil 
> for time-of-day for these entries:
>
> * TODO dated and timed item
> SCHEDULED: <2024-07-14 So 14:00>

This item will have 'time-of-day property.

> * TODO timed item
> <2024-07-14 So>
> * TODO undated item

These two will not, because they do not specify time.

>   using the procedure described above.

Also, try M-x describe-text-properties

-- 
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>