Dates in headlines

Dates in headlines

[Ypo]

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

I think I've read somewhere that it is a "bad practice" to use dates in 
headlines, is it correct? I haven't found it in the manual.

Like:

**** <2022-06-29 mi. 10:30> Meeting

Best regards

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

Re: Dates in headlines

[Jean Louis]

On 2022-06-28 12:06, Ypo wrote:
> I think I've read somewhere that it is a "bad practice" to use dates
> in headlines, is it correct? I haven't found it in the manual.
> 
> Like:
> 
> **** <2022-06-29 mi. 10:30> Meeting
> 
> Best regards

In many of my notes I use dates in titles of the section. Note creation 
is not always equal to date to which not relates. When it is useful, use 
it.

-- 
Jean

Take action in Free Software Foundation campaigns:
https://www.fsf.org/campaigns

In support of Richard M. Stallman
https://stallmansupport.org/

Re: Dates in headlines

[Samuel Wales]

this iirc has been obsolete for many years and ime and on ml never was
an issue.  i tried to find out why it was mentioned but did not find
anything.  it might have been an ambiguity in the manual to do with
active tses like in your example?  e.g. the agenda will remove the
active ts at least in certain cases, but that is a deliberate feature.

i successfully rely on inactive as below.  they are sorted by the ts.
a capture template inserts them.

much better than date trees for my case.  always show, sorted at
bottom, no hierarchy, nothing out of sync, can scan and bisect to find
an entry or get a sense of number, can change a ts and sort again,
looks the same in the agenda, etc.


***** LOG [2021-07-01 Thu] vulcans mediating with klingons
***** LOG [2021-06-28 Mon 15:44] brawl.  scottie of course :(.
***** LOG [2021-06-28 Mon 15:44] hauled away AS garbage?
***** LOG [2021-06-28 Mon 15:44] klingons said garbage scow


On 6/28/22, Ypo <ypuntot@gmail.com> wrote:
> I think I've read somewhere that it is a "bad practice" to use dates in
> headlines, is it correct? I haven't found it in the manual.
>
> Like:
>
> **** <2022-06-29 mi. 10:30> Meeting
>
> Best regards
>


-- 
The Kafka Pandemic

A blog about science, health, human rights, and misopathy:
https://thekafkapandemic.blogspot.com

Re: Dates in headlines

[Ypo]

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

Thanks, Jean and Samuel, I will keep using them without remorse then :-)

Best regards!



El 28/06/2022 a las 23:13, Jean Louis escribió:
 > On 2022-06-28 12:06, Ypo wrote:
 >> I think I've read somewhere that it is a "bad practice" to use dates
 >> in headlines, is it correct? I haven't found it in the manual.
 >>
 >> Like:
 >>
 >> **** <2022-06-29 mi. 10:30> Meeting
 >>
 >> Best regards
 >
 > In many of my notes I use dates in titles of the section. Note 
creation is not always equal to date to which not relates. When it is 
useful, use it.

El 29/06/2022 a las 1:23, Samuel Wales escribió:
> this iirc has been obsolete for many years and ime and on ml never was
> an issue.  i tried to find out why it was mentioned but did not find
> anything.  it might have been an ambiguity in the manual to do with
> active tses like in your example?  e.g. the agenda will remove the
> active ts at least in certain cases, but that is a deliberate feature.
>
> i successfully rely on inactive as below.  they are sorted by the ts.
> a capture template inserts them.
>
> much better than date trees for my case.  always show, sorted at
> bottom, no hierarchy, nothing out of sync, can scan and bisect to find
> an entry or get a sense of number, can change a ts and sort again,
> looks the same in the agenda, etc.
>
>
> ***** LOG [2021-07-01 Thu] vulcans mediating with klingons
> ***** LOG [2021-06-28 Mon 15:44] brawl.  scottie of course :(.
> ***** LOG [2021-06-28 Mon 15:44] hauled away AS garbage?
> ***** LOG [2021-06-28 Mon 15:44] klingons said garbage scow
>
>
> On 6/28/22, Ypo<ypuntot@gmail.com>  wrote:
>> I think I've read somewhere that it is a "bad practice" to use dates in
>> headlines, is it correct? I haven't found it in the manual.
>>
>> Like:
>>
>> **** <2022-06-29 mi. 10:30> Meeting
>>
>> Best regards
>>

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

What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines]

[Alain.Cochard]

Samuel Wales writes on Tue 28 Jun 2022 16:23:

 > [inactive timestamps] much better than date trees for my case.

Reading this, I tried to find out what a date tree is.

The manual says (in 10.1.3.1):

   A date tree is an outline structure with years on the highest
   level, months or ISO weeks as sublevels and then dates on the
   lowest level.

which I don't understand.  Could I be provided with a simple example
of a date tree?

Also, in the manual, the 'Main index' has the entry:

   * date tree: Using capture.  

but, if I follow the link, I end up in 10.1.2, in a paragraph about
'M-x org-capture' and I don't see the relevance with date trees.

Regards.


-- 
EOST (École et Observatoire des Sciences de la Terre) 
ITE (Institut Terre & Environnement) | alain.cochard@unistra.fr
5 rue René Descartes   [bureau 106]  | Phone: +33 (0)3 68 85 50 44 
F-67084 Strasbourg Cedex, France     | [ slot available for rent ]

Re: What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines]

[Ihor Radchenko]

Alain.Cochard@unistra.fr writes:

> Samuel Wales writes on Tue 28 Jun 2022 16:23:
>
>  > [inactive timestamps] much better than date trees for my case.
>
> Reading this, I tried to find out what a date tree is.
>
> The manual says (in 10.1.3.1):
>
>    A date tree is an outline structure with years on the highest
>    level, months or ISO weeks as sublevels and then dates on the
>    lowest level.
>
> which I don't understand.  Could I be provided with a simple example
> of a date tree?

Indeed. Thanks for the heads-up!
Added on main.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=eece396db88e5793c994825fcb1f75d13091ee5c

> Also, in the manual, the 'Main index' has the entry:
>
>    * date tree: Using capture.  
>
> but, if I follow the link, I end up in 10.1.2, in a paragraph about
> 'M-x org-capture' and I don't see the relevance with date trees.

Fixed. Now the index entry points to Capture template elements section.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=9ef449224bc532f5cb2d0bc95cce0bb4a43c73bf

-- 
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: Dates in headlines

[Ypo]

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

I found it again:

"If the headline contains a timestamp, it is removed from the link, 
which results in a wrong link—you should avoid putting a timestamp in 
the headline."

https://orgmode.org/manual/Handling-Links.html#FOOT28



> ------------------------------------------------------------------------
> this iirc has been obsolete for many years and ime and on ml never was
> an issue.  i tried to find out why it was mentioned but did not find
> anything.  it might have been an ambiguity in the manual to do with
> active tses like in your example?  e.g. the agenda will remove the
> active ts at least in certain cases, but that is a deliberate feature.
>
> i successfully rely on inactive as below.  they are sorted by the ts.
> a capture template inserts them.
>
> much better than date trees for my case.  always show, sorted at
> bottom, no hierarchy, nothing out of sync, can scan and bisect to find
> an entry or get a sense of number, can change a ts and sort again,
> looks the same in the agenda, etc.
>
>
> ***** LOG [2021-07-01 Thu] vulcans mediating with klingons
> ***** LOG [2021-06-28 Mon 15:44] brawl.  scottie of course :(.
> ***** LOG [2021-06-28 Mon 15:44] hauled away AS garbage?
> ***** LOG [2021-06-28 Mon 15:44] klingons said garbage scow
>
>
> On 6/28/22, Ypo<ypuntot@gmail.com>  wrote:
> >/I think I've read somewhere that it is a "bad practice" to use dates in/
> >/headlines, is it correct? I haven't found it in the manual./
> >
> >/Like:/
> >
> >/**** <2022-06-29 mi. 10:30> Meeting/
> >
> >/Best regards/
> >
> *From*: 	Samuel Wales
> *Subject*: 	Re: Dates in headlines
> *Date*: 	Tue, 28 Jun 2022 16:23:02 -0700
>

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

Re: Dates in headlines

[Ihor Radchenko]

Ypo <ypuntot@gmail.com> writes:

> I found it again:
>
> "If the headline contains a timestamp, it is removed from the link, 
> which results in a wrong link—you should avoid putting a timestamp in 
> the headline."
>
> https://orgmode.org/manual/Handling-Links.html#FOOT28

Unless I miss something, this footnote is plain wrong. The timestamps
are not removed. At least not when I run M-x org-store-link on a
headline with timestamp with emacs -Q.

-- 
Ihor Radchenko,
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: Dates in headlines

[Max Nikulin]

On 19/08/2022 12:58, Ihor Radchenko wrote:
> Ypo writes:
> 
>> I found it again:
>>
>> "If the headline contains a timestamp, it is removed from the link,
>> which results in a wrong link—you should avoid putting a timestamp in
>> the headline."
>>
>> https://orgmode.org/manual/Handling-Links.html#FOOT28
> 
> Unless I miss something, this footnote is plain wrong. The timestamps
> are not removed. At least not when I run M-x org-store-link on a
> headline with timestamp with emacs -Q.

I have realized that "first wins" parsing principle (consider +a =b+ 
c*d=) may mean a problem for timestamp at the end of link text. So

     [[file:test.txt][Test [2023-01-28 Sat]]]

requires a zero-width space after the bracket closing the timestamp. The 
same is applicable to fuzzy link to headings. So either

     [[*Heading \[2023-01-28 Sat\]][Heading [2023-01-28 Sat]​]]
ZWS in between--------------------------------------------^^

or

     [[*Heading \[2023-01-28 Sat\]]]

should be used. `org-insert-link' handles it correctly, but when typing 
links from keyboard, users should be aware of such kind of pitfall. So 
timestamps in headings may be source of some inconvenience.

May it happen that in some old Org version timestamps at the end of 
headings were removed due by code intended to handle statistics cookie 
[1/10]?

Re: Dates in headlines

[Ihor Radchenko]

Max Nikulin <manikulin@gmail.com> writes:

> May it happen that in some old Org version timestamps at the end of 
> headings were removed due by code intended to handle statistics cookie 
> [1/10]?

I do not see how.

-- 
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: Dates in headlines

[Max Nikulin]

On 03/02/2023 03:37, Ihor Radchenko wrote:
> Max Nikulin writes:
> 
>> May it happen that in some old Org version timestamps at the end of
>> headings were removed due by code intended to handle statistics cookie
>> [1/10]?
> 
> I do not see how.

A patch for `org-store-link' tests reminded me about this topic. The 
footnote on dates in heading title was added in response to

Links to datestamped headings broken? Thu, 24 Feb 2011 16:49:14 +1300
https://list.orgmode.org/86pqqi9jnp.wl%25sguest@bayfield-high.school.nz/T/#u

3765304c8 2011-06-28 15:30:50 +0200 Bastien Guerry: doc/org.texi: 
footnote: don't put timestamps in headlines.

however removing of timestamps was dropped during migration to org-element:

a0be28eeb 2012-12-22 23:06:08 +0100 Bastien Guerry: org.el 
(org-make-org-heading-search-string): Rewrite using org-element.el

Cleaning up of statistics cookies, tags, comment and todo keywords were 
re-added, but timestamps are preserved since that commit.

Re: Dates in headlines

[Ihor Radchenko]

Max Nikulin <manikulin@gmail.com> writes:

> A patch for `org-store-link' tests reminded me about this topic. The 
> footnote on dates in heading title was added in response to
>
> Links to datestamped headings broken? Thu, 24 Feb 2011 16:49:14 +1300
> https://list.orgmode.org/86pqqi9jnp.wl%25sguest@bayfield-high.school.nz/T/#u
>
> 3765304c8 2011-06-28 15:30:50 +0200 Bastien Guerry: doc/org.texi: 
> footnote: don't put timestamps in headlines.
>
> however removing of timestamps was dropped during migration to org-element:

I have removed this footnote in 5adde9f3f.
Are you saying that there are still some bugs related to this topic?

-- 
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: Dates in headlines

[Max Nikulin]

On 18/07/2023 16:24, Ihor Radchenko wrote:
> Max Nikulin writes:
> 
>> The footnote on dates in heading title was added in response to
>>
>> Links to datestamped headings broken? Thu, 24 Feb 2011 16:49:14 +1300
>>
>> 3765304c8 2011-06-28 15:30:50 +0200 Bastien Guerry: doc/org.texi:
>> footnote: don't put timestamps in headlines.
>>
>> however removing of timestamps was dropped during migration to org-element:
> 
> I have removed this footnote in 5adde9f3f.
> Are you saying that there are still some bugs related to this topic?

My intention was just to explain origin of that footnote and to confirm 
that it was an obsolete one. I have no idea why timestamps were removed 
while storing links to headings in the initial Org mode commit. Perhaps, 
the change to preserve timestamps was not intentional, but since it 
happened a decade ago and nobody has complained, there is no point in 
changing current behavior.