From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Making decoded-times and calendar dates compatible? Date: Sun, 15 Dec 2024 23:14:49 -0500 Message-ID: References: <87seqy5qr8.fsf@ohm.mail-host-address-is-not-set> <8734isrign.fsf@ohm.mail-host-address-is-not-set> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="22095"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Richard Lawrence Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Dec 16 05:16:00 2024 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tN2WV-0005dG-ML for ged-emacs-devel@m.gmane-mx.org; Mon, 16 Dec 2024 05:15:59 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tN2VS-0001D8-2F; Sun, 15 Dec 2024 23:14:54 -0500 Original-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 ) id 1tN2VP-0001Co-VT for emacs-devel@gnu.org; Sun, 15 Dec 2024 23:14:51 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tN2VO-0000ZI-CU; Sun, 15 Dec 2024 23:14:50 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=lv4OIdM1MzBg3a9zGp0w3QurNrkKFJegGjmXgoNYUow=; b=Pv2KQxPLcket vMvbNjZF1BBhWgW0ikwC1dXKGJc60fHn3qmdxyTJtdm/ia1TFCXO4VWiD3GXDO6T4AHMlPoAmwqtJ MiB93ZZ6uwpk2vXtrZfXDnoNwb5ysxQ6I4IucAEOA2V1DAaUY1+8swAYMSjRUYybaT3HPSeqzxR9g HYYCQnnTmIu93exx9C9/D+p9cAoLMjpjSTrOEKSAHd79M309bvME2G9naWc/WnUFcycH4GPhIWwoc sM8FmgBh/pAidXUuSg1xKeNXgHdqQmarzCSxhwKEuOlu3nm0Xj9E8F/0uAt3Iwvxs8SNUJQJSpyVb oCl20c9WxnONWO6Prj2lDA==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1tN2VN-0004uN-9W; Sun, 15 Dec 2024 23:14:49 -0500 In-Reply-To: <8734isrign.fsf@ohm.mail-host-address-is-not-set> (message from Richard Lawrence on Thu, 12 Dec 2024 17:09:44 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:326542 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > The only documentation I'm aware of (besides the Calendar/Diary section > in the Emacs manual, which doesn't deal with the programming interface) > is in the docstrings of the library. The docstrings of the functions > calendar-extract-year > calendar-extract-month > calendar-extract-day > are where the (MONTH DAY YEAR) format is mentioned. Would someoe like to add some comments at the start of the file documenging this data structure? > This is the "standard", Gregorian format for calendar dates, but it is > not the only format that the calendar works with. Internally it also > uses an "absolute" format which is an integer number of days since > December 31, 1BC (see e.g. `calendar-absolute-from-gregorian'), and > converts between different calendar scales by converting to and from the > absolute format (see e.g. `calendar-iso-from-absolute'). It would be helpful to describe that representation too, in those comments. > Similarly, the only documentation I'm aware of for the decoded-time > format is in the docstrings of the functions `decode-time' and > `parse-time-string', and in the symbol documentation for `decoded-time', > which is declared as a cl-struct with :type list in simple.el. According > to a comment there, the point of this declaration is to provide > accessors for the various slots in the list, e.g. `decoded-time-month'. This IS described in the Emacs Lisp Reference Manual, in section Time of Day. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)