2010-02-03 95 views

回答

2

PHPDocumentor for the @package annotation

包的文檔是用來幫助您在邏輯組相關的元素。你編寫類將相關的函數和數據組合在一起,phpDocumentor將文件(函數,定義和包含)的內容表示爲「程序頁面」。軟件包用於將類和程序頁面組合在一起,其方式與目錄將相關文件分組在一起的方式相同。

例如,Zend Framework中的所有驗證器都屬於Zend_Validate包,因爲從概念上講,它們就是這樣。當PHPDocumentor創建文檔時,您可以瀏覽Zend_Validate包並查看其中的所有具體驗證程序類。

PHPDepend顯然希望您使用註釋來創建適當的文檔(因此可以使用--bad-documentation)。查看我引用的頁面,瞭解如何使用註釋。