Documenting V3 internals

[Rich Churcher <churcher at ihug dot com dot au>]

Gabriel Dos Reis <Gabriel.Dos-Reis@cmla.ens-cachan.fr> writes:

> Well, I have some trouble to follow this discussion (partly because of
> lack of time).  What exactly is it about? Documenting V3 internals? Or
> documenting what should help users to properly and efficiently use V3?

Both, I thought.

 
> I disagree with the idea of exposing V3 internals to users, if that
> was the idea under discussion. 

Really?  I think it's important that users of the library have easy
access to implementation details, if they're going to be adopting it
for projects of any significance.

There's no reason we can't do both - keep the current comments, and
duplicate them in external files for use in the libstdc++
documentation - but I'm not quite certain what your objection is.
Perhaps you could elaborate, when you have more time?

-- 
Cheers,
Rich.