[llvm-branch-commits] [clang-tools-extra] [clang-doc][nfc] Reformat and revise comment block (PR #190428)

[Paul Kirth via llvm-branch-commits]

https://github.com/ilovepi updated https://github.com/llvm/llvm-project/pull/190428

>From 6860d87b5063e68df26fb7133b8d72981a22f8d9 Mon Sep 17 00:00:00 2001
From: Paul Kirth <paulkirth at google.com>
Date: Fri, 3 Apr 2026 22:56:47 +0000
Subject: [PATCH] [clang-doc][nfc] Reformat and revise comment block

---
 clang-tools-extra/clang-doc/Representation.h | 57 ++++++++++++--------
 1 file changed, 35 insertions(+), 22 deletions(-)

diff --git a/clang-tools-extra/clang-doc/Representation.h b/clang-tools-extra/clang-doc/Representation.h
index cde30daad97d2..a18d4e62c3acd 100644
--- a/clang-tools-extra/clang-doc/Representation.h
+++ b/clang-tools-extra/clang-doc/Representation.h
@@ -259,28 +259,41 @@ struct CommentInfo {
   // the vector.
   bool operator<(const CommentInfo &Other) const;
 
-  llvm::ArrayRef<CommentInfo> Children =
-      {};                   // List of child comments for this CommentInfo.
-  StringRef Direction = {}; // Parameter direction (for (T)ParamCommand).
-  StringRef Name = {};      // Name of the comment (for Verbatim and HTML).
-  StringRef ParamName = {}; // Parameter name (for (T)ParamCommand).
-  StringRef CloseName = {}; // Closing tag name (for VerbatimBlock).
-  StringRef Text = {};      // Text of the comment.
-  llvm::ArrayRef<StringRef> AttrKeys = {}; // List of attribute keys (for HTML).
-  llvm::ArrayRef<StringRef> AttrValues =
-      {}; // List of attribute values for each key (for HTML).
-  llvm::ArrayRef<StringRef> Args =
-      {}; // List of arguments to commands (for InlineCommand).
-  CommentKind Kind = CommentKind::
-      CK_Unknown; // Kind of comment (FullComment, ParagraphComment,
-                  // TextComment, InlineCommandComment, HTMLStartTagComment,
-                  // HTMLEndTagComment, BlockCommandComment,
-                  // ParamCommandComment, TParamCommandComment,
-                  // VerbatimBlockComment, VerbatimBlockLineComment,
-                  // VerbatimLineComment).
-  bool SelfClosing = false; // Indicates if tag is self-closing (for HTML).
-  bool Explicit = false;    // Indicates if the direction of a param is explicit
-                            // (for (T)ParamCommand).
+  // List of child comments for this CommentInfo.
+  ArrayRef<CommentInfo> Children = {};
+
+  // Parameter direction (for (T)ParamCommand).
+  StringRef Direction = {};
+
+  // Name of the comment (for Verbatim and HTML).
+  StringRef Name = {};
+
+  // Parameter name (for (T)ParamCommand).
+  StringRef ParamName = {};
+
+  // Closing tag name (for VerbatimBlock).
+  StringRef CloseName = {};
+
+  // Text of the comment.
+  StringRef Text = {};
+
+  // List of attribute keys (for HTML).
+  ArrayRef<StringRef> AttrKeys = {};
+
+  // List of attribute values for each key (for HTML).
+  ArrayRef<StringRef> AttrValues = {};
+
+  // List of arguments to commands (for InlineCommand).
+  ArrayRef<StringRef> Args = {};
+
+  // Type of comment. Unknown by default.
+  CommentKind Kind = CommentKind::CK_Unknown;
+
+  // Indicates if tag is self-closing (for HTML).
+  bool SelfClosing = false;
+
+  // Indicates if the direction of a param is explicit (for (T)ParamCommand).
+  bool Explicit = false;
 };
 
 struct Reference {