; Improve commentary in calendar.el

* lisp/calendar/calendar.el: Expand the commentary.  Suggested by
Richard Lawrence <rwl@recursewithless.net>.  (Bug#74965)
This commit is contained in:
Eli Zaretskii 2024-12-21 13:00:05 +02:00
parent 08b62132dd
commit 6902673b5b

View file

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