* lisp/calendar/time-date.el: Add comment.

(cherry picked from commit 2533a60e4256336eb30786a555a8922326c49a8a)

diff --git a/lisp/calendar/time-date.el b/lisp/calendar/time-date.el
index eca80f1e8b6dcf4bd47a7cfaaf643dfbcf970157..b441974b943840b47fc3487766d03c2d21821d26 100644 (file)
--- a/lisp/calendar/time-date.el
+++ b/lisp/calendar/time-date.el
@@ -154,6 +154,11 @@ it is assumed that PICO was omitted and should be treated as zero."
 DATE should be in one of the forms recognized by `parse-time-string'.
 If DATE lacks timezone information, GMT is assumed."
   (condition-case err
+      ;; Parse DATE. If it contains a year, use defaults for other components.
+      ;; Then encode the result; this signals an error if the year is missing,
+      ;; because encode-time signals if crucial time components are nil.
+      ;; This heuristic uses local time if the string lacks time zone info,
+      ;; because encode-time treats a nil time zone as local time.
       (let ((parsed (parse-time-string date)))
        (when (decoded-time-year parsed)
          (decoded-time-set-defaults parsed))