From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp12.migadu.com ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms5.migadu.com with LMTPS
	id mMlaL9xmVmOjDAAAbAwnHQ
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Mon, 24 Oct 2022 12:20:12 +0200
Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp12.migadu.com with LMTPS
	id uDBCL9xmVmMHeAEAauVa8A
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Mon, 24 Oct 2022 12:20:12 +0200
Received: from lists.gnu.org (lists.gnu.org [209.51.188.17])
	(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
	(No client certificate requested)
	by aspmx1.migadu.com (Postfix) with ESMTPS id 977A22FDC
	for <larch@yhetil.org>; Mon, 24 Oct 2022 12:20:12 +0200 (CEST)
Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces@gnu.org>)
	id 1omtQl-0007ea-6d; Mon, 24 Oct 2022 05:07:35 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@posteo.net>)
 id 1omtQj-0007d9-9y
 for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 05:07:33 -0400
Received: from mout02.posteo.de ([185.67.36.66])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@posteo.net>)
 id 1omtQh-0006dt-2q
 for emacs-orgmode@gnu.org; Mon, 24 Oct 2022 05:07:33 -0400
Received: from submission (posteo.de [185.67.36.169]) 
 by mout02.posteo.de (Postfix) with ESMTPS id 88625240106
 for <emacs-orgmode@gnu.org>; Mon, 24 Oct 2022 11:07:28 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
 t=1666602448; bh=5h9ylyshdv9Skm6ReYa+uEjuaXbGdLwAlypX6/bltBA=;
 h=From:To:Cc:Subject:Date:From;
 b=oRtn8G96ekBSSh6efaBzdx1BaYmwIYGu5Ojin5T9G5oY/vRde/B+rUjQd+dIrhDn5
 +Y2y2OSFUGRNFnoMBcnRjU5sh0P9VhlqB3k7VBlKtpPq34uD9iAkHoohgLzYzCPAT1
 o3rYW1FeE2UfQ5t44XP7UwicNq2Mnk45BX49GK/fyaCKFgofIBkwlJRsGY+vVBzMW3
 o+cxzIEQaG4LbqScTCjQp2deIVnRcPxheuZioihTBsPwV2LFanM98u2RWxX8MLpSNG
 RcgBQ5hKaD+owdqMfNpX77wxJ74nfXq+qmRImfIqk9UCWga4/F3bxaABUvxa6HZ5Vd
 P+gJ21zZoKp6Q==
Received: from customer (localhost [127.0.0.1])
 by submission (posteo.de) with ESMTPSA id 4Mwq331rtsz6tnQ;
 Mon, 24 Oct 2022 11:07:26 +0200 (CEST)
From: Ihor Radchenko <yantar92@posteo.net>
To: Uwe Brauer <oub@mat.ucm.es>
Cc: emacs-orgmode@gnu.org
Subject: [BUG] Undocumented convention for org-time-stamp-custom-formats to
 be "<...>" (was: time-stamp in DONE tag is not really displayed)
In-Reply-To: <87zgdms2lq.fsf@mat.ucm.es>
References: <87zgdms2lq.fsf@mat.ucm.es>
Date: Mon, 24 Oct 2022 09:07:58 +0000
Message-ID: <87k04ppp1t.fsf@localhost>
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@posteo.net;
 helo=mout02.posteo.de
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-BeenThere: emacs-orgmode@gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Sender: "Emacs-orgmode" <emacs-orgmode-bounces@gnu.org>
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
X-Migadu-Flow: FLOW_IN
X-Migadu-Country: US
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1666606812;
	h=from:from:sender:sender:reply-to:subject:subject:date:date:
	 message-id:message-id:to:to:cc:cc:mime-version:mime-version:
	 content-type:content-type:in-reply-to:in-reply-to:
	 references:references:list-id:list-help:list-unsubscribe:
	 list-subscribe:list-post:dkim-signature;
	bh=KR4paj0+YH4A69BJxthunP0ec4F4ImLnlIXy7ZSEV/U=;
	b=eHHD2Eo3dk8hyfKXQrwfehD7PUgAgiE53j7bmrbPptX0OecXu3lgaErg13NqxfMScNDbEg
	wHADXxU2CzX2cd5tGfKq2ale/8Ef3TpIl//eH6luR1pG4+F5GdkFX84ktHvgMQInj+UJXY
	P8Q/EzZwmfR6OCTSl8kU8rvYh3slEWDwQQ8VV/dqFfjUpaV471BnxI2WbS1t2A3eqB/qu1
	qeD05+hpFdpVtXFcuLwOZ9Jlk5uWnjKZ1H70o8inXdV2RrcvwlsQztaICQyN2F+li5H6aX
	rYhoL3MgN/Wa9w6mzDSZIQkSB5rpA4OoQB8UwIqlHxUbmE0Ev7toTLid4O/DLQ==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1666606812; a=rsa-sha256; cv=none;
	b=qzAG9ipHKGzcyQp6/ZQ1OwWzRbpwcnHkCH2sjRvn6w/4/xCmMz6/OEbvroJ/JG6ww44Sa1
	W8c0z3cM1Q8mdywrmU3Bw7WMhz+sYokkb7yV/gyoVl7AXaohuiV+4Di0INfrPCDa0mlPZE
	4JTlMybm2CwYV4DQi5nYGVa3dkJTb64clKFbRK2V3nY8YZPv7hlq+b+MzaJGun5/fagIEw
	c/gqa15FKS0MGVOsOIzFLRHdaGjr3gOMwTJ9LdhqESKPRxtLE7FCR7vsaizCk4wHFLxNNi
	NfI9urR6LuX4ZT5XMkLTH/O+u0/skCO+s8VX5cieATvphe/fZm8QyOh4kHR+Pw==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=oRtn8G96;
	dmarc=pass (policy=none) header.from=posteo.net;
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"
X-Migadu-Spam-Score: -3.60
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=oRtn8G96;
	dmarc=pass (policy=none) header.from=posteo.net;
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"
X-Migadu-Queue-Id: 977A22FDC
X-Spam-Score: -3.60
X-Migadu-Scanner: scn0.migadu.com
X-TUID: qSCISMeGEXSD

Uwe Brauer <oub@mat.ucm.es> writes:

> My time-stamps are of the form <2022-10-23 Sun>
> I have an entry like this 
>
> - State "DONE"       from "WAIT"       [2022-10-23 21:06] \\
>
>
>
> However it is displayed when I use org-toggle-time-stamp-overlays  as
>  [23.10.%]
>
> Neither the year not the time is displayed, why!
>  
> I have set 
> org-time-stamp-custom-formats 
> to 
> (" %d.%m.%Y " . " %d.%m.%Y")
>
> I am puzzled, any ideas?

Confirmed.

This is because Org expects the first and the last characters in
org-time-stamp-custom-formats to be opening/closing brackets.
(undocumented)

Why?
Because org-time-stamp-formats does so.

Why does org-time-stamp-formats does so?
No idea.
This code dates back to initial Org commits.

I think it would make sense to change it.
However, if we change special treatment of the first/last characters in
org-time-stamp-custom-formats, it will also make sense to change
org-time-stamp-formats constant.

For backwards compatibility, we will need to keep special treatment to
strip brackets around the formats, if present.

I propose to do the following:
1. org-time-stamp-formats and org-time-stamp-custom-formats will be
   treated as is, unless they contain "<" and ">" and the first and the
   last char.
2. If the formats do contain <...>, strip the "<" and ">".
3. Document (2) in the docstrings.

Any objections?

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