c++ - Doxygen 文档是否应该放在包括警卫之前？

Question

Doxygen 文档应该放在包括警卫之前还是之后；在命名空间之前或内部？

假设标头包含单个类 ( context) 的声明，这就是我在此处记录的内容。

#ifndef CONTEXT_HPP
#define CONTEXT_HPP

#include <string>    

/**
 * The application context interface.
 */
namespace test {
    class context { ... };
}

Answer 1

Header 文件的 Doxygen 信息

除非你的老板没有另外说，否则你把评论放在 include 守卫之前还是之后都没有关系。这完全取决于您（和您的团队）的个人喜好。我通常把它们放在文件的开头。

关于命名空间的 Doxygen 信息

这有点不同，在这种情况下，您应该始终将它们放在命名空间的前面，因为当有人阅读标题时它会更清楚。您应该始终将 doxygen 信息放在记录的元素之前。