docca

docca copied to clipboard

Instead it produces `|9|` in red. See: http://www.boost.org/doc/libs/master/libs/beast/doc/html/beast/ref/boost__beast__http__message/method/overload2.html

vinniefalco

For example `value_type body()&&` or `value_type body() const&&`. The ref qualifier is not picked up in the documentation, it might be in doxygen's generated xsl but not extracted by the...

vinniefalco

See https://github.com/vinniefalco/docca/blob/master/include/docca/doxygen.xsl#L184

vinniefalco

Several users have complained that the overload resolution "landing page" doesn't make it clear that an additional click is required. It should be improved. Example: http://vinniefalco.github.io/beast/beast/ref/beast__http__read.html

vinniefalco

This shows the nested types: ``` /// Brief struct X { /// R using R = ...; }; ``` This doesn't ``` /// Brief class X { public: /// R...

vinniefalco


vinniefalco

Pages for elements without any description text should not have the Description heading

vinniefalco

When an enum is converted only the brief is extracted, even though the doxygen xml has the full description. enums should be treated as well as class members.

vinniefalco

It would be nice to have `#include ` at the top of the synopsis with a link to the corresponding header on github

vinniefalco

In a **@ref**, the namespace is shown for types but not for functions. For example ``` @see @ref async_read_some, @ref serializer ``` Produces **See Also: `async_read_some`, `http::serializer`**

vinniefalco