mirror of
https://github.com/protocolbuffers/protobuf-go.git
synced 2025-01-29 18:32:46 +00:00
118baf6390
Some companies (e.g., Google) run a profiling service where they may choose to special-case certain symbols in a binary to classify commonly used libraries like protobufs. This CL funnels similar functionality through a single function so that they can be more easily identified. This is by no means a firm statement that these identifiers will never change names, but at least the code documents warnings to avoid changing the name of certain identifiers. This CL provides the following semi-stable symbol names: "google.golang.org/protobuf/proto".MarshalOptions.size "google.golang.org/protobuf/proto".MarshalOptions.marshal "google.golang.org/protobuf/proto".UnmarshalOptions.unmarshal "google.golang.org/protobuf/encoding/prototext".MarshalOptions.marshal "google.golang.org/protobuf/encoding/prototext".UnmarshalOptions.unmarshal "google.golang.org/protobuf/encoding/protojson".MarshalOptions.marshal "google.golang.org/protobuf/encoding/protojson".UnmarshalOptions.unmarshal Merge and Clone are not part of the above set since there is a possibility that MergeOptions will be added in the future. We use an unexported method so that we have the freedom to change the method however we want since profilers do not care about that. Change-Id: Ia79af260d00125f48139420e1e18a86482bd1829 Reviewed-on: https://go-review.googlesource.com/c/protobuf/+/234079 Reviewed-by: Damien Neil <dneil@google.com>