Re: X3 vs V2 - version and tutorial confusion

On 27/08/2018 6:30 PM, Xeverous wrote:
> I have recently started a project for some specific parser. I started to
> learn Spirit but given the state the homepage some things seem unclear to
> me:
> 
> Spirit has 3 versions
> - classic (V1.8)
> - X2 (V2.5.6)
> - X3
> 
> However, while reading the  X3 docs
> <https://www.boost.org/doc/libs/1_67_0/libs/spirit/doc/x3/html/index.html>
> it's significantly shorter compared to  V2 docs
> <https://www.boost.org/doc/libs/1_68_0/libs/spirit/doc/html/index.html>
> which leaves me in questions:
> 
> - Is X3 actually complete? Or just beta of the future, full X3 version?
> - Is X3 a replcement of X2 parser only? Other tasks such as error handling
> are not covered in X3 docs
> - Does linked X3 tutorial cover everything? I have build the fun-calc
> example but it contains a lot of stuff which was not covered in the tutorial
> - should I read X2 docs too?
> - Where can I find detailed docs about the API? For example, the X3 tutorial
> says to use  as an argument to parse function to ignore whitespace but does
> not list any alternatives neither list how they work.
> - There does not seem to be any full X3 doc availale which would list all
> functions/classes from the library

X3 has only the parser part. It is complete, but does not have all the features
of Qi (v2), and will probably not have all its features. There is an updated
tutorial which includes error-handling. Hopefully it will be generated and
added in the next Boost release.

Regards,
-- 
Joel de Guzman


------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most
engaging tech sites, Slashdot.org! http://sdm.link/slashdot