<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<reference xml:id="functional.parallel" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Functional API</title>
 <partintro>
  <para>
   The <classname>parallel\Runtime</classname> API provides a great degree of control to the power PHP programmer, and those intimately familiar with writing applications that use
   parallel concurrency.
  </para>
  <para>
   The functional API provides less control in exchange for the ability to make decisions for the programmer:
   <itemizedlist>
    <listitem>
    <para>all executing runtimes are bootstrapped identically</para>
    </listitem>
    <listitem>
    <para>scheduling is determined by the API, not the programmer</para>
    </listitem>
   </itemizedlist>
   <function>parallel\run</function> provides the guarantee that the task will begin to execute in parallel as soon as allowed by hardware and operating system constraints, without
   needlessly creating runtimes. For most applications the functional API should be preferred.
  </para>
 </partintro>

 &reference.parallel.functions.parallel.bootstrap;
 &reference.parallel.functions.parallel.run;
</reference>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
