From 6b6e155ff9c1f68e8745f711b07bfd8fc15756b7 Mon Sep 17 00:00:00 2001 From: Joe Tsai Date: Mon, 13 Aug 2018 16:40:31 -0700 Subject: Document wrapper non-uses Document the cases where the wrapper well-known types are not useful. --- src/google/protobuf/wrappers.proto | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'src') 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"; -- cgit v1.2.3