From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Fri, 25 Mar 2016 15:32:39 +0000 (+0100)
Subject: parse-times-string doc string clarification
X-Git-Tag: emacs-26.0.90~2288
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=b2e629c0d043720fe9f043e59d583eb7068dfb11;p=emacs.git

parse-times-string doc string clarification

* lisp/calendar/parse-time.el (parse-time-string): Note that
we accept RFC2822 strings.
---

diff --git a/lisp/calendar/parse-time.el b/lisp/calendar/parse-time.el
index c17d04a8c10..b62f9fa7941 100644
--- a/lisp/calendar/parse-time.el
+++ b/lisp/calendar/parse-time.el
@@ -146,8 +146,12 @@ letters, digits, plus or minus signs or colons."
 ;;;###autoload
 (defun parse-time-string (string)
   "Parse the time-string STRING into (SEC MIN HOUR DAY MON YEAR DOW DST TZ).
-The values are identical to those of `decode-time', but any values that are
-unknown are returned as nil."
+STRING should be on something resembling an RFC2822 string, a la
+\"Fri, 25 Mar 2016 16:24:56 +0100\", but this function is
+somewhat liberal in what format it accepts, and will attempt to
+return a \"likely\" value even for somewhat malformed strings.
+The values returned are identical to those of `decode-time', but
+any values that are unknown are returned as nil."
   (let ((time (list nil nil nil nil nil nil nil nil nil))
 	(temp (parse-time-tokenize (downcase string))))
     (while temp