使用 HeaderDoc 或 Doxygen 时是否可以包含代码示例？

Question

我正在用 Objective-C 编写一个 Cocoa 框架，并希望使用文档编写器来生成 API 参考。对于 .NET，很容易包含以下示例：

/// <example>
/// <code lang="c#">
/// Console.WriteLine("Hello, World!");
/// </code>
/// </example>

使用 Apple 的 HeaderDoc 工具时是否可以这样做？如果可以，将如何完成？

如果不可能，使用 Doxygen 时我该怎么做？

Answer 1

对于那些使用苹果已经安装的工具“headerdoc”的人来说，它看起来像这样：

/*!
   <pre>
   @textblock
   - (void)foo {
      // bar
   }
   @/textblock
   </pre>
*/

Answer 2

好的 - 我已经得到答案了！我选择使用 Doxygen：

/**
 \code
 NSLog(@"Hello, World!");
 \endcode
*/