c++ - 更好的 Boost 引用？

Question

已结束。此问题不符合 Stack Overflow guidelines .它目前不接受答案。

---

我们不允许提出有关书籍、工具、软件库等方面的建议的问题。您可以编辑问题，以便用事实和引用来回答它。

关闭 4 年前。

Improve this question

真正让我对 Boost 感到厌烦的是他们的文档。我需要的是一个好的引用，而不是解释什么对我来说是一个好的引用，我会举个例子:

java.sun.com/javase/6/docs/api/是的，我喜欢它。也是这样的:cppreference.com/wiki/STL/vector/start

另一方面，我发现 boost 是这样的: http://www.boost.org/doc/libs/1_40_0/libs/smart_ptr/shared_ptr.htm

基本上是一些很长的文本页面。几乎没有格式，这里和那里有一些粗体文本，希望元素之间有一些链接。更不用说 smart_ptr 是记录更好的库之一。

如果您没有发现此示例与上述示例之间的区别，请停止阅读并忽略此帖子。不要误会我的意思，我编写 C++ 并使用 Boost。在我的公司，我们至少使用了他们的 4 个库，但每次我都需要检查方法原型(prototype)时，例如滚动浏览他们的文章时，我都会感到紧张。是的，我知道 Boost 是一个协作项目，不同的库是由不同的团队开发的。

那么你们中的任何人是否与我一样对 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> 下的“test”和“example”目录很有用。

您可以在 boost users 上发布您的问题、意见和建议。和/或 documentation邮件列表。据我所见，具体的文档改进建议通常会受到库维护者的欢迎。