X3 Documentation missing (or very hard to find)

[Ruben Van Boxem <vanboxem.ruben@…>]

Since Boost.Spirit.X3 has been released and included in the main Boost distribution, the only relevant documentation I have been able to find is the one for the cppnow conference here: ​http://ciere.com/cppnow15/x3_docs/

Suffice to say that is a terribly fragile location (i.e. not boost.org) and I doubt that nothing has changed in the code since it was put online.

The main Boost documentation should include the X3 parts, and it should match the current code.

[cppljevans@…]

+1.

In particular, there's this:

http://www.boost.org/doc/libs/1_61_0/libs/spirit/repository/doc/html/spirit_repository/qi_components/nonterminal/subrule.html

which says:

the implementation of rules is based on a virtual function call

which, AFAICT, is not true for x3 since, looking at:

spirit/home/x3/nonterminal/rule.hpp

and reading:

​http://ciere.com/cppnow15/x3_docs/spirit/quick_reference/non_terminals.html

the implementation is based on a pair of classes, Rule and Rule_def, *and* the BOOST_SPIRIT_DEFINE macro to connect the two.

The quick_reference should make this clear that the virtual function implementation remark does not apply to x3.

[Nikita Kniazev <nok.raven@…>]

Should be fixed in ​https://github.com/boostorg/spirit/pull/360. After merging the PR docs should appear on http://www.boost.org/doc/libs/develop/libs/spirit/doc/x3/html/index.html