[m-rev.] For review: Document parallelism related features.

[Julien Fischer]

On Mon, 22 Mar 2010, Paul Bone wrote:

> > > @@ -7860,6 +7923,35 @@ or for backtrackable destructive update.
> > >  This option is only supported by the C back-ends.
> > >
> > >  @sp 1
> > > + at item @code{--parallel}
> > > + at findex --parallel
> > > + at cindex Parallel execution
> > > +In low-level C grades this enables support for parallel execution.
> > > +Parallel execution can be achieved by using either the parallel conjunction
> > > +operator or the concurrency support in the @samp{thread} module of the
> > > +standard library.
> > > + at xref{Goals, parallel conjunction, Goals, mercury_ref, The Mercury
> > > +Language Reference Manual}, and
> > > + at xref{thread, the thread module, thread, mercury_library, The Mercury
> > > +Library Reference Manual}.
> > > +
> > > +In high-level C grades this enables support for concurrency, which is
> > > +accessible via the @samp{thread} module in the standard library.
> > > +The runtime uses POSIX threads to achieve this, therefore it also supports
> > > +parallel execution.
> >
> > It may also support parallel execution of threads -- it wont't if I am
> > using a single core machine.
>
> The same goes for the asm_fast.gc.par grade, yet we say it enables parallel
> execution.  I've changed this as you've suggested but feel that it's being
> pedantic.

Pedantic?!? On this list? Never!

You can go ahead and commit this now.  Once the changes are included in
the ROTD you should annoucce the threadscope support on the webpage as
well.

Julien.
--------------------------------------------------------------------------
mercury-reviews mailing list
Post messages to:       mercury-reviews at csse.unimelb.edu.au
Administrative Queries: owner-mercury-reviews at csse.unimelb.edu.au
Subscriptions:          mercury-reviews-request at csse.unimelb.edu.au
--------------------------------------------------------------------------