你的代碼可以規范到什么程度?為什么stm32官方歷程那樣編寫注釋
那么首先我們來看一個軟件幫助文檔:由于篇幅我們截取幾張簡單的圖片
2020-05-18_212920.png (153.73 KB, 下載次數: 62)
下載附件
2020-5-18 21:35 上傳
2020-05-18_212934.png (165.44 KB, 下載次數: 77)
下載附件
2020-5-18 21:36 上傳
2020-05-18_212945.png (166.63 KB, 下載次數: 66)
下載附件
2020-5-18 21:36 上傳
是的,嵌入式單片機也可以這樣寫注釋,文件引用關系、文件成員列表、成員函數和成員變量、類繼承關系圖等等等等都可以顯示出來
其實這個例子就是STM32官方庫函數,他就是這樣做的,代碼注釋符合Doxygen規范,所以可以產生簡單易懂的幫助文件。我們可以隨便找一個可文件查看效果相同。
DoxygenDoxygen是一種開源跨平臺的,以類似JavaDoc風格描述的文檔系統,完全支持C、C++、Java、Objective-C和IDL語言,部分支持PHP、C#。注釋的語法與Qt-Doc、KDoc和JavaDoc兼容。Doxgen可以從一套歸檔源文件開始,生成HTML格式的在線類瀏覽器,或離線的LATEX、RTF參考手冊。 Doxygen能將程序中的特定批注轉換成為說明文件。它可以依據程序本身的結構,將程序中按規范注釋的批注經過處理生成一個純粹的參考手冊,通過提取代碼結構或借助自動生成的包含依賴圖(include dependency graphs)、繼承圖(inheritancediagram)以及協作圖(collaboration diagram)來可視化文檔之間的關系,Doxygen生成的幫助文檔的格式可以是CHM、RTF、PostScript、PDF、HTML等。
HTML Help WorkShop
微軟出品的HTML Help WorkShop是制作CHM文件的最佳工具,它能將HTML文件編譯生成CHM文檔。 Doxygen軟件默認生成HTML文件或Latex文件,我們要通過HTML生成CHM文檔,需要先安裝HTML Help WorkShop軟件,并在Doxygen中進行關聯。 軟件的下載鏈接,使用方法請參考附件。
|