]> git.eshelyaron.com Git - emacs.git/commit
Document encode-time caveats
authorPaul Eggert <eggert@cs.ucla.edu>
Sun, 17 Apr 2022 01:48:51 +0000 (18:48 -0700)
committerPaul Eggert <eggert@cs.ucla.edu>
Sun, 17 Apr 2022 01:54:31 +0000 (18:54 -0700)
commitf1ba92448d1e573640547c68d9bed89fe5c43da0
tree78f126665a9b1a72206198f8b1af65ff14f59538
parent15a5cf9a9aa7798ee12ae96b8b6b4efe1562b57e
Document encode-time caveats

* doc/lispref/os.texi (Time of Day, Time Conversion):
Move the warnings about DST being -1 to closer to where DST is
discussed, and reword and improve the discussions and warnings.
Be more precise about years before 1969 (possible west of UTC) vs the
Epoch.  Mention some problems due to leap seconds, leap years,
daylight saving transitions, and time zone changes.  Modernize
discussion of OS timestamp range.  Prefer secular ‘BCE’ to religious
‘BC’.  Omit discussion of decoded-time-add and make-decoded-time, as
they are in a library and are not always available; instead, mention
the library.  Warn about common mistakes when doing simple date
arithmetic.
* src/timefns.c (Fencode_time): In doc string, mention date
arithmetic and tighten up the wording a bit.
doc/lispref/os.texi
src/timefns.c