From: Eli Zaretskii Date: Sat, 21 Dec 2024 11:00:05 +0000 (+0200) Subject: ; Improve commentary in calendar.el X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7b9ec1b28f7c2cda34a5c096b54987db821d97c0;p=emacs.git ; Improve commentary in calendar.el * lisp/calendar/calendar.el: Expand the commentary. Suggested by Richard Lawrence . (Bug#74965) (cherry picked from commit 6902673b5b9c641fd2df3881533d6fc343124371) --- diff --git a/lisp/calendar/calendar.el b/lisp/calendar/calendar.el index 63a8504a855..e1e87726e77 100644 --- a/lisp/calendar/calendar.el +++ b/lisp/calendar/calendar.el @@ -96,10 +96,13 @@ ;; list of integers (MONTH DAY YEAR) -- see the functions ;; `calendar-extract-year', `calendar-extract-month', and ;; `calendar-extract-day'. 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' in cal-iso.el). +;; which is an integer number of days since December 31, 1BC on the +;; Gregorian calendar (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' in +;; cal-iso.el). This representation is also useful for certain +;; calculations; e.g. `calendar-day-of-week' is simply the absolute +;; represention modulo 7, because December 31, 1BC is a Sunday. ;; A note on free variables: