2009-10-09 92 views
26

真正讓我關於Boost的事情是他們的文檔。我需要的是一個很好的參考,而不是解釋一個很好的參考是我,我會給例如:更好的升壓參考?

java.sun.com/javase/6/docs/api/ 是的,我喜歡它。這也是這一點: cppreference.com/wiki/stl/vector/start

在另一方面我找到提升是這樣的: http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm

文本的一些基本長頁。幾乎沒有格式化,一些粗體文本在這裏和那裏,並希望元素之間的一些聯繫。更何況,smart_ptr是更好的記錄庫之一。

如果您沒有找到與上述示例的區別,請停止閱讀並忽略此信息。不要誤解我的意思,我寫C++並使用Boost。在我的公司,我們至少使用了4個庫,每次我需要檢查一個方法原型,例如它讓我擺脫了我的神經,滾動他們的散文。是的,我知道Boost是一個合作項目,不同的團隊開發了不同的圖書館。

所以,你們有沒有與Boost的參考分享我的失望,你知道一些更好的網站記錄Boost庫嗎?

回答

6

一般情況下,我找不到不好。總的來說,信息在那裏「某處」。我看到的主要問題是缺乏統一性,很難找到「某處」。正如你在你的問題中寫的那樣,這些文檔是由不同的人編寫的,而且時間不同,這可能是缺乏共同結構的原因。

從例子中引用的java和cppreference鏈接中,我推斷你比接受「教程」或「動機」的東西更感興趣的是界面的概要。對於shared_ptr,http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm#Synopsis提供了什麼?

對於某些庫,libs/<library_name>下的「test」和「example」目錄是有用的。

您可以發佈您的問題,意見和建議,在增強users和/或documentation郵件列表。從我看到的那裏,圖書館維護人員通常會歡迎具體的文檔改進建議。

+1

是的。我感興趣的是與您鏈接的摘要類似的摘要。不過,不要以爲這樣就夠好了。 – 2009-10-09 14:37:05

+0

這讓我想知道如何構建指向現有文檔的「概要」或「參考」部分的「索引頁」。 – 2009-10-09 14:49:29

+3

6年後,我有同樣的問題。 – SuppenGeist 2015-08-24 10:09:38

2

如果您正在尋找介紹性文字,我發現Bjorn Karlsson的書很好。一段時間以前,當我閱讀它時,現在可能會有更多最新的文本。 Find it here

+0

另一個需要注意的是,它只處理一些選定的庫。但我同意,這是對它涵蓋的內容的一個很好的介紹。 +1 – sbi 2009-10-09 10:51:48

+5

不,完全相反。我正在尋找一個參考,它們的方法可用類的大綱。 Boost站點足夠用於通用教程。 – 2009-10-09 14:34:48

0

綜觀提供的Java鏈接,以及超過一半是過時了,現在相當一段時間:)

你有PDF的工具和現在的文檔的PDF格式。有工具,更在其從很久以前的libbook作者的boostbook到簡介和更多..建立你自己的或解析現有的大多數標記成本已經過分誇大的項目:)

1

我絕對同意。 Javadoc是討厭的,討厭的東西。但它幾乎在每個項目中都是透徹和一致的。將隨機雅加達項目文檔的可瀏覽性與隨機增強項目的可瀏覽性進行比較。