一个更好的加速参考? [关闭](A Better Boost reference? [close

2019-07-21 17:11发布

这令我很反感约升压的事情是他们的文档。 我需要的是一个很好的参考,而是说明一个很好的参考,给我,我会给例如什么:

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 ++,我用升压。 在我的公司,我们用自己的音乐库中至少4个,每一次我需要检查的情况下就使我摆脱了我的神经,通过他们的文章滚动的方法原型。 是的,我知道,升压是一个合作项目和不同的库是由不同的团队开发的。

因此,没有任何的你Boost的参考分享我的失望和你知道一些更好的网站记录Boost库?

Answer 1:

在一般情况下,我没有找到文档 。 一般来说再次,信息是“某处”在那里。 我看到的主要问题是缺乏统一,因此很难找到“的地方”。 当你在你的问题写的文档是由不同的人,和不同的时间写的,而这可能是缺乏一个共同的结构的原因。

从你的例子举java和cppreference链接,我推断你是不是在“教程”或“动机”的东西更感兴趣的是接口的概要。 对于shared_ptr的,不http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm#Synopsis提供您以后在做什么?

对于某些库,“测试”并在“实例”的目录libs/<library_name>是有用的。

您可以在加强后您的问题,意见和建议的用户和/或文档邮件列表。 从我看到那里,具体文件改进的建议通常是由库的维护者欢迎。



Answer 2:

如果你正在寻找一个介绍性文字,我发现了比约恩·卡尔森本书非常好。 这是前一阵子,当我读它因此可能会有更多的到现在可用的最新文本。 在这里找到它 。



Answer 3:

我最肯定同意。 的Javadoc是讨厌,讨厌的东西。 但是,在几乎每一个项目彻底的和一贯的。 与随机加速项目的比较随机的Jakarta项目的文档的浏览功能。



Answer 4:

纵观提供的Java链接,也有一半以上的现在已经过时了相当一段时间:)

你有PDF的工具和文档的PDF格式现在..有一些工具和更多的道路上,从boostbook为LIB作家很久以前到概要和更多..建立自己的或解析现有大多数标记成本的一个已经被夸大项目:)



文章来源: A Better Boost reference? [closed]