From: Russ Cox <rsc@golang.org>
Date: Wed, 2 Nov 2016 21:19:42 +0000 (-0400)
Subject: time: document that only Jan and January, Mon and Monday are recognized
X-Git-Tag: go1.8beta1~347
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=3345802e8ac39e4ea6b2772ace15983f2c3be66b;p=gostls13.git

time: document that only Jan and January, Mon and Monday are recognized

Not "J", not "JAN", not "jan", etc.

Fixes #17523.

Change-Id: I16b5da97e73d88c6680c36401d30f8a195061527
Reviewed-on: https://go-review.googlesource.com/32636
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Gobot Gobot <gobot@golang.org>
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Reviewed-by: Rob Pike <r@golang.org>
---

diff --git a/src/time/format.go b/src/time/format.go
index 0ad3cf64e4..3608b04e44 100644
--- a/src/time/format.go
+++ b/src/time/format.go
@@ -42,6 +42,13 @@ import "errors"
 //	Z07:00 Z or ±hh:mm
 //	Z07    Z or ±hh
 //
+// The recognized day of week formats are "Mon" and "Monday".
+// The recognized month formats are "Jan" and "January".
+//
+// Text in the format string that is not recognized as part of the reference
+// time is echoed verbatim during Format and expected to appear verbatim
+// in the input to Parse.
+//
 // The executable example for time.Format demonstrates the working
 // of the layout string in detail and is a good reference.
 //