// Copyright 2018 The Go Authors. All rights reserved.

// Use of this source code is governed by a BSD-style

// license that can be found in the LICENSE file.

// Package text implements the text format for protocol buffers.

// This package has no semantic understanding for protocol buffers and is only

// a parser and composer for the format.

//

// There is no formal specification for the protobuf text format, as such the

// C++ implementation (see google::protobuf::TextFormat) is the reference

// implementation of the text format.

//

// This package is neither a superset nor a subset of the C++ implementation.

// This implementation permits a more liberal grammar in some cases to be

// backwards compatible with the historical Go implementation.

// Future parsings unique to Go should not be added.

// Some grammars allowed by the C++ implementation are deliberately

// not implemented here because they are considered a bug by the protobuf team

// and should not be replicated.

//

// The Go implementation should implement a sufficient amount of the C++

// grammar such that the default text serialization by C++ can be parsed by Go.

// However, just because the C++ parser accepts some input does not mean that

// the Go implementation should as well.

//

// The text format is almost a superset of JSON except:

package text