Skylint: docstring format: warn about wrong order of sections only once

RELNOTES: none
PiperOrigin-RevId: 173257316

1 files changed, 3 insertions, 1 deletions

diff --git a/src/tools/skylark/java/com/google/devtools/skylark/skylint/DocstringUtils.java b/src/tools/skylark/java/com/google/devtools/skylark/skylint/DocstringUtils.java
index 4d556543a6..1d37bc6389 100644
--- a/src/tools/skylark/java/com/google/devtools/skylark/skylint/DocstringUtils.java
+++ b/src/tools/skylark/java/com/google/devtools/skylark/skylint/DocstringUtils.java
@@ -328,6 +328,7 @@ public final class DocstringUtils {
       List<ParameterDoc> params = new ArrayList<>();
       String returns = "";
       String deprecated = "";
+      boolean descriptionBodyAfterSpecialSectionsReported = false;
       while (!eof()) {
         switch (line) {
           case "Args:":
@@ -352,8 +353,9 @@ public final class DocstringUtils {
             deprecated = parseSectionAfterHeading();
             break;
           default:
-            if (specialSectionsStarted) {
+            if (specialSectionsStarted && !descriptionBodyAfterSpecialSectionsReported) {
               error("description body should go before the special sections");
+              descriptionBodyAfterSpecialSectionsReported = true;
             }
             if (deprecated.isEmpty() && nonStandardDeprecation.isEmpty()) {
               nonStandardDeprecation = checkForNonStandardDeprecation(line);