Xcode代碼完成自定義描述

Question

對於某些方法，Xcode的代碼完成/建議/自動完成功能顯示說明：

當我創建類，函數，變量以及不提供描述的內容時，描述不會顯示：

但是，在右側的快速幫助菜單中，以及單擊alt+click ，它會：

我試過這個“解決方案” ，但它沒有用。 我需要在描述中包含任何特殊字符嗎？

注意

我目前正在使用Xcode 9 beta 1，但我也在Xcode 8中遇到過這個問題。

更新

很高興地說它現在適用於Xcode 9 GM。

Answer 1

我認為原因可能是///之后沒有空格。
正確的方法應該是

/// This is a description

事實上，如果您為屏幕截圖中提到的功能添加文檔，則會添加注釋，其中您可以在///后看到空格。 這是添加評論/文檔的正確方法。
選擇單擊函數調用后，將顯示說明。
Apple在自動完成中顯示描述的方式本身就是這樣做的。 您可能希望使用AppleDoc 。

Answer 2

Objective-C的

1.只需在方法之前添加描述，就像示例一樣。

@interface VVLabelBold : UILabel
-(void) setDefaultTextColor;

/**Disabled Label, This description will show in auto-complete*/
-(void) setDisabled;

@end

2 UILabel的呼叫方法

[lblSample setDisabled];