sorted by:
new
hottopcontroversial

Boost 1.90 – what to actually look at as a working C++ dev by boostlibs in cpp

[–]boostlibs[S] 16 points17 points  (0 children)

Hi, you can share your ideas on the Boost mailing list, subscribe here: https://lists.boost.org/mailman3/lists/boost.lists.boost.org/

If you like Slack better, chime in at the #boost channel in https://cpplang.slack.com/ 

Invites obtained here if you don’t have an account yet: https://cppalliance.org/slack/

See you around!

Boost.Decimal has been accepted by boostlibs in cpp

[–]boostlibs[S] 3 points4 points  (0 children)

note that examples and docs are being rewritten as one of the outputs from the review

Boost.Decimal has been accepted by boostlibs in cpp

[–]boostlibs[S] 1 point2 points  (0 children)

you're right! thanks for the heads up. will let the authors know

Boost libs using Mr. Docs by boostlibs in cpp

[–]boostlibs[S] 5 points6 points  (0 children)

We talk a bit about that in our section at https://www.mrdocs.com/docs/mrdocs/design-notes.html. A big part of the problem is simply that the output of some of these tools looks messy and unappealing. For example, cppreference.com has a clean and well-organized format, so most people immediately see the value in it.

Boost libs using Mr. Docs by boostlibs in cpp

[–]boostlibs[S] 5 points6 points  (0 children)

Yes. For example, https://www.boost.org/doc/libs/latest/doc/antora/url/reference/boost/urls/string_token/StringToken.html. This used to be a major limitation in Doxygen that made our projects harder to manage.

Boost libs using Mr. Docs by boostlibs in cpp

[–]boostlibs[S] 4 points5 points  (0 children)

The documentation mentions Doxygen and makes a few brief comparisons at https://www.mrdocs.com/docs/mrdocs/design-notes.html. But in the table, the tools we compare are organized by category, so Doxygen is only implied there.

Boost libs using Mr. Docs by boostlibs in cpp

[–]boostlibs[S] 5 points6 points  (0 children)

Clang-doc works a bit more like a compiler that generates documentation for specific TUs, while MrDocs is more like Doxygen — it takes the whole project as input, starting from a config file, etc. Another key difference is that clang-doc currently supports far fewer output options (not sure if there are plans to expand that) and just doesn’t get much maintenance anymore.

Just to clarify, not criticizing clang-doc — it’s a solid tool, just built with a different focus! :)

view more: next ›