encoding/json/v2: rename `inline` tag option as `embed`

The `inline` tag option is already used in existing Go code
for purposes outside of what the "encoding/json" has provided.
Adding support for it now unfortunately changes the semantics,
which may existing code.

Instead of the `inline` tag option, rename it as `embed`.
This better matches the Go language feature of embedding,
for which this is a logical extension of the same concept.

Analyis of the Go module proxies shows that
there are zero usages of `embed` within `json` tags.
In contrast there are ~649k occurences (0.5%) of the `inline` tag
out of a total of ~119M `json` field tags.

Existing code can migrate by adding both `inline` and `embed`,
then update to the latest version of the v2 module,
and then later remove the use of `inline`.

Fixes #79985

Change-Id: Ia695ce5197cdb9482aa55ceaa7f4430d93adb0f4
Reviewed-on: https://go-review.googlesource.com/c/go/+/791440
Reviewed-by: Michael Pratt <mpratt@google.com>
Reviewed-by: Chris Hines <chris.cs.guy@gmail.com>
Reviewed-by: Johan Brandhorst-Satzkorn <johan.brandhorst@gmail.com>
LUCI-TryBot-Result: golang-scoped@luci-project-accounts.iam.gserviceaccount.com <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
Reviewed-by: Damien Neil <dneil@google.com>
10 files changed
tree: 6420248d9ac7852bbca8701ec8d517d5d15d8eb7
  1. .github/
  2. api/
  3. doc/
  4. lib/
  5. misc/
  6. src/
  7. test/
  8. .gitattributes
  9. .gitignore
  10. codereview.cfg
  11. CONTRIBUTING.md
  12. go.env
  13. LICENSE
  14. PATENTS
  15. README.md
  16. SECURITY.md
README.md

The Go Programming Language

Go is an open source programming language that makes it easy to build simple, reliable, and efficient software.

Gopher image Gopher image by Renee French, licensed under Creative Commons 4.0 Attribution license.

Our canonical Git repository is located at https://go.googlesource.com/go. There is a mirror of the repository at https://github.com/golang/go.

Unless otherwise noted, the Go source files are distributed under the BSD-style license found in the LICENSE file.

Download and Install

Binary Distributions

Official binary distributions are available at https://go.dev/dl/.

After downloading a binary release, visit https://go.dev/doc/install for installation instructions.

Install From Source

If a binary distribution is not available for your combination of operating system and architecture, visit https://go.dev/doc/install/source for source installation instructions.

Contributing

Go is the work of thousands of contributors. We appreciate your help!

To contribute, please read the contribution guidelines at https://go.dev/doc/contribute.

Note that the Go project uses the issue tracker for bug reports and proposals only. See https://go.dev/wiki/Questions for a list of places to ask questions about the Go language.