aboutsummaryrefslogtreecommitdiff
path: root/objectivec/google/protobuf/Api.pbobjc.h
diff options
context:
space:
mode:
Diffstat (limited to 'objectivec/google/protobuf/Api.pbobjc.h')
-rw-r--r--objectivec/google/protobuf/Api.pbobjc.h36
1 files changed, 18 insertions, 18 deletions
diff --git a/objectivec/google/protobuf/Api.pbobjc.h b/objectivec/google/protobuf/Api.pbobjc.h
index 3dda7698..182e866c 100644
--- a/objectivec/google/protobuf/Api.pbobjc.h
+++ b/objectivec/google/protobuf/Api.pbobjc.h
@@ -88,14 +88,14 @@ typedef GPB_ENUM(GPBApi_FieldNumber) {
* outlined below. If the field is not empty, the version in the
* package name will be verified to be consistent with what is
* provided here.
- *
+ *
* The versioning schema uses [semantic
* versioning](http://semver.org) where the major version number
* indicates a breaking change and the minor version an additive,
* non-breaking change. Both version numbers are signals to users
* what to expect from different versions, and should be carefully
* chosen based on the product plan.
- *
+ *
* The major version is also reflected in the package name of the
* API, which must end in `v<major-version>`, as in
* `google.feature.v1`. For major versions 0 and 1, the suffix can
@@ -199,21 +199,21 @@ typedef GPB_ENUM(GPBMixin_FieldNumber) {
* Declares an API to be included in this API. The including API must
* redeclare all the methods from the included API, but documentation
* and options are inherited as follows:
- *
+ *
* - If after comment and whitespace stripping, the documentation
* string of the redeclared method is empty, it will be inherited
* from the original method.
- *
+ *
* - Each annotation belonging to the service config (http,
* visibility) which is not set in the redeclared method will be
* inherited.
- *
+ *
* - If an http annotation is inherited, the path pattern will be
* modified as follows. Any version prefix will be replaced by the
* version of the including API plus the [root][] path if specified.
- *
+ *
* Example of a simple mixin:
- *
+ *
* package google.acl.v1;
* service AccessControl {
* // Get the underlying ACL object.
@@ -221,30 +221,30 @@ typedef GPB_ENUM(GPBMixin_FieldNumber) {
* option (google.api.http).get = "/v1/{resource=**}:getAcl";
* }
* }
- *
+ *
* package google.storage.v2;
* service Storage {
* rpc GetAcl(GetAclRequest) returns (Acl);
- *
+ *
* // Get a data record.
* rpc GetData(GetDataRequest) returns (Data) {
* option (google.api.http).get = "/v2/{resource=**}";
* }
* }
- *
+ *
* Example of a mixin configuration:
- *
+ *
* apis:
* - name: google.storage.v2.Storage
* mixins:
* - name: google.acl.v1.AccessControl
- *
+ *
* The mixin construct implies that all methods in `AccessControl` are
* also declared with same name and request/response types in
* `Storage`. A documentation generator or annotation processor will
* see the effective `Storage.GetAcl` method after inherting
* documentation and annotations as follows:
- *
+ *
* service Storage {
* // Get the underlying ACL object.
* rpc GetAcl(GetAclRequest) returns (Acl) {
@@ -252,20 +252,20 @@ typedef GPB_ENUM(GPBMixin_FieldNumber) {
* }
* ...
* }
- *
+ *
* Note how the version in the path pattern changed from `v1` to `v2`.
- *
+ *
* If the `root` field in the mixin is specified, it should be a
* relative path under which inherited HTTP paths are placed. Example:
- *
+ *
* apis:
* - name: google.storage.v2.Storage
* mixins:
* - name: google.acl.v1.AccessControl
* root: acls
- *
+ *
* This implies the following inherited HTTP annotation:
- *
+ *
* service Storage {
* // Get the underlying ACL object.
* rpc GetAcl(GetAclRequest) returns (Acl) {