2009-10-09 66 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是讨厌的,讨厌的东西。但它几乎在每个项目中都是透彻和一致的。将随机雅加达项目文档的可浏览性与随机增强项目的可浏览性进行比较。