通過設定專案輸出XML文件,來強制要求寫注釋

2021-04-16 15:20:07 字數 592 閱讀 6052

很多程式設計師不習慣寫注釋。甚至是一些比較底層的函式都不寫注釋。過一段時間後呼叫時候,就不得不去檢視實現**,才能知道某個邊界值的判斷是否在函式實現中判斷了。

如果手工檢查是否寫注釋的話,很多時候因為工作一忙,就走與形式了。

前幾天我的同事說在vs2005中找到的乙個超簡單的方式來強制寫注釋,如果公共函式沒有寫注釋,或者注視書寫錯誤,編譯程式的時候就會報警告。

這個設定就是我們很多人都知道的定義輸出的xml 文件,參見下圖:

比如我們下面的**:

public class class1

///

///

///protected void bb(int dd)

private void cc()

internal void dd()

} 就會報四個警告:

1、類沒有寫注釋

2、公共函式 public void aa() 沒有寫注釋

3、void bb(int dd) 這個函式注釋中出現了不存在的引數 ff

4、void bb(int dd) 這個函式沒有寫 引數 dd 的注釋。

通過上面乙個簡單的設定,就可以強制團隊的成員寫注釋。

通過設定專案輸出XML文件,來強制要求寫注釋

很多程式設計師不習慣寫注釋。甚至是一些比較底層的函式都不寫注釋。過一段時間後呼叫時候,就不得不去檢視實現 才能知道某個邊界值的判斷是否在函式實現中判斷了。如果手工檢查是否寫注釋的話,很多時候因為工作一忙,就走與形式了。前幾天我的同事說在vs2005中找到的乙個超簡單的方式來強制寫注釋,如果公共函式沒...

通過XmlDocument讀寫Xml文件

通過xmldocument讀寫xml文件 xmlversion 1.0 encoding utf 8 students studentname 張平 courses coursename 語文?teachercomment 這裡是語文老師的批註 coursename 數學 teachercommen...

Android通過XML來定義Menu

直接在 中新增選單項,給選單項分組等,這是比較傳統的做法,它存在著一些不足。比如說,為了響應每個選單項,我們需要用常量來儲存每個選單項的id等。為此,android提供了一種更好的方式,就是把menu也定義為應用程式的資源,通過android對資源的本地支援,使我們可以更方便地實現選單的建立與響應。...