emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Dates in headlines
@ 2022-06-28  9:06 Ypo
  2022-06-28 21:13 ` Jean Louis
  2022-06-28 23:23 ` Samuel Wales
  0 siblings, 2 replies; 13+ messages in thread
From: Ypo @ 2022-06-28  9:06 UTC (permalink / raw)
  To: Org-mode

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

^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2022-06-28  9:06 Dates in headlines Ypo
@ 2022-06-28 21:13 ` Jean Louis
  2022-06-28 23:23 ` Samuel Wales
  1 sibling, 0 replies; 13+ messages in thread
From: Jean Louis @ 2022-06-28 21:13 UTC (permalink / raw)
  To: Ypo; +Cc: Org-mode, Emacs-orgmode

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/


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2022-06-28  9:06 Dates in headlines Ypo
  2022-06-28 21:13 ` Jean Louis
@ 2022-06-28 23:23 ` Samuel Wales
  2022-06-29 18:11   ` Ypo
  2022-10-06 10:04   ` What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines] Alain.Cochard
  1 sibling, 2 replies; 13+ messages in thread
From: Samuel Wales @ 2022-06-28 23:23 UTC (permalink / raw)
  To: Ypo; +Cc: Org-mode

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


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2022-06-28 23:23 ` Samuel Wales
@ 2022-06-29 18:11   ` Ypo
  2022-10-06 10:04   ` What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines] Alain.Cochard
  1 sibling, 0 replies; 13+ messages in thread
From: Ypo @ 2022-06-29 18:11 UTC (permalink / raw)
  To: Samuel Wales, Jean Louis; +Cc: Org-mode

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

^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
@ 2022-08-16 17:45 Ypo
  2022-08-19  5:58 ` Ihor Radchenko
  0 siblings, 1 reply; 13+ messages in thread
From: Ypo @ 2022-08-16 17:45 UTC (permalink / raw)
  To: samologist, Org-mode

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

^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2022-08-16 17:45 Dates in headlines Ypo
@ 2022-08-19  5:58 ` Ihor Radchenko
  0 siblings, 0 replies; 13+ messages in thread
From: Ihor Radchenko @ 2022-08-19  5:58 UTC (permalink / raw)
  To: Ypo; +Cc: samologist, Org-mode

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


^ permalink raw reply	[flat|nested] 13+ messages in thread

* What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines]
  2022-06-28 23:23 ` Samuel Wales
  2022-06-29 18:11   ` Ypo
@ 2022-10-06 10:04   ` Alain.Cochard
  2022-10-07  4:05     ` Ihor Radchenko
  1 sibling, 1 reply; 13+ messages in thread
From: Alain.Cochard @ 2022-10-06 10:04 UTC (permalink / raw)
  To: Samuel Wales; +Cc: Ypo, Org-mode

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 ]



^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines]
  2022-10-06 10:04   ` What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines] Alain.Cochard
@ 2022-10-07  4:05     ` Ihor Radchenko
  0 siblings, 0 replies; 13+ messages in thread
From: Ihor Radchenko @ 2022-10-07  4:05 UTC (permalink / raw)
  To: alain.cochard; +Cc: Samuel Wales, Ypo, Org-mode

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>


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
@ 2023-01-28  8:12 Max Nikulin
  2023-02-02 20:37 ` Ihor Radchenko
  0 siblings, 1 reply; 13+ messages in thread
From: Max Nikulin @ 2023-01-28  8:12 UTC (permalink / raw)
  To: emacs-orgmode

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



^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2023-01-28  8:12 Max Nikulin
@ 2023-02-02 20:37 ` Ihor Radchenko
  2023-07-14 12:57   ` Max Nikulin
  0 siblings, 1 reply; 13+ messages in thread
From: Ihor Radchenko @ 2023-02-02 20:37 UTC (permalink / raw)
  To: Max Nikulin; +Cc: emacs-orgmode

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>


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2023-02-02 20:37 ` Ihor Radchenko
@ 2023-07-14 12:57   ` Max Nikulin
  2023-07-18  9:24     ` Ihor Radchenko
  0 siblings, 1 reply; 13+ messages in thread
From: Max Nikulin @ 2023-07-14 12:57 UTC (permalink / raw)
  To: emacs-orgmode

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.



^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2023-07-14 12:57   ` Max Nikulin
@ 2023-07-18  9:24     ` Ihor Radchenko
  2023-07-19 16:27       ` Max Nikulin
  0 siblings, 1 reply; 13+ messages in thread
From: Ihor Radchenko @ 2023-07-18  9:24 UTC (permalink / raw)
  To: Max Nikulin; +Cc: emacs-orgmode

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>


^ permalink raw reply	[flat|nested] 13+ messages in thread

* Re: Dates in headlines
  2023-07-18  9:24     ` Ihor Radchenko
@ 2023-07-19 16:27       ` Max Nikulin
  0 siblings, 0 replies; 13+ messages in thread
From: Max Nikulin @ 2023-07-19 16:27 UTC (permalink / raw)
  To: emacs-orgmode

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.




^ permalink raw reply	[flat|nested] 13+ messages in thread

end of thread, other threads:[~2023-07-19 16:28 UTC | newest]

Thread overview: 13+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-06-28  9:06 Dates in headlines Ypo
2022-06-28 21:13 ` Jean Louis
2022-06-28 23:23 ` Samuel Wales
2022-06-29 18:11   ` Ypo
2022-10-06 10:04   ` What is a "date tree"? (find manual unclear) [was: Re: Dates in headlines] Alain.Cochard
2022-10-07  4:05     ` Ihor Radchenko
  -- strict thread matches above, loose matches on Subject: below --
2022-08-16 17:45 Dates in headlines Ypo
2022-08-19  5:58 ` Ihor Radchenko
2023-01-28  8:12 Max Nikulin
2023-02-02 20:37 ` Ihor Radchenko
2023-07-14 12:57   ` Max Nikulin
2023-07-18  9:24     ` Ihor Radchenko
2023-07-19 16:27       ` Max Nikulin

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).