对 C 代码注释的风格有一些疑问

Question

我对C代码注释的风格有些怀疑。 像这样：

/* brief Creates a new shm pcm */

有时是这样的：

/* !brief Creates a new shm PCM */

"\brief">

和"\！brief"有什么区别

Answer 1

这些是针对DoxyGen的注释，DoxyGen是一个从源代码生成文档的系统。

对于编译器来说，绝对没有区别。

DoxyGen希望/*! */和/** */标记注释是针对它的，请参阅文档。

正如Albert所提到的，几年前在src/pcm/pcm.c中，似乎有人将/*! brief ...与/* !brief混淆

了