[all-commits] [llvm/llvm-project] 17e270: Clang AttributeReference: emit entries for "Undocu...

[James Y Knight via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: 17e27025287b96026a4351e1d73931bb0c76dac2
      https://github.com/llvm/llvm-project/commit/17e27025287b96026a4351e1d73931bb0c76dac2
  Author: James Y Knight <jyknight at google.com>
  Date:   2022-06-22 (Wed, 22 Jun 2022)

  Changed paths:
    M clang/docs/InternalsManual.rst
    M clang/include/clang/Basic/Attr.td
    M clang/utils/TableGen/ClangAttrEmitter.cpp

  Log Message:
  -----------
  Clang AttributeReference: emit entries for "Undocumented" attributes.

Almost all attributes currently marked `Undocumented` are user-facing
attributes which _ought_ to be documented, but nobody has written it
yet. This change ensures that we at least acknowledge that these
attributes exist in the documentation, even if we have no description
of their semantics.

A new category, `InternalOnly` has been added for those few attributes
which are not user-facing, and should remain omitted from the docs.