search

llvm / llvm-project

The LLVM Project is a collection of modular and reusable compiler and toolchain technologies.
http://llvm.org
Other
27.57k stars 11.33k forks source link

doxygen keyword "internal" is not recognized as documentation #47159

Open wp-seth opened 3 years ago

wp-seth commented 3 years ago
Bugzilla Link 47815
Version trunk
OS All
CC @gribozavr,@zygoloid

Extended Description

the doxygen special command "internal" (see https://www.doxygen.nl/manual/commands.html) is not recognized as documentation by clang.

clang-tidy gives me warnings such as:

include/something.h:59:5: warning: unknown command tag name [clang-diagnostic-documentation-unknown-command]
         * @​internal implementation of copy operation
           ^

(edit: re-formatted after transfer from bugzilla)

llvmbot commented 3 years ago

I've moved it for you, I also cc'd someone who worked on the doxygen commands

wp-seth commented 3 years ago

That warning isn't from clang-tidy. its from clang. The warning happens to get passed to clang-tidys diagnostics.

yes, correct. so shall i change the product from clang-tools-extra to clang or open a new issue and close this one?

llvmbot commented 3 years ago

That warning isn't from clang-tidy. its from clang. The warning happens to get passed to clang-tidys diagnostics.