commit 56112cc01f8be29578d52c1c2af6f481c3d77bd2
author David Benjamin <davidben@google.com> Fri Dec 15 18:28:54 2023 -0500
committer Boringssl LUCI CQ <boringssl-scoped@luci-project-accounts.iam.gserviceaccount.com> Mon Dec 18 15:41:42 2023 +0000
tree 0670753a4dda7cce30f826eb75d90e14279a828b
parent 7460d7456433fbaf28ec679fc138fefd6b2120cd

Skip emitting empty <pre> blocks in documentation

We sometimes have decl-less comments interspersed in headers. Avoid the
empty patch of blue when they get rendered.

Change-Id: I6668946d07349febd6d28bbe7d4fd8d2426adca9
Reviewed-on: https://boringssl-review.googlesource.com/c/boringssl/+/64927
Auto-Submit: David Benjamin <davidben@google.com>
Commit-Queue: David Benjamin <davidben@google.com>
Reviewed-by: Bob Beck <bbe@google.com>
Commit-Queue: Bob Beck <bbe@google.com>

util/doc.go

diff --git a/util/doc.go b/util/doc.go
index 4fb73ca..ae5c45d 100644
--- a/util/doc.go
+++ b/util/doc.go
@@ -649,7 +649,7 @@
           {{range .Comment}}
             <p>{{. | markupPipeWords | newlinesToBR | markupFirstWord | markupRFC}}</p>
           {{end}}
-          <pre>{{.Decl}}</pre>
+          {{if .Decl}}<pre>{{.Decl}}</pre>{{end}}
           </div>
         {{end}}
         </div>