@@ -1003,12 +1003,13 @@ public final UnaryCallable<CreateInstanceRequest, Operation> createInstanceCalla
 *
 * @param instance Required. The instance to update, which must always include the instance name.
 * Otherwise, only fields mentioned in
-* [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
+* [field_mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be
+* included.
 * @param fieldMask Required. A mask specifying which fields in
-* [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated. The
-* field mask must always be specified; this prevents any future fields in
-* [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients
-* that do not know about them.
+* [Instance][google.spanner.admin.instance.v1.Instance] should be updated. The field mask
+* must always be specified; this prevents any future fields in
+* [Instance][google.spanner.admin.instance.v1.Instance] from being erased accidentally by
+* clients that do not know about them.
 * @throws com.google.api.gax.rpc.ApiException if the remote call fails
 */
 @BetaApi(

@@ -193,7 +193,7 @@ public SpannerStub getStub() {
 * queries use a transaction internally, and count toward the one transaction limit.
 *
 * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-* unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+* unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
 * operations are sent for more than an hour. If a session is deleted, requests to it return
 * `NOT_FOUND`.
 *
@@ -231,7 +231,7 @@ public final Session createSession(DatabaseName database) {
 * queries use a transaction internally, and count toward the one transaction limit.
 *
 * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-* unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+* unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
 * operations are sent for more than an hour. If a session is deleted, requests to it return
 * `NOT_FOUND`.
 *
@@ -266,7 +266,7 @@ public final Session createSession(String database) {
 * queries use a transaction internally, and count toward the one transaction limit.
 *
 * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-* unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+* unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
 * operations are sent for more than an hour. If a session is deleted, requests to it return
 * `NOT_FOUND`.
 *
@@ -303,7 +303,7 @@ public final Session createSession(CreateSessionRequest request) {
 * queries use a transaction internally, and count toward the one transaction limit.
 *
 * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-* unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+* unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
 * operations are sent for more than an hour. If a session is deleted, requests to it return
 * `NOT_FOUND`.
 *

@@ -591,8 +591,8 @@ public void listDatabases(
 * have a name of the format `<database_name>/operations/<operation_id>` and
 * can be used to track preparation of the database. The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-* The [response][google.longrunning.Operation.response] field type is
+* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+* [response][google.longrunning.Operation.response] field type is
 * [Database][google.spanner.admin.database.v1.Database], if successful.
 * </pre>
 */
@@ -626,8 +626,7 @@ public void getDatabase(
 * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
 * track execution of the schema change(s). The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-* The operation has no response.
+* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata]. The operation has no response.
 * </pre>
 */
 public void updateDatabaseDdl(
@@ -830,8 +829,8 @@ public void listDatabases(
 * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
 * can be used to track preparation of the database. The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-* The [response][google.longrunning.Operation.response] field type is
+* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+* [response][google.longrunning.Operation.response] field type is
 * [Database][google.spanner.admin.database.v1.Database], if successful.
 * </pre>
 */
@@ -871,8 +870,7 @@ public void getDatabase(
 * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
 * track execution of the schema change(s). The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-* The operation has no response.
+* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata]. The operation has no response.
 * </pre>
 */
 public void updateDatabaseDdl(
@@ -1028,8 +1026,8 @@ public com.google.spanner.admin.database.v1.ListDatabasesResponse listDatabases(
 * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
 * can be used to track preparation of the database. The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-* The [response][google.longrunning.Operation.response] field type is
+* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+* [response][google.longrunning.Operation.response] field type is
 * [Database][google.spanner.admin.database.v1.Database], if successful.
 * </pre>
 */
@@ -1062,8 +1060,7 @@ public com.google.spanner.admin.database.v1.Database getDatabase(
 * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
 * track execution of the schema change(s). The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-* The operation has no response.
+* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata]. The operation has no response.
 * </pre>
 */
 public com.google.longrunning.Operation updateDatabaseDdl(
@@ -1198,8 +1195,8 @@ protected DatabaseAdminFutureStub build(
 * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
 * can be used to track preparation of the database. The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-* The [response][google.longrunning.Operation.response] field type is
+* [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+* [response][google.longrunning.Operation.response] field type is
 * [Database][google.spanner.admin.database.v1.Database], if successful.
 * </pre>
 */
@@ -1233,8 +1230,7 @@ protected DatabaseAdminFutureStub build(
 * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
 * track execution of the schema change(s). The
 * [metadata][google.longrunning.Operation.metadata] field type is
-* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-* The operation has no response.
+* [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata]. The operation has no response.
 * </pre>
 */
 public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>