]> granicus.if.org Git - clang/commit
Improve attribute documentation to list which spellings are used in which syntaxes.
authorRichard Smith <richard-llvm@metafoo.co.uk>
Thu, 30 Aug 2018 19:16:33 +0000 (19:16 +0000)
committerRichard Smith <richard-llvm@metafoo.co.uk>
Thu, 30 Aug 2018 19:16:33 +0000 (19:16 +0000)
commit8cee2e93e1cdd4b67b1ddcc3326b3f9e0be0a9d3
treef6dccf7956bd50dfdac0fde5eb14def3e2b9ed25
parentc029fb7612730e20a746b6cd9c9535f2adecbf85
Improve attribute documentation to list which spellings are used in which syntaxes.

Summary:
Instead of listing all the spellings (including attribute namespaces) in
the section heading, only list the actual attribute names there, and
list the spellings in the supported syntaxes table.

This allows us to properly describe things like [[fallthrough]], for
which we allow a clang:: prefix in C++ but not in C, and AlwaysInline,
which has one spelling as a GNU attribute and a different spelling as a
keyword, without needing to repeat the syntax description in the
documentation text.

Sample rendering: https://pste.eu/p/T1ZV.html

Reviewers: aaron.ballman

Subscribers: cfe-commits

Differential Revision: https://reviews.llvm.org/D51473

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@341097 91177308-0d34-0410-b5e6-96231b3b80d8
include/clang/Basic/AttrDocs.td
utils/TableGen/ClangAttrEmitter.cpp