Proto for Boost mailing list page: Re: [proto] user docs for advanced features

Subject: Re: [proto] user docs for advanced features
From: Thomas Heller (thom.heller_at_[hidden])
Date: 2012-01-04 10:37:39

On 01/03/2012 01:55 AM, Eric Niebler wrote:
> Proto's users guide has been behind the times for a while. No longer.
> More recent and powerful features are now documented. Feedback welcome.
>
> Sub-domains:
> ============
> http://boost-sandbox.sourceforge.net/libs/proto/doc/html/boost_proto/users_guide/front_end/customizing_expressions_in_your_domain/subdomains.html

The section is very informative and explains the concept nicely!

>
> Per-domain as_child customization:
> ==================================
> http://boost-sandbox.sourceforge.net/libs/proto/doc/html/boost_proto/users_guide/front_end/customizing_expressions_in_your_domain/per_domain_as_child.html

Also a very nice addition to the existing documentation. What's not 
immediately clear after reading that section is when proto::as_expr is 
called within the library, or when you want to call it as a user. Some 
clarification would be good here.

> External Transforms:
> ===================
> http://boost-sandbox.sourceforge.net/libs/proto/doc/html/boost_proto/users_guide/back_end/expression_transformation/external_transforms.html

There is a small typo here: "Just how r_i_diculous would it be to copy..."
One addition which might be helpful to the interested reader is to 
explicitly say that proto's data "slot" is used for the external transform.

Thanks for adding this documentation!

Hope that helps,
Thomas