impl(docfx): weave syntax in existing YAML (#11160)

Author: coryan

docfx/doxygen2yaml.cc

@@ -14,6 +14,7 @@
 
 #include "docfx/doxygen2yaml.h"
 #include "docfx/doxygen2markdown.h"
+#include "docfx/doxygen2syntax.h"
 #include "docfx/doxygen_errors.h"
 #include "docfx/yaml_emit.h"
 #include <sstream>
@@ -135,6 +136,7 @@ bool AppendIfEnum(YAML::Emitter& yaml, YamlContext const& ctx,
        << YAML::Key << "parent" << YAML::Value << ctx.parent_id             //
        << YAML::Key << "type" << YAML::Value << "enum"                      //
        << YAML::Key << "langs" << YAML::BeginSeq << "cpp" << YAML::EndSeq;  //
+  AppendEnumSyntax(yaml, ctx, node);
   auto const summary = Summary(node);
   if (!summary.empty()) {
     yaml << YAML::Key << "summary" << YAML::Value << YAML::Literal << summary;
@@ -164,6 +166,7 @@ bool AppendIfTypedef(YAML::Emitter& yaml, YamlContext const& ctx,
        << YAML::Key << "parent" << YAML::Value << ctx.parent_id             //
        << YAML::Key << "type" << YAML::Value << "typedef"                   //
        << YAML::Key << "langs" << YAML::BeginSeq << "cpp" << YAML::EndSeq;  //
+  AppendTypedefSyntax(yaml, ctx, node);
   auto const summary = Summary(node);
   if (!summary.empty()) {
     yaml << YAML::Key << "summary" << YAML::Value << YAML::Literal << summary;

docfx/doxygen2yaml_test.cc

@@ -217,6 +217,20 @@ TEST(Doxygen2Yaml, Enum) {
     type: enum
     langs:
       - cpp
+    syntax:
+      contents: |
+        enum class google::cloud::Idempotency {
+          kIdempotent,
+          kNonIdempotent,
+        };
+      source:
+        id: Idempotency
+        path: google/cloud/idempotency.h
+        startLine: 55
+        remote:
+          repo: https://github.com/googleapis/google-cloud-cpp/
+          branch: main
+          path: google/cloud/idempotency.h
     summary: |
       Whether a request is [idempotent](https://en.wikipedia.org/wiki/Idempotence).
 
@@ -315,6 +329,18 @@ TEST(Doxygen2Yaml, Typedef) {
     type: typedef
     langs:
       - cpp
+    syntax:
+      contents: |
+        using google::cloud::BackgroundThreadsFactory =
+          std::function< std::unique_ptr< BackgroundThreads >()>;
+      source:
+        id: BackgroundThreadsFactory
+        path: google/cloud/grpc_options.h
+        startLine: 148
+        remote:
+          repo: https://github.com/googleapis/google-cloud-cpp/
+          branch: main
+          path: google/cloud/grpc_options.h
     summary: |
       A short description of the thing.
 
@@ -350,6 +376,18 @@ TEST(Doxygen2Yaml, SectionDef) {
     type: typedef
     langs:
       - cpp
+    syntax:
+      contents: |
+        using google::cloud::AccessTokenLifetimeOption::Type =
+          std::chrono::seconds;
+      source:
+        id: Type
+        path: google/cloud/credentials.h
+        startLine: 301
+        remote:
+          repo: https://github.com/googleapis/google-cloud-cpp/
+          branch: main
+          path: google/cloud/credentials.h
 )yml";
 
   pugi::xml_document doc;