From: Ian Lance Taylor <iant@golang.org>
Date: Thu, 9 Jun 2016 04:15:26 +0000 (-0700)
Subject: time: document that RFC822/1123 don't parse all RFC formats
X-Git-Tag: go1.7beta2~32
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=894803c11e4eab128869be759463510580a68602;p=gostls13.git

time: document that RFC822/1123 don't parse all RFC formats

Fixes #14505.

Change-Id: I46196b26c9339609e6e3ef9159de38c5b50c2a1b
Reviewed-on: https://go-review.googlesource.com/23922
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Emmanuel Odeke <emm.odeke@gmail.com>
Reviewed-by: Andrew Gerrand <adg@golang.org>
---

diff --git a/src/time/format.go b/src/time/format.go
index 13c2bb6e52..c2ae793020 100644
--- a/src/time/format.go
+++ b/src/time/format.go
@@ -51,6 +51,9 @@ import "errors"
 // use of "GMT" in that case.
 // In general RFC1123Z should be used instead of RFC1123 for servers
 // that insist on that format, and RFC3339 should be preferred for new protocols.
+// RFC822, RFC822Z, RFC1123, and RFC1123Z are useful for formatting;
+// when used with time.Parse they do not accept all the time formats
+// permitted by the RFCs.
 const (
 	ANSIC       = "Mon Jan _2 15:04:05 2006"
 	UnixDate    = "Mon Jan _2 15:04:05 MST 2006"