Debug algorithms

[Jonathan Wakely]

On 14/09/16 11:33 +0100, Jonathan Wakely wrote:
>We need to get better at documenting things. The interaction between
>the different namespaces in Debug Mode, Parallel Mode etc is already
>confusing, and I think this patch would make it worse. The namespaces
>used for the math special functions should be documented too (but it's
>simpler there, we just have std and std::tr1, with nested __detail).
>Is all the information in the manual still correct at
>https://gcc.gnu.org/onlinedocs/libstdc++/manual/debug_mode_design.html ?

As an example of what I mean, my recent rework for the testsuite,
which touched hundreds of files, came with a rewrite of the docs on
testing: https://gcc.gnu.org/ml/libstdc++/2016-08/msg00108.html

I'd like to add something about the math special functions too
(explaining how to enable them for different -std options and the
interaction with TR1).

I'm always happy to help improve the docs, but I need to understand
the code fully to be able to describe it clearly :-)