Re: [boost] iterator traits

From: David Abrahams (dave_at_[hidden])
Date: 2002-12-19 15:32:12

Pavol Droba <droba_at_[hidden]> writes:

> On Thu, Dec 19, 2002 at 12:04:03PM -0500, David Abrahams wrote:
>> David Abrahams <dave_at_[hidden]> writes:
>> 
>> > Pavol Droba <droba_at_[hidden]> writes:
>> >
>> >> but I'm wondering, why it is not documented, or at least mentioned somewhere?
>> >> There are more of such useful headers in boost/detail directory, which are used
>> >> by various libraries. Whouldn't it make sense to write a simple doc mentioning
>> >> all this utilities, so people don't have to invent a wheel again and
>> >> again?
>> >
>> > Be my guest ;-)
>> >
>> > The hardest part of writing libraries is certainly documenting them.
>> > Speaking for myself, I'm lazy, and only wish to spend the effort to
>> > document libraries I'm going to release to the world.
>
> I know what do you mean, I'm working on string_algo library for boost,
> and (un)fortunately, I'm getting the to stage where I have to write documentation :(
> For me it is the hardest part of work ...
>
>> 
>> Pavol,
>> 
>> I just realized the above might sound discouraging... I really *would*
>> encourage you to document the useful utilities so we can make them an
>> official part of boost.  That file in particular might be good as part
>> of the compatibility library.
>
> Well, I might try if I find a time for doing it:) 
>
> Anyway, what I would like to suggest in the mean time, is to at least make a 
> summary of these utilities, so that boost developers have a place where they 
> can check, if something they need, does not already exists.
> I don't know the place and the form, I think it would be useful.

Maybe a Wiki page at
http://www.crystalclearsoftware.com/cgi-bin/boost_wiki/wiki.pl
?

Why don't you start one?
-- 
                       David Abrahams
   dave_at_[hidden] * http://www.boost-consulting.com
Boost support, enhancements, training, and commercial distribution