diff options
author | Jan Tattermusch <jtattermusch@users.noreply.github.com> | 2015-11-08 19:17:08 -0800 |
---|---|---|
committer | Jan Tattermusch <jtattermusch@users.noreply.github.com> | 2015-11-08 19:17:08 -0800 |
commit | 64aa954daec2f6f2df460f9bcc1e2ca6ba42b640 (patch) | |
tree | 1516488c97abdffcf10dcd9f5b9c38b5f6eb1cc6 /csharp/src/Google.Protobuf/WellKnownTypes/Any.cs | |
parent | 1e54dcfc707bc6ba23ac9a087336836f95d7fbd0 (diff) | |
parent | cff900e8f9e4b8f3a8f314f0f44eab222ebb870b (diff) | |
download | protobuf-64aa954daec2f6f2df460f9bcc1e2ca6ba42b640.tar.gz protobuf-64aa954daec2f6f2df460f9bcc1e2ca6ba42b640.tar.bz2 protobuf-64aa954daec2f6f2df460f9bcc1e2ca6ba42b640.zip |
Merge pull request #954 from jskeet/blank-lines-in-comments
Stop removing all blank lines in doc comments.
Diffstat (limited to 'csharp/src/Google.Protobuf/WellKnownTypes/Any.cs')
-rw-r--r-- | csharp/src/Google.Protobuf/WellKnownTypes/Any.cs | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/csharp/src/Google.Protobuf/WellKnownTypes/Any.cs b/csharp/src/Google.Protobuf/WellKnownTypes/Any.cs index 4a704018..64cbd33d 100644 --- a/csharp/src/Google.Protobuf/WellKnownTypes/Any.cs +++ b/csharp/src/Google.Protobuf/WellKnownTypes/Any.cs @@ -43,25 +43,30 @@ namespace Google.Protobuf.WellKnownTypes { /// <summary> /// `Any` contains an arbitrary serialized message along with a URL /// that describes the type of the serialized message. + /// /// JSON /// ==== /// The JSON representation of an `Any` value uses the regular /// representation of the deserialized, embedded message, with an /// additional field `@type` which contains the type URL. Example: + /// /// package google.profile; /// message Person { /// string first_name = 1; /// string last_name = 2; /// } + /// /// { /// "@type": "type.googleapis.com/google.profile.Person", /// "firstName": <string>, /// "lastName": <string> /// } + /// /// If the embedded message type is well-known and has a custom JSON /// representation, that representation will be embedded adding a field /// `value` which holds the custom JSON in addition to the the `@type` /// field. Example (for message [google.protobuf.Duration][google.protobuf.Duration]): + /// /// { /// "@type": "type.googleapis.com/google.protobuf.Duration", /// "value": "1.212s" @@ -101,8 +106,10 @@ namespace Google.Protobuf.WellKnownTypes { /// <summary> /// A URL/resource name whose content describes the type of the /// serialized message. + /// /// For URLs which use the schema `http`, `https`, or no schema, the /// following restrictions and interpretations apply: + /// /// * If no schema is provided, `https` is assumed. /// * The last segment of the URL's path must represent the fully /// qualified name of the type (as in `path/google.protobuf.Duration`). @@ -113,6 +120,7 @@ namespace Google.Protobuf.WellKnownTypes { /// lookup. Therefore, binary compatibility needs to be preserved /// on changes to types. (Use versioned type names to manage /// breaking changes.) + /// /// Schemas other than `http`, `https` (or the empty schema) might be /// used with implementation specific semantics. /// </summary> |