ios - Xcode 5 的新文档解析是如何工作的？

Question

我注意到 Xcode 5 现在可以自动解析方法文档。例如:

/**
 Fetches a conversation with user.

 @param user The other user in the conversation.

 @return A conversation
 */
+ (Conversation *)conversationWithUser:(User *)user;

它支持多个@ 标记(不知道怎么调用它们)。例如:

• @warning
• @note

但是，我仍然没有找到一种方法或这是什么格式，以便我可以添加粗体文本、斜体或链接。

有人知道这是什么文档格式吗？

Answer 1

我找到了如何将粗体和斜体变为粗体的方法。它使用 this doxygen format .它似乎无法识别所有命令，但可以识别一些命令:

/**
 Resumes \b network operation queues.
 */
- (void)resume;

那里的 \b 会使网络变得粗体。 \a 生成斜体和 \c 等宽文本。