"Jeff Garland" <[EMAIL PROTECTED]> writes:
> I have added a sub-page to the Wiki to with all of the tasks, so we
> can document who is working on what -- sort of like the Libraries
> Under Construction page.
>
>
>http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost_Documentation_Format/Tasks
>
> I also pulled out the requirements to a separate page.
>
>
>http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl?Boost_Documentation_Format/Requirements
>
> And now for actually signing up for a task....well, I'm going to dodge
> for the short term b/c I'm just too busy with other things. However,
> I promise to help soon -- Given the magnitude of this I imagine we are
> going to be working on this for awhile.
>
> A couple thoughts on some of these:
>
>> Here's a nasty one. With the current prototype, we have the ability
>> to write <classname>function</classname> and have it automatically
>> create a link to the reference documentation for boost::function.
>
> Wouldn't this be easier if we always required full qualification? It
> will be ambiguous if we don't? Yes if you are doing this by hand it
> is harder, but if it is auto-generated then this shouldn't be too bad.
> I guess the other thought is that the ref might need to be separated
> from the text. That is:
> <classname ref="boost::function">function</classname>
>
> I'm not sure how that fits with docbook, but that's how I've solved
> this sort of issue with XML in the past.
Synopsis is doing some work to automatically detect the "domain" of a
declaration, so avoiding lots of qualification in its graph views.
I think we ought to consider ways to do this automatically with the
XML also, so that in most cases we don't need a redundant
representation of the class name. In other words, whatever processes
the XML for output should conditionally filter out the qualification
as needed, depending on context. Of course, I think we'll need to be
able to explicitly supply textual representation for certain cases, in
order to disambiguate.
--
David Abrahams
[EMAIL PROTECTED] * http://www.boost-consulting.com
Boost support, enhancements, training, and commercial distribution
-------------------------------------------------------
This sf.net email is sponsored by: To learn the basics of securing
your web site with SSL, click here to get a FREE TRIAL of a Thawte
Server Certificate: http://www.gothawte.com/rd524.html
_______________________________________________
Boost-docs mailing list
[EMAIL PROTECTED]
Unsubscribe and other administrative requests:
https://lists.sourceforge.net/lists/listinfo/boost-docs
