einpoklum
2017-03-29 20:56:59 UTC
我需要為我的C ++項目生成文檔(不久之後可能還會為其他項目生成文檔)。到目前為止,我已經研究了doxygen,儘管它似乎很流行,但我還是遇到了一些問題(有關細節,我將不再贅述;有些已經解決)。由於我並不特別喜歡它-儘管它很受歡迎,但我想考慮一些替代方法。
現在,在7年前,StackOverflow上存在一個確切的問題:
,但答案現在已經過時,因此,我在這里和現在都在問同樣的問題。
要求:
- Libre
- Gratis
- 多平台,至少支持Linux和Windows
- 具有與doxygen或更高版本相似的靈活性
- 積極維護
- 不可忽視的用戶群
如果您“在這裡不詳細介紹”,那麼將很難幫助您
@Mawg:主要是[this](http://stackoverflow.com/q/43093051/1593077),但我認為這對您沒有多大幫助。
但這解決了。那麼,為什麼不使用DoxyGen呢?只是好奇
@Mawg:這樣的行為使我預感,我可能想要別的東西。另外,為什麼我應該聽說過使用除氧劑?這不是我有積極的經驗。
為什麼不至少嘗試一下?有很多人對此持樂觀態度。他們不可能全都錯。另外,它已經得到了積極的維護和發展,並獲得了許多支持,並且Dimitri很有幫助。自從首頁開始“ Doxygen是從帶註釋的C ++來源生成文檔的事實上的標準工具”以來,肯定值得一試。而且,它繼續存在,“但它也支持其他流行的編程語言,這對我來說是一大優勢。
但是,等等,您遇到了一個問題,該問題已解決,因此您大概*已經*使用它來從代碼生成文檔。如果您可以告訴我們缺少哪些特定功能,那麼我們可以嘗試為您提供幫助。
@Mawg:誰說我沒有嘗試?我只是不想嘗試_only_ doxygen。
然後嘗試其他***和*** DoxyGen(如果有幫助,可能是因為它是行業標準)
由於到目前為止建議的唯一替代方法是Sphinx-Doc,請查看[Sphinx和Doxygen的主要區別是什麼?](https://stackoverflow.com/questions/31571849/what-are-the-main-differences獅身人面像和doxygen)和維基百科的[文檔生成器比較](https://en.wikipedia.org/wiki/Comparison_of_documentation_generators)
stackoverflow.com鏈接...現在返回“找不到頁面”。管理員在那裡有點失控。
@TrevorBoydSmith:該問題已刪除,但那裡的admis /主持人應將答案移至此處。也許我們可以做到?
@TrevorBoydSmith:看到我的新答案...
關於他說想要替代品時告訴他使用氧氣的所有無用評論是什麼? +1可以再發表一次無用的評論。感謝您提出問題,wtf是否刪除了另一個問題