[Bug libstdc++/33491] parallel v3: add some documentation

[redi at gcc dot gnu.org]

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=33491

Jonathan Wakely <redi at gcc dot gnu.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Keywords|                            |documentation

--- Comment #2 from Jonathan Wakely <redi at gcc dot gnu.org> ---
(In reply to Wolfgang Bangerth from comment #0)
> Of even more interest I would find if the following: parallel mode probably
> implements a lot of stuff like work stealing, load balancing, etc beyond
> what the library part of C++98 specifies that it needs to provide. If 
> the respective classes are meant to have stable interfaces

They're not.

> then it would
> be interesting to document them so that user programs could also use these
> interfaces.

I don't think we want that to happen.

I expect the Parallel Mode to be deprecated once
https://gcc.gnu.org/ml/libstdc++/2018-11/msg00017.html is integrated and
stabilized. The executors work being done for a future C++ standard will
provide standardized APIs for user programs. We don't want users to depend on
our internal APIs from an old experiment.