Commit f3eece74 authored by Andrew Gerrand's avatar Andrew Gerrand

doc: use "keyed" instead of "tagged" in Go 1 compatibility doc

LGTM=bradfitz, r
R=r, bradfitz
CC=golang-codereviews
https://golang.org/cl/156730043
parent fdc047fb
...@@ -83,16 +83,16 @@ break if the bug is fixed. We reserve the right to fix such bugs. ...@@ -83,16 +83,16 @@ break if the bug is fixed. We reserve the right to fix such bugs.
<li> <li>
Struct literals. For the addition of features in later point Struct literals. For the addition of features in later point
releases, it may be necessary to add fields to exported structs in releases, it may be necessary to add fields to exported structs in
the API. Code that uses untagged struct literals (such as pkg.T{3, the API. Code that uses unkeyed struct literals (such as pkg.T{3,
"x"}) to create values of these types would fail to compile after "x"}) to create values of these types would fail to compile after
such a change. However, code that uses tagged literals (pkg.T{A: such a change. However, code that uses keyed literals (pkg.T{A:
3, B: "x"}) will continue to compile after such a change. We will 3, B: "x"}) will continue to compile after such a change. We will
update such data structures in a way that allows tagged struct update such data structures in a way that allows keyed struct
literals to remain compatible, although untagged literals may fail literals to remain compatible, although unkeyed literals may fail
to compile. (There are also more intricate cases involving nested to compile. (There are also more intricate cases involving nested
data structures or interfaces, but they have the same resolution.) data structures or interfaces, but they have the same resolution.)
We therefore recommend that composite literals whose type is defined We therefore recommend that composite literals whose type is defined
in a separate package should use the tagged notation. in a separate package should use the keyed notation.
</li> </li>
<li> <li>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment