docs: Replacing HTML code with Markdown

docs: Fix PullResponse description docs: Fix Pull description PiperOrigin-RevId: 509846267 Source-Link: googleapis/googleapis@bb626b1 Source-Link: googleapis/googleapis-gen@34c8b57 Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuUHViU3ViLlYxLy5Pd2xCb3QueWFtbCIsImgiOiIzNGM4YjU3ODQ3Mjc2ZjdkNjdjZWQyNDViNTYwNzViOWNkZTg2MDk0In0=
googleapis · Feb 15, 2023 · f9467b0 · f9467b0
1 parent 7281474
commit f9467b0
Show file tree

Hide file tree

Showing 3 changed files with 173 additions and 229 deletions.
diff --git a/apis/Google.Cloud.PubSub.V1/Google.Cloud.PubSub.V1/Pubsub.g.cs b/apis/Google.Cloud.PubSub.V1/Google.Cloud.PubSub.V1/Pubsub.g.cs
@@ -4774,7 +4774,7 @@ public sealed partial class Subscription : pb::IMessage<Subscription>
     /// The approximate amount of time (on a best-effort basis) Pub/Sub waits for
     /// the subscriber to acknowledge receipt before resending the message. In the
     /// interval after the message is delivered and before it is acknowledged, it
-    /// is considered to be &lt;i>outstanding&lt;/i>. During that time period, the
+    /// is considered to be _outstanding_. During that time period, the
     /// message will not be redelivered (on a best-effort basis).
     ///
     /// For pull subscriptions, this value is used as the initial value for the ack
@@ -4847,8 +4847,8 @@ public sealed partial class Subscription : pb::IMessage<Subscription>
         = new pbc::MapField<string, string>.Codec(pb::FieldCodec.ForString(10, ""), pb::FieldCodec.ForString(18, ""), 74);
     private readonly pbc::MapField<string, string> labels_ = new pbc::MapField<string, string>();
     /// <summary>
-    /// See &lt;a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-    /// managing labels&lt;/a>.
+    /// See [Creating and managing
+    /// labels](https://cloud.google.com/pubsub/docs/labels).
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -6464,7 +6464,7 @@ public sealed partial class PushConfig : pb::IMessage<PushConfig>
     /// * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
     ///
     /// For example:
-    /// &lt;pre>&lt;code>attributes { "x-goog-version": "v1" } &lt;/code>&lt;/pre>
+    /// `attributes { "x-goog-version": "v1" }`
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -9389,7 +9389,8 @@ public sealed partial class PullResponse : pb::IMessage<PullResponse>
     private readonly pbc::RepeatedField<global::Google.Cloud.PubSub.V1.ReceivedMessage> receivedMessages_ = new pbc::RepeatedField<global::Google.Cloud.PubSub.V1.ReceivedMessage>();
     /// <summary>
     /// Received Pub/Sub messages. The list will be empty if there are no more
-    /// messages available in the backlog. For JSON, the response can be entirely
+    /// messages available in the backlog, or if no messages could be returned
+    /// before the request timeout. For JSON, the response can be entirely
     /// empty. The Pub/Sub system may return fewer than the `maxMessages` requested
     /// even if there are more messages available in the backlog.
     /// </summary>
@@ -11604,9 +11605,9 @@ public sealed partial class CreateSnapshotRequest : pb::IMessage<CreateSnapshotR
     /// Required. User-provided name for this snapshot. If the name is not provided
     /// in the request, the server will assign a random name for this snapshot on
     /// the same project as the subscription. Note that for REST API requests, you
-    /// must specify a name.  See the &lt;a
-    /// href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource
-    /// name rules&lt;/a>. Format is `projects/{project}/snapshots/{snap}`.
+    /// must specify a name.  See the [resource name
+    /// rules](https://cloud.google.com/pubsub/docs/admin#resource_names). Format
+    /// is `projects/{project}/snapshots/{snap}`.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]
@@ -11646,8 +11647,8 @@ public sealed partial class CreateSnapshotRequest : pb::IMessage<CreateSnapshotR
         = new pbc::MapField<string, string>.Codec(pb::FieldCodec.ForString(10, ""), pb::FieldCodec.ForString(18, ""), 26);
     private readonly pbc::MapField<string, string> labels_ = new pbc::MapField<string, string>();
     /// <summary>
-    /// See &lt;a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-    /// managing labels&lt;/a>.
+    /// See [Creating and managing
+    /// labels](https://cloud.google.com/pubsub/docs/labels).
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     [global::System.CodeDom.Compiler.GeneratedCode("protoc", null)]

diff --git a/apis/Google.Cloud.PubSub.V1/Google.Cloud.PubSub.V1/PubsubGrpc.g.cs b/apis/Google.Cloud.PubSub.V1/Google.Cloud.PubSub.V1/PubsubGrpc.g.cs
@@ -1197,9 +1197,7 @@ public abstract partial class SubscriberBase
       }
 
       /// <summary>
-      /// Pulls messages from the server. The server may return `UNAVAILABLE` if
-      /// there are too many concurrent pull requests pending for the given
-      /// subscription.
+      /// Pulls messages from the server.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -1248,10 +1246,10 @@ public abstract partial class SubscriberBase
 
       /// <summary>
       /// Gets the configuration details of a snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow you to manage message acknowledgments in bulk. That
-      /// is, you can set the acknowledgment state of messages in an existing
-      /// subscription to the state captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -1307,11 +1305,10 @@ public abstract partial class SubscriberBase
 
       /// <summary>
       /// Updates an existing snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow
-      /// you to manage message acknowledgments in bulk. That is, you can set the
-      /// acknowledgment state of messages in an existing subscription to the state
-      /// captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request received from the client.</param>
       /// <param name="context">The context of the server-side call handler being invoked.</param>
@@ -1826,9 +1823,7 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
         return CallInvoker.AsyncUnaryCall(__Method_Acknowledge, null, options, request);
       }
       /// <summary>
-      /// Pulls messages from the server. The server may return `UNAVAILABLE` if
-      /// there are too many concurrent pull requests pending for the given
-      /// subscription.
+      /// Pulls messages from the server.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -1841,9 +1836,7 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
         return Pull(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Pulls messages from the server. The server may return `UNAVAILABLE` if
-      /// there are too many concurrent pull requests pending for the given
-      /// subscription.
+      /// Pulls messages from the server.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -1854,9 +1847,7 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
         return CallInvoker.BlockingUnaryCall(__Method_Pull, null, options, request);
       }
       /// <summary>
-      /// Pulls messages from the server. The server may return `UNAVAILABLE` if
-      /// there are too many concurrent pull requests pending for the given
-      /// subscription.
+      /// Pulls messages from the server.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -1869,9 +1860,7 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
         return PullAsync(request, new grpc::CallOptions(headers, deadline, cancellationToken));
       }
       /// <summary>
-      /// Pulls messages from the server. The server may return `UNAVAILABLE` if
-      /// there are too many concurrent pull requests pending for the given
-      /// subscription.
+      /// Pulls messages from the server.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -1985,10 +1974,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Gets the configuration details of a snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow you to manage message acknowledgments in bulk. That
-      /// is, you can set the acknowledgment state of messages in an existing
-      /// subscription to the state captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2002,10 +1991,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Gets the configuration details of a snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow you to manage message acknowledgments in bulk. That
-      /// is, you can set the acknowledgment state of messages in an existing
-      /// subscription to the state captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2017,10 +2006,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Gets the configuration details of a snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow you to manage message acknowledgments in bulk. That
-      /// is, you can set the acknowledgment state of messages in an existing
-      /// subscription to the state captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2034,10 +2023,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Gets the configuration details of a snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow you to manage message acknowledgments in bulk. That
-      /// is, you can set the acknowledgment state of messages in an existing
-      /// subscription to the state captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2221,11 +2210,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Updates an existing snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow
-      /// you to manage message acknowledgments in bulk. That is, you can set the
-      /// acknowledgment state of messages in an existing subscription to the state
-      /// captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2239,11 +2227,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Updates an existing snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow
-      /// you to manage message acknowledgments in bulk. That is, you can set the
-      /// acknowledgment state of messages in an existing subscription to the state
-      /// captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>
@@ -2255,11 +2242,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Updates an existing snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow
-      /// you to manage message acknowledgments in bulk. That is, you can set the
-      /// acknowledgment state of messages in an existing subscription to the state
-      /// captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="headers">The initial metadata to send with the call. This parameter is optional.</param>
@@ -2273,11 +2259,10 @@ protected SubscriberClient(ClientBaseConfiguration configuration) : base(configu
       }
       /// <summary>
       /// Updates an existing snapshot. Snapshots are used in
-      /// &lt;a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek&lt;/a>
-      /// operations, which allow
-      /// you to manage message acknowledgments in bulk. That is, you can set the
-      /// acknowledgment state of messages in an existing subscription to the state
-      /// captured by a snapshot.
+      /// [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations,
+      /// which allow you to manage message acknowledgments in bulk. That is, you can
+      /// set the acknowledgment state of messages in an existing subscription to the
+      /// state captured by a snapshot.
       /// </summary>
       /// <param name="request">The request to send to the server.</param>
       /// <param name="options">The options for the call.</param>