链接到doxygen风格的Objective-C评论的外部URL文档

Question

我想写一些类似的东西：

/**
 Post a review. (For every place belongs only one review. If it was already written, the previous one will be overwritten.)

 @param placeId Place identifier
 @param rating Rating 0-5 for the place
 @param review The text the user entered for review
 @param callback Gets called either when the network request succeeds or when fails for some reason. The `success` parameter indicates this. If success is true, the contents of the `data` parameter of the response is given back as the `response` parameter. If the request fails, then only the `error` parameter is filled. You can find the details in this object.

 @see http://example.com/api/v1/doc/service/review/saveReview?pkey=t75jg-5uGse-qIo
 */
- (void)saveReviewFor:(NSNumber *)placeId rating:(NSUInteger)rating review:(NSString *)review callback:(VMNetworkCallback)callback;

问题是，@see标记中的链接在Xcode帮助气泡中无法点击：

此视图中是否有可点击的文档链接？我应该使用什么语法？

Answer 1

是的，可以这样做， 将您的 @see 标签更改为如下所示：

@see <http://example.com/api/v1/doc/service/review/saveReview?pkey=t75jg-5uGse-qIo>

有关更多信息，您可以阅读 Doxygen 文档中的相关部分 Markdown support -> Automatic Linking