From 41503c8de5efe39e5b060d208efe1b6453ae6147 Mon Sep 17 00:00:00 2001 From: Erick Velez Date: Fri, 21 Nov 2025 15:18:38 -0800 Subject: [PATCH] eof --- clang-tools-extra/test/clang-doc/enum.cpp | 145 ++++++++++++++++++++++ 1 file changed, 145 insertions(+) diff --git a/clang-tools-extra/test/clang-doc/enum.cpp b/clang-tools-extra/test/clang-doc/enum.cpp index b05d8e2029070..159d61ab5a3b7 100644 --- a/clang-tools-extra/test/clang-doc/enum.cpp +++ b/clang-tools-extra/test/clang-doc/enum.cpp @@ -1,12 +1,19 @@ // RUN: rm -rf %t && mkdir -p %t // RUN: clang-doc --format=html --doxygen --output=%t --executor=standalone %s // RUN: clang-doc --format=md --doxygen --output=%t --executor=standalone %s +// RUN: clang-doc --format=mustache --doxygen --output=%t --executor=standalone %s // RUN: FileCheck %s < %t/GlobalNamespace/index.html --check-prefix=HTML-INDEX-LINE // RUN: FileCheck %s < %t/GlobalNamespace/index.html --check-prefix=HTML-INDEX // RUN: FileCheck %s < %t/GlobalNamespace/Animals.html --check-prefix=HTML-ANIMAL-LINE // RUN: FileCheck %s < %t/GlobalNamespace/Animals.html --check-prefix=HTML-ANIMAL // RUN: FileCheck %s < %t/Vehicles/index.html --check-prefix=HTML-VEHICLES-LINE // RUN: FileCheck %s < %t/Vehicles/index.html --check-prefix=HTML-VEHICLES +// RUN: FileCheck %s < %t/html/GlobalNamespace/index.html --check-prefix=MUSTACHE-INDEX-LINE +// RUN: FileCheck %s < %t/html/GlobalNamespace/index.html --check-prefix=MUSTACHE-INDEX +// RUN: FileCheck %s < %t/html/GlobalNamespace/_ZTV7Animals.html --check-prefix=MUSTACHE-ANIMAL-LINE +// RUN: FileCheck %s < %t/html/GlobalNamespace/_ZTV7Animals.html --check-prefix=MUSTACHE-ANIMAL +// RUN: FileCheck %s < %t/html/Vehicles/index.html --check-prefix=MUSTACHE-VEHICLES-LINE +// RUN: FileCheck %s < %t/html/Vehicles/index.html --check-prefix=MUSTACHE-VEHICLES // RUN: FileCheck %s < %t/GlobalNamespace/index.md --check-prefix=MD-INDEX-LINE // RUN: FileCheck %s < %t/GlobalNamespace/index.md --check-prefix=MD-INDEX // RUN: FileCheck %s < %t/GlobalNamespace/Animals.md --check-prefix=MD-ANIMAL-LINE @@ -14,12 +21,15 @@ // RUN: FileCheck %s < %t/Vehicles/index.md --check-prefix=MD-VEHICLES-LINE // RUN: FileCheck %s < %t/Vehicles/index.md --check-prefix=MD-VEHICLES +// COM: FIXME: Add enum value comments to template + /** * @brief For specifying RGB colors */ enum Color { // MD-INDEX-LINE: *Defined at {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp#[[@LINE-1]]* // HTML-INDEX-LINE:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

+ // MUSTACHE-INDEX-LINE-NOT:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

Red, ///< Comment 1 Green, ///< Comment 2 Blue ///< Comment 3 @@ -44,12 +54,41 @@ enum Color { // HTML-INDEX: 2 // HTML-INDEX:

Comment 3

+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX: enum Color
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX:         
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX:
NameValue
Red0
Green1
Blue2
+ /** * @brief Shape Types */ enum class Shapes { // MD-INDEX-LINE: *Defined at {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp#[[@LINE-1]]* // HTML-INDEX-LINE:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

+ // MUSTACHE-INDEX-LINE-NOT:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

/// Comment 1 Circle, @@ -76,9 +115,40 @@ enum class Shapes { // HTML-INDEX: 2 // HTML-INDEX:

Comment 3

+// COM: FIXME: Serialize "enum class" in template +// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX: enum Shapes
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX:         
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX:
NameValue
Circle0
Rectangle1
Triangle2
+ +// COM: FIXME: Add enums declared inside of classes to class template class Animals { // MD-ANIMAL-LINE: *Defined at {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp#[[@LINE-1]]* // HTML-ANIMAL-LINE:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

+ // MUSTACHE-ANIMAL-LINE:

Defined at line [[@LINE-3]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

public: /** * @brief specify what animal the class is @@ -86,6 +156,7 @@ class Animals { enum AnimalType { // MD-ANIMAL-LINE: *Defined at {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp#[[@LINE-1]]* // HTML-ANIMAL-LINE:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

+ // MUSTACHE-ANIMAL-LINE-NOT:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

Dog, ///< Man's best friend Cat, ///< Man's other best friend Iguana ///< A lizard @@ -105,6 +176,19 @@ class Animals { // HTML-ANIMAL: 2 // HTML-ANIMAL:

A lizard

+// MUSTACHE-ANIMAL-NOT:

class Animals

+// MUSTACHE-ANIMAL-NOT:

Enums

+// MUSTACHE-ANIMAL-NOT: enum AnimalType +// MUSTACHE-ANIMAL-NOT: Dog +// MUSTACHE-ANIMAL-NOT: 0 +// MUSTACHE-ANIMAL-NOT:

Man's best friend

+// MUSTACHE-ANIMAL-NOT: Cat +// MUSTACHE-ANIMAL-NOT: 1 +// MUSTACHE-ANIMAL-NOT:

Man's other best friend

+// MUSTACHE-ANIMAL-NOT: Iguana +// MUSTACHE-ANIMAL-NOT: 2 +// MUSTACHE-ANIMAL-NOT:

A lizard

+ // MD-ANIMAL: # class Animals // MD-ANIMAL: ## Enums // MD-ANIMAL: | enum AnimalType | @@ -121,6 +205,7 @@ namespace Vehicles { enum Car { // MD-VEHICLES-LINE: *Defined at {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp#[[@LINE-1]]* // HTML-VEHICLES-LINE:

Defined at line [[@LINE-2]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp

+ // MUSTACHE-VEHICLES-LINE: Defined at line [[@LINE-3]] of file {{.*}}clang-tools-extra{{[\/]}}test{{[\/]}}clang-doc{{[\/]}}enum.cpp Sedan, ///< Comment 1 SUV, ///< Comment 2 @@ -154,6 +239,38 @@ enum Car { // HTML-VEHICLES: 3 // HTML-VEHICLES:

Comment 4

+// MUSTACHE-VEHICLES:
+// MUSTACHE-VEHICLES:
+// MUSTACHE-VEHICLES:             
+// MUSTACHE-VEHICLES: enum Car
+// MUSTACHE-VEHICLES:             
+// MUSTACHE-VEHICLES:         
+// MUSTACHE-VEHICLES:
+// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES: +// MUSTACHE-VEHICLES:
NameValue
Sedan0
SUV1
Pickup2
Hatchback3
+ enum ColorUserSpecified { RedUserSpecified = 'A', GreenUserSpecified = 2, @@ -173,3 +290,31 @@ enum ColorUserSpecified { // HTML-INDEX: 2 // HTML-INDEX: BlueUserSpecified // HTML-INDEX: 'C' + +// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX: enum ColorUserSpecified
+// MUSTACHE-INDEX:             
+// MUSTACHE-INDEX:         
+// MUSTACHE-INDEX:
+// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX: +// MUSTACHE-INDEX:
NameValue
RedUserSpecified'A'
GreenUserSpecified2
BlueUserSpecified'C'