docs(regen): javadoc proto class changes from protoc update (#33)

proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentName.java

@@ -24,7 +24,7 @@
 import java.util.List;
 import java.util.Map;
 
-// AUTO-GENERATED DOCUMENTATION AND CLASS
+/** AUTO-GENERATED DOCUMENTATION AND CLASS */
 @javax.annotation.Generated("by GAPIC protoc plugin")
 public class AgentName implements ResourceName {
 

proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentOrBuilder.java

@@ -34,6 +34,8 @@ public interface AgentOrBuilder
    * <code>
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
    * </code>
+   *
+   * @return The parent.
    */
   java.lang.String getParent();
   /**
@@ -47,6 +49,8 @@ public interface AgentOrBuilder
    * <code>
    * string parent = 1 [(.google.api.field_behavior) = REQUIRED, (.google.api.resource_reference) = { ... }
    * </code>
+   *
+   * @return The bytes for parent.
    */
   com.google.protobuf.ByteString getParentBytes();
 
@@ -58,6 +62,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string display_name = 2 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The displayName.
    */
   java.lang.String getDisplayName();
   /**
@@ -68,6 +74,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string display_name = 2 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The bytes for displayName.
    */
   com.google.protobuf.ByteString getDisplayNameBytes();
 
@@ -83,6 +91,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string default_language_code = 3 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The defaultLanguageCode.
    */
   java.lang.String getDefaultLanguageCode();
   /**
@@ -97,6 +107,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string default_language_code = 3 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The bytes for defaultLanguageCode.
    */
   com.google.protobuf.ByteString getDefaultLanguageCodeBytes();
 
@@ -110,6 +122,8 @@ public interface AgentOrBuilder
    *
    * <code>repeated string supported_language_codes = 4 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return A list containing the supportedLanguageCodes.
    */
   java.util.List<java.lang.String> getSupportedLanguageCodesList();
   /**
@@ -122,6 +136,8 @@ public interface AgentOrBuilder
    *
    * <code>repeated string supported_language_codes = 4 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The count of supportedLanguageCodes.
    */
   int getSupportedLanguageCodesCount();
   /**
@@ -134,6 +150,9 @@ public interface AgentOrBuilder
    *
    * <code>repeated string supported_language_codes = 4 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @param index The index of the element to return.
+   * @return The supportedLanguageCodes at the given index.
    */
   java.lang.String getSupportedLanguageCodes(int index);
   /**
@@ -146,6 +165,9 @@ public interface AgentOrBuilder
    *
    * <code>repeated string supported_language_codes = 4 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the supportedLanguageCodes at the given index.
    */
   com.google.protobuf.ByteString getSupportedLanguageCodesBytes(int index);
 
@@ -159,6 +181,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string time_zone = 5 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The timeZone.
    */
   java.lang.String getTimeZone();
   /**
@@ -171,6 +195,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string time_zone = 5 [(.google.api.field_behavior) = REQUIRED];</code>
+   *
+   * @return The bytes for timeZone.
    */
   com.google.protobuf.ByteString getTimeZoneBytes();
 
@@ -183,6 +209,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string description = 6 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The description.
    */
   java.lang.String getDescription();
   /**
@@ -194,6 +222,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string description = 6 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The bytes for description.
    */
   com.google.protobuf.ByteString getDescriptionBytes();
 
@@ -209,6 +239,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string avatar_uri = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The avatarUri.
    */
   java.lang.String getAvatarUri();
   /**
@@ -223,6 +255,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>string avatar_uri = 7 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The bytes for avatarUri.
    */
   com.google.protobuf.ByteString getAvatarUriBytes();
 
@@ -234,6 +268,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>bool enable_logging = 8 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The enableLogging.
    */
   boolean getEnableLogging();
 
@@ -247,6 +283,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.MatchMode match_mode = 9 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The enum numeric value on the wire for matchMode.
    */
   int getMatchModeValue();
   /**
@@ -259,6 +297,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.MatchMode match_mode = 9 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The matchMode.
    */
   com.google.cloud.dialogflow.v2.Agent.MatchMode getMatchMode();
 
@@ -276,6 +316,8 @@ public interface AgentOrBuilder
    * </pre>
    *
    * <code>float classification_threshold = 10 [(.google.api.field_behavior) = OPTIONAL];</code>
+   *
+   * @return The classificationThreshold.
    */
   float getClassificationThreshold();
 
@@ -292,6 +334,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.ApiVersion api_version = 14 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The enum numeric value on the wire for apiVersion.
    */
   int getApiVersionValue();
   /**
@@ -307,6 +351,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.ApiVersion api_version = 14 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The apiVersion.
    */
   com.google.cloud.dialogflow.v2.Agent.ApiVersion getApiVersion();
 
@@ -320,6 +366,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.Tier tier = 15 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The enum numeric value on the wire for tier.
    */
   int getTierValue();
   /**
@@ -332,6 +380,8 @@ public interface AgentOrBuilder
    * <code>
    * .google.cloud.dialogflow.v2.Agent.Tier tier = 15 [(.google.api.field_behavior) = OPTIONAL];
    * </code>
+   *
+   * @return The tier.
    */
   com.google.cloud.dialogflow.v2.Agent.Tier getTier();
 }

proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AgentProto.java

@@ -180,26 +180,18 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "low/v2;dialogflow\370\001\001\242\002\002DF\252\002\032Google.Cloud"
           + ".Dialogflow.V2b\006proto3"
     };
-    com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner assigner =
-        new com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner() {
-          public com.google.protobuf.ExtensionRegistry assignDescriptors(
-              com.google.protobuf.Descriptors.FileDescriptor root) {
-            descriptor = root;
-            return null;
-          }
-        };
-    com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
-        descriptorData,
-        new com.google.protobuf.Descriptors.FileDescriptor[] {
-          com.google.api.AnnotationsProto.getDescriptor(),
-          com.google.api.ClientProto.getDescriptor(),
-          com.google.api.FieldBehaviorProto.getDescriptor(),
-          com.google.api.ResourceProto.getDescriptor(),
-          com.google.longrunning.OperationsProto.getDescriptor(),
-          com.google.protobuf.EmptyProto.getDescriptor(),
-          com.google.protobuf.FieldMaskProto.getDescriptor(),
-        },
-        assigner);
+    descriptor =
+        com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
+            descriptorData,
+            new com.google.protobuf.Descriptors.FileDescriptor[] {
+              com.google.api.AnnotationsProto.getDescriptor(),
+              com.google.api.ClientProto.getDescriptor(),
+              com.google.api.FieldBehaviorProto.getDescriptor(),
+              com.google.api.ResourceProto.getDescriptor(),
+              com.google.longrunning.OperationsProto.getDescriptor(),
+              com.google.protobuf.EmptyProto.getDescriptor(),
+              com.google.protobuf.FieldMaskProto.getDescriptor(),
+            });
     internal_static_google_cloud_dialogflow_v2_Agent_descriptor =
         getDescriptor().getMessageTypes().get(0);
     internal_static_google_cloud_dialogflow_v2_Agent_fieldAccessorTable =

proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AudioConfigProto.java

@@ -99,23 +99,15 @@ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
           + "\001\242\002\002DF\252\002\032Google.Cloud.Dialogflow.V2b\006pro"
           + "to3"
     };
-    com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner assigner =
-        new com.google.protobuf.Descriptors.FileDescriptor.InternalDescriptorAssigner() {
-          public com.google.protobuf.ExtensionRegistry assignDescriptors(
-              com.google.protobuf.Descriptors.FileDescriptor root) {
-            descriptor = root;
-            return null;
-          }
-        };
-    com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
-        descriptorData,
-        new com.google.protobuf.Descriptors.FileDescriptor[] {
-          com.google.api.FieldBehaviorProto.getDescriptor(),
-          com.google.api.ResourceProto.getDescriptor(),
-          com.google.protobuf.DurationProto.getDescriptor(),
-          com.google.api.AnnotationsProto.getDescriptor(),
-        },
-        assigner);
+    descriptor =
+        com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
+            descriptorData,
+            new com.google.protobuf.Descriptors.FileDescriptor[] {
+              com.google.api.FieldBehaviorProto.getDescriptor(),
+              com.google.api.ResourceProto.getDescriptor(),
+              com.google.protobuf.DurationProto.getDescriptor(),
+              com.google.api.AnnotationsProto.getDescriptor(),
+            });
     internal_static_google_cloud_dialogflow_v2_InputAudioConfig_descriptor =
         getDescriptor().getMessageTypes().get(0);
     internal_static_google_cloud_dialogflow_v2_InputAudioConfig_fieldAccessorTable =

proto-google-cloud-dialogflow-v2/src/main/java/com/google/cloud/dialogflow/v2/AudioEncoding.java

@@ -240,12 +240,20 @@ public final int getNumber() {
     return value;
   }
 
-  /** @deprecated Use {@link #forNumber(int)} instead. */
+  /**
+   * @param value The numeric wire value of the corresponding enum entry.
+   * @return The enum associated with the given numeric wire value.
+   * @deprecated Use {@link #forNumber(int)} instead.
+   */
   @java.lang.Deprecated
   public static AudioEncoding valueOf(int value) {
     return forNumber(value);
   }
 
+  /**
+   * @param value The numeric wire value of the corresponding enum entry.
+   * @return The enum associated with the given numeric wire value.
+   */
   public static AudioEncoding forNumber(int value) {
     switch (value) {
       case 0: