aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFeng Xiao <xfxyjwf@gmail.com>2018-08-13 17:49:03 -0700
committerGitHub <noreply@github.com>2018-08-13 17:49:03 -0700
commitfe2eef4bf414ebb352cf11bcec633f1fd46ec876 (patch)
tree7d23203f78f13ec5eaeecb9a830b9857ec3a7a7f
parentd39c7ef6ebda148ef52fcb9dc276339120aa3036 (diff)
parent6b6e155ff9c1f68e8745f711b07bfd8fc15756b7 (diff)
downloadprotobuf-fe2eef4bf414ebb352cf11bcec633f1fd46ec876.tar.gz
protobuf-fe2eef4bf414ebb352cf11bcec633f1fd46ec876.tar.bz2
protobuf-fe2eef4bf414ebb352cf11bcec633f1fd46ec876.zip
Merge pull request #5042 from dsnet/master
Document wrapper non-uses
-rw-r--r--src/google/protobuf/wrappers.proto5
1 files changed, 5 insertions, 0 deletions
diff --git a/src/google/protobuf/wrappers.proto b/src/google/protobuf/wrappers.proto
index 01947639..1940fd19 100644
--- a/src/google/protobuf/wrappers.proto
+++ b/src/google/protobuf/wrappers.proto
@@ -32,6 +32,11 @@
// for embedding primitives in the `google.protobuf.Any` type and for places
// where we need to distinguish between the absence of a primitive
// typed field and its default value.
+//
+// These wrappers have no meaningful use within repeated fields as they lack
+// the ability to detect presence on individual elements.
+// These wrappers have no meaningful use within a map or a oneof since individual
+// entries of a map or fields of a oneof can already detect presence.
syntax = "proto3";