[PATCH v2] ref-manual: add potential of parallelism to defn of "Task"

[PATCH v2] ref-manual: add potential of parallelism to defn of "Task"

[Robert P. J. Day]

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst
index 32658051a..e5a7565df 100644
--- a/documentation/ref-manual/terms.rst
+++ b/documentation/ref-manual/terms.rst
@@ -367,10 +367,16 @@ universal, the list includes them just in case:
      section in the Yocto Project Overview and Concepts Manual.

    :term:`Task`
-      A unit of execution for BitBake (e.g.
+      A per-recipe unit of execution for BitBake (e.g.
       :ref:`ref-tasks-compile`,
       :ref:`ref-tasks-fetch`,
       :ref:`ref-tasks-patch`, and so forth).
+      One of the major benefits of the build system is that, since each
+      recipe will typically spawn the execution of numerous tasks,
+      it is entirely possible that many tasks can execute in parallel,
+      either tasks from separate recipes or independent tasks within
+      the same recipe, potentially up to the parallelism of your
+      build system.

    :term:`Toaster`
       A web interface to the Yocto Project's :term:`OpenEmbedded Build System`.

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                         http://crashcourse.ca

LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: [docs] [PATCH v2] ref-manual: add potential of parallelism to defn of "Task"

[Michael Opdenacker]

Hello again Robert,

On 9/6/21 4:00 PM, Robert P. J. Day wrote:
> Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>
>
> ---
>
> diff --git a/documentation/ref-manual/terms.rst b/documentation/ref-manual/terms.rst
> index 32658051a..e5a7565df 100644
> --- a/documentation/ref-manual/terms.rst
> +++ b/documentation/ref-manual/terms.rst
> @@ -367,10 +367,16 @@ universal, the list includes them just in case:
>       section in the Yocto Project Overview and Concepts Manual.
>
>     :term:`Task`
> -      A unit of execution for BitBake (e.g.
> +      A per-recipe unit of execution for BitBake (e.g.
>        :ref:`ref-tasks-compile`,
>        :ref:`ref-tasks-fetch`,
>        :ref:`ref-tasks-patch`, and so forth).
> +      One of the major benefits of the build system is that, since each
> +      recipe will typically spawn the execution of numerous tasks,
> +      it is entirely possible that many tasks can execute in parallel,
> +      either tasks from separate recipes or independent tasks within
> +      the same recipe, potentially up to the parallelism of your
> +      build system.
>
>     :term:`Toaster`
>        A web interface to the Yocto Project's :term:`OpenEmbedded Build System`.


Thanks for the patch.
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
and merged in "master-next".

Thanks again!
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com