std.parallelism changes done

[Jonathan M Davis]

> On 3/24/2011 8:35 AM, spir wrote:
> > On 03/24/2011 05:32 AM, dsimcha wrote:
> >> [...]
> >> 
> >> The new docs are at
> >> http://cis.jhu.edu/~dsimcha/d/phobos/std_parallelism.html .
> > 
> > About the doc: very good. I could understand most of it, while knowing
> > nearly nothing about parallelism prior to reading.
> > 2 details:
> > * highlight key words only on first occurrence (bold online)
> > * wrong doc for Task.isPure (gets a copy of Tast.args' doc)
> > 
> > Denis
> 
> Task.isPure isn't even supposed to be public.  I didn't notice that it
> had slipped into the docs.  WTF, DDoc?

It's not really DDoc's fault. It's dmd's fault. Currently, _all_ templated 
_anything_ is public. _Period_. It doesn't matter what access level you 
actually give it. Task is a template. isPure is a member of Task, and you put 
ddoc comments on it. dmd wrongly thinks that it's public, so ddoc sees it as 
public and puts it in the generated docs. You need to use /+ instead of /++ or 
/* instead of /* so that the ddoc comment is not an actual ddoc comment.

I think that there are actually multiple bug reports on the issue, but here's 
one: http://d.puremagic.com/issues/show_bug.cgi?id=2775

- Jonathan M Davis