Bug 33491 - parallel v3: add some documentation
Summary: parallel v3: add some documentation
Status: ASSIGNED
Alias: None
Product: gcc
Classification: Unclassified
Component: libstdc++ (show other bugs)
Version: 4.3.0
: P3 normal
Target Milestone: ---
Assignee: Johannes Singler
URL:
Keywords: documentation
Depends on:
Blocks:
 
Reported: 2007-09-19 02:58 UTC by Wolfgang Bangerth
Modified: 2018-11-14 13:50 UTC (History)
5 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2007-11-15 10:05:14


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Wolfgang Bangerth 2007-09-19 02:58:31 UTC
It would be nice if there was a bit more documentation on parallel mode v3.
This could include some of Johannes' papers summarized here
  
http://algo2.iti.uni-karlsruhe.de/singler/mcstl/index.php?page=publications

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 then it would
be interesting to document them so that user programs could also use these
interfaces.

Thanks
 Wolfgang
Comment 1 Benjamin Kosnik 2007-10-09 20:51:30 UTC
We've made some progress on this front recently, although this bug is a useful marker for other documentation improvements.

-benjamin
Comment 2 Jonathan Wakely 2018-11-14 13:50:22 UTC
(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.