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 :-)