remove bad suffix in parameter description that confuses doxygen

Author: scotthart

generator/internal/descriptor_utils.cc

@@ -322,6 +322,10 @@ ParameterCommentSubstitution substitutions[] = {
     {"\n", "\n  /// "},
 };
 
+char const* bad_suffixes[] = {
+    // Doxygen interprets this as an unpaired formatting character.
+    "\n ."};
+
 // Very long parameters need different formatting.
 auto constexpr kShortParamFormat = "  /// @param %s %s\n";
 auto constexpr kLongParamFormat = R"""(  /// @param %s %s
@@ -349,6 +353,9 @@ std::string FormattedCommentsForParameter(
   if (std::count(comment.begin(), comment.end(), '\n') > kTooManyLines) {
     std::vector<absl::string_view> paragraphs = absl::StrSplit(comment, "\n\n");
     auto brief = std::string{paragraphs.front()};
+    for (auto const& suffix : bad_suffixes) {
+      brief = std::string{absl::StripSuffix(brief, suffix)};
+    }
     for (auto& sub : substitutions) {
       sub.uses += absl::StrReplaceAll({{sub.before, sub.after}}, &brief);
     }
@@ -357,6 +364,9 @@ std::string FormattedCommentsForParameter(
                            method.input_type()->full_name());
   }
 
+  for (auto const& suffix : bad_suffixes) {
+    comment = std::string{absl::StripSuffix(comment, suffix)};
+  }
   for (auto& sub : substitutions) {
     sub.uses += absl::StrReplaceAll({{sub.before, sub.after}}, &comment);
   }

google/cloud/oracledatabase/v1/oracle_database_client.h

@@ -1009,7 +1009,6 @@ class OracleDatabaseClient {
   ///
   /// @param parent  Required. The parent value for database node in the following format:
   ///  projects/{project}/locations/{location}/cloudVmClusters/{cloudVmCluster}.
-  ///  .
   /// @param opts Optional. Override the class-level options, such as retry and
   ///     backoff policies.
   /// @return a [StreamRange](@ref google::cloud::StreamRange)