docca
docca copied to clipboard
boostorg
Boost.Book XSLT C++ documentation system
For example: ``` /** brief paragraph 1 paragraph 2 */ ``` does not produce two paragraphs as it should, per Markdown spec: 
The square brackets are escaped with backslash, they should not be: 
``` #include #include struct T { /** Return the decoded key and value as a pair This function returns the key and value as a pair, using the default allocator....
This block ``` @see @ref find_if, @ref find_if_not. @li B.1. Core Rules (rfc5234). @li B.1. Core Rules (rfc5234). ``` Renders as: 
From build output: ``` Generating output file: ../../bin.v2/libs/json/doc/json_doc.xml /home/grisumbras/dev/cppal/boost/bin.v2/libs/json/doc/reference.qbk|92| warning: line breaks generate invalid boostbook (will only note first occurrence). ``` reference.qbk:92 ``` [Constructor. [br][role silver —][br]Copy constructor. [br][role silver...
Type aliases are not showing the description and parameters: ``` /** Determine if `T` meets the requirements of @b CompletionHandler. This trait checks whether a type meets the requirements for...
See: https://www.boost.org/doc/libs/1_74_0/libs/beast/doc/html/beast/ref/boost__beast__multi_buffer.html Produced from this file: https://github.com/boostorg/beast/blob/4fbb0079c34e1e42e6d7527fd927163b3d2413de/include/boost/beast/core/multi_buffer.hpp Note that the error seems only to manifest in the documentation of the typedef `issue_50`, not the template to which it refers: `basic_issue_50`
When a template parameter name is customized, for example when `DynamicBuffer` is hyperlinked, standard variations on the name should also resolve to the customization: These are equivalent: ``` Handler Handler_...