On Thu, 30 Sep 2004 13:47:43 -0500, Doug Gregor wrote > On Sep 29, 2004, at 10:41 AM, Eric Niebler wrote: > > > IMO, it's a tradition that should change. I agree completely with > > Volodya and Jeff. > > IMHO, header-based documentation makes sense for course-grained > headers, but not for fine-grained headers. The C++ standard has > course-grained headers, and I think it works relatively well to use > header-based documentation.
I agree, the fine-grained makes the problem worse. No matter the header approach, however, as soon as a header contains more than one type or function the user is forced into a mapping process which is difficult.... > But once glance at the library reference > for Date-Time shows how the header-based documentation system really > breaks down with fine-grained headers. Yes, I've been struggling with that :-) > One alternative is to combine the synopsis from each header into a > single synopsis for the library, and then add a "Where Defined" > section to each reference page (as in the Graph library). Arbitrary > groupings could come later. Just be warned that I have zero time to > work on this for at least the next week and a half, so this is > definitely post-1.32.0. Personally, I'm not looking for anything in the near future -- I'd just like to explore how we can support libraries with these bigger reference sections better. In 1.33 there will be about a 30% increase in date-time reference, because we will be adding local_date_time with timezones and other goodies.... Jeff ------------------------------------------------------- This SF.net email is sponsored by: IT Product Guide on ITManagersJournal Use IT products in your business? Tell us what you think of them. Give us Your Opinions, Get Free ThinkGeek Gift Certificates! Click to find out more http://productguide.itmanagersjournal.com/guidepromo.tmpl _______________________________________________ Boost-docs mailing list [EMAIL PROTECTED] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
