[all-commits] [llvm/llvm-project] 0ce7d2: [clang-doc] Try to make testing more uniform (#205...

Paul Kirth via All-commits all-commits at lists.llvm.org
Thu Jun 25 14:57:36 PDT 2026


  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: 0ce7d23c2af4fbb828323423598d9c7f0bd10bb4
      https://github.com/llvm/llvm-project/commit/0ce7d23c2af4fbb828323423598d9c7f0bd10bb4
  Author: Paul Kirth <paulkirth at google.com>
  Date:   2026-06-25 (Thu, 25 Jun 2026)

  Changed paths:
    A clang-tools-extra/test/clang-doc/Inputs/DR-141990.cpp
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/database_template.json
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/include/Rectangle.h
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/include/Shape.h
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/src/Calculator.cpp
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/src/Circle.cpp
    M clang-tools-extra/test/clang-doc/Inputs/basic-project/src/Rectangle.cpp
    A clang-tools-extra/test/clang-doc/Inputs/builtin_types.cpp
    M clang-tools-extra/test/clang-doc/Inputs/class-partial-specialization.cpp
    A clang-tools-extra/test/clang-doc/Inputs/class-requires.cpp
    A clang-tools-extra/test/clang-doc/Inputs/class-specialization.cpp
    A clang-tools-extra/test/clang-doc/Inputs/class-template.cpp
    A clang-tools-extra/test/clang-doc/Inputs/class.cpp
    A clang-tools-extra/test/clang-doc/Inputs/comments-in-macros.cpp
    A clang-tools-extra/test/clang-doc/Inputs/compact.cpp
    A clang-tools-extra/test/clang-doc/Inputs/compound-constraints.cpp
    A clang-tools-extra/test/clang-doc/Inputs/concept.cpp
    A clang-tools-extra/test/clang-doc/Inputs/conversion_function.cpp
    M clang-tools-extra/test/clang-doc/Inputs/enum.cpp
    A clang-tools-extra/test/clang-doc/Inputs/function-requires.cpp
    A clang-tools-extra/test/clang-doc/Inputs/function-specifiers.cpp
    A clang-tools-extra/test/clang-doc/Inputs/index.cpp
    A clang-tools-extra/test/clang-doc/Inputs/inheritance.cpp
    A clang-tools-extra/test/clang-doc/Inputs/long-name.cpp
    A clang-tools-extra/test/clang-doc/Inputs/method-template.cpp
    A clang-tools-extra/test/clang-doc/Inputs/multiple-namespaces.cpp
    A clang-tools-extra/test/clang-doc/Inputs/mustache-index.cpp
    A clang-tools-extra/test/clang-doc/Inputs/mustache-separate-namespace.cpp
    A clang-tools-extra/test/clang-doc/Inputs/namespace-html-md.cpp
    A clang-tools-extra/test/clang-doc/Inputs/namespace.cpp
    A clang-tools-extra/test/clang-doc/Inputs/nested-namespace.cpp
    M clang-tools-extra/test/clang-doc/Inputs/nested-pointer-qualifiers.cpp
    A clang-tools-extra/test/clang-doc/Inputs/single-file-public.cpp
    A clang-tools-extra/test/clang-doc/Inputs/single-file.cpp
    A clang-tools-extra/test/clang-doc/Inputs/templates.cpp
    M clang-tools-extra/test/clang-doc/Inputs/test-assets/test.css
    M clang-tools-extra/test/clang-doc/Inputs/test-assets/test.js
    A clang-tools-extra/test/clang-doc/Inputs/typedef-alias.cpp
    R clang-tools-extra/test/clang-doc/array-type.cpp
    M clang-tools-extra/test/clang-doc/basic-project.mustache.test
    M clang-tools-extra/test/clang-doc/basic-project.test
    R clang-tools-extra/test/clang-doc/builtin_types.cpp
    R clang-tools-extra/test/clang-doc/class-partial-specialization.cpp
    R clang-tools-extra/test/clang-doc/comments-in-macros.cpp
    R clang-tools-extra/test/clang-doc/compact.cpp
    R clang-tools-extra/test/clang-doc/conversion_function.cpp
    R clang-tools-extra/test/clang-doc/enum.cpp
    R clang-tools-extra/test/clang-doc/function-pointer-type.cpp
    A clang-tools-extra/test/clang-doc/html/array-type.cpp
    A clang-tools-extra/test/clang-doc/html/class-partial-specialization.cpp
    A clang-tools-extra/test/clang-doc/html/class-specialization.cpp
    A clang-tools-extra/test/clang-doc/html/class.cpp
    A clang-tools-extra/test/clang-doc/html/comments-in-macros.cpp
    A clang-tools-extra/test/clang-doc/html/compound-constraints.cpp
    A clang-tools-extra/test/clang-doc/html/conversion_function.cpp
    A clang-tools-extra/test/clang-doc/html/enum.cpp
    A clang-tools-extra/test/clang-doc/html/function-pointer-type.cpp
    A clang-tools-extra/test/clang-doc/html/index.cpp
    A clang-tools-extra/test/clang-doc/html/long-name.cpp
    A clang-tools-extra/test/clang-doc/html/member-function-pointer-type.cpp
    A clang-tools-extra/test/clang-doc/html/mustache-index.cpp
    A clang-tools-extra/test/clang-doc/html/mustache-separate-namespace.cpp
    A clang-tools-extra/test/clang-doc/html/namespace.cpp
    A clang-tools-extra/test/clang-doc/html/nested-pointer-qualifiers.cpp
    A clang-tools-extra/test/clang-doc/html/templates.cpp
    A clang-tools-extra/test/clang-doc/html/typedef-alias.cpp
    R clang-tools-extra/test/clang-doc/index.cpp
    M clang-tools-extra/test/clang-doc/json/class-partial-specialization.cpp
    M clang-tools-extra/test/clang-doc/json/class-requires.cpp
    M clang-tools-extra/test/clang-doc/json/class-specialization.cpp
    M clang-tools-extra/test/clang-doc/json/class-template.cpp
    M clang-tools-extra/test/clang-doc/json/class.cpp
    A clang-tools-extra/test/clang-doc/json/compact.cpp
    M clang-tools-extra/test/clang-doc/json/compound-constraints.cpp
    M clang-tools-extra/test/clang-doc/json/concept.cpp
    A clang-tools-extra/test/clang-doc/json/conversion_function.cpp
    A clang-tools-extra/test/clang-doc/json/enum.cpp
    M clang-tools-extra/test/clang-doc/json/function-requires.cpp
    M clang-tools-extra/test/clang-doc/json/function-specifiers.cpp
    A clang-tools-extra/test/clang-doc/json/index.cpp
    M clang-tools-extra/test/clang-doc/json/inheritance.cpp
    A clang-tools-extra/test/clang-doc/json/long-name.cpp
    M clang-tools-extra/test/clang-doc/json/method-template.cpp
    M clang-tools-extra/test/clang-doc/json/multiple-namespaces.cpp
    M clang-tools-extra/test/clang-doc/json/namespace.cpp
    M clang-tools-extra/test/clang-doc/json/nested-namespace.cpp
    A clang-tools-extra/test/clang-doc/json/templates.cpp
    R clang-tools-extra/test/clang-doc/long-name.cpp
    A clang-tools-extra/test/clang-doc/md/array-type.cpp
    A clang-tools-extra/test/clang-doc/md/builtin_types.cpp
    A clang-tools-extra/test/clang-doc/md/class-partial-specialization.cpp
    A clang-tools-extra/test/clang-doc/md/comments-in-macros.cpp
    A clang-tools-extra/test/clang-doc/md/enum.cpp
    A clang-tools-extra/test/clang-doc/md/function-pointer-type.cpp
    A clang-tools-extra/test/clang-doc/md/member-function-pointer-type.cpp
    A clang-tools-extra/test/clang-doc/md/namespace.cpp
    A clang-tools-extra/test/clang-doc/md/nested-pointer-qualifiers.cpp
    A clang-tools-extra/test/clang-doc/md/templates.cpp
    R clang-tools-extra/test/clang-doc/member-function-pointer-type.cpp
    R clang-tools-extra/test/clang-doc/mustache-index.cpp
    R clang-tools-extra/test/clang-doc/mustache-separate-namespace.cpp
    R clang-tools-extra/test/clang-doc/namespace.cpp
    R clang-tools-extra/test/clang-doc/nested-pointer-qualifiers.cpp
    R clang-tools-extra/test/clang-doc/single-file-public.cpp
    R clang-tools-extra/test/clang-doc/single-file.cpp
    R clang-tools-extra/test/clang-doc/templates.cpp
    R clang-tools-extra/test/clang-doc/typedef-alias.cpp
    A clang-tools-extra/test/clang-doc/yaml/builtin_types.cpp
    A clang-tools-extra/test/clang-doc/yaml/conversion_function.cpp
    A clang-tools-extra/test/clang-doc/yaml/single-file-public.cpp
    A clang-tools-extra/test/clang-doc/yaml/single-file.cpp
    A clang-tools-extra/test/clang-doc/yaml/templates.cpp

  Log Message:
  -----------
  [clang-doc] Try to make testing more uniform (#205586)

Today clang-doc has tests for its various backends that use the same
input files, and mix the checks for each format. This leads to very
large test files that are quite hard to update or maintain. Thus far
we've assumed that this is better than updating several files, but as we
leverage mustache and JSON more and more to test feature completeness,
much of the output complexity is now limited to each backend and its
mustache templates. To make this simpler to maintain, we can lean into
common test Inputs keeping the annotate source separate from the test
checks, and split the checks out into their own directory hierarchy.
This patch is mostly mechanical rewriting of code. This was done with
the assistance of an LLM, but was checked by me, and verified with
instrumentation based coverage that we did not lose any line coverage.



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications


More information about the All-commits mailing list