Thomas Guest <[EMAIL PROTECTED]> writes: > Joel, Jo�o, > > I think the model Joel presents, based on collectors, looks conceptually > neater. The documentation drives the source code.
Both kinds of processing are needed. I used both with Litre when writing C++ Template Metaprogramming. > I can see more clearly how the second model (presented by Jo�o) would > work, but I don't like adding the snippet delimiters in comments. It > cuts across the Doxygen comment processing. Doxygen should not get special reign over the domain of comments. For that matter, ordinary comments cut across Doxygen comment processing! If we need to, we can run code through a quickbook comment filter before sending it on doxygen. I would like to use Synopsis for the purposes to which Doxygen is currently applied, and that can easily be customized to ignore quickbook comments. -- Dave Abrahams Boost Consulting www.boost-consulting.com ------------------------------------------------------- SF email is sponsored by - The IT Product Guide Read honest & candid reviews on hundreds of IT Products from real users. Discover which products truly live up to the hype. Start reading now. http://ads.osdn.com/?ad_id=6595&alloc_id=14396&op=click _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
