aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Griesemer <gri@golang.org>2016-04-22 16:35:29 -0700
committerRobert Griesemer <gri@golang.org>2016-04-25 19:21:40 +0000
commit0436a89a2c5afad41356dc1dff7c745cd30636a7 (patch)
treebbafc3f98e744f4502bde76d8711f4b8df79c2aa
parent9dcbc43f4f299b8ea6546a464d9fdeb5839b5ae9 (diff)
downloadgo-0436a89a2c5afad41356dc1dff7c745cd30636a7.tar.xz
spec: be more explicit about equivalence of empty string and absent field tags
Note that the spec already makes that point with a comment in the very first example for struct field tags. This change is simply stating this explicitly in the actual spec prose. - gccgo and go/types already follow this rule - the current reflect package API doesn't distinguish between absent tags and empty tags (i.e., there is no discoverable difference) Fixes #15412. Change-Id: I92f9c283064137b4c8651630cee0343720717a02 Reviewed-on: https://go-review.googlesource.com/22391 Reviewed-by: Russ Cox <rsc@golang.org> Reviewed-by: Rob Pike <r@golang.org>
-rw-r--r--doc/go_spec.html6
1 files changed, 3 insertions, 3 deletions
diff --git a/doc/go_spec.html b/doc/go_spec.html
index e9f6476a89..13dae09420 100644
--- a/doc/go_spec.html
+++ b/doc/go_spec.html
@@ -1,6 +1,6 @@
<!--{
"Title": "The Go Programming Language Specification",
- "Subtitle": "Version of April 21, 2016",
+ "Subtitle": "Version of April 25, 2016",
"Path": "/ref/spec"
}-->
@@ -1043,8 +1043,8 @@ promoted methods are included in the method set of the struct as follows:
<p>
A field declaration may be followed by an optional string literal <i>tag</i>,
which becomes an attribute for all the fields in the corresponding
-field declaration. The tags are made
-visible through a <a href="/pkg/reflect/#StructTag">reflection interface</a>
+field declaration. An empty tag string is equivalent to an absent tag.
+The tags are made visible through a <a href="/pkg/reflect/#StructTag">reflection interface</a>
and take part in <a href="#Type_identity">type identity</a> for structs
but are otherwise ignored.
</p>