<div dir="ltr">Hi, <div>Thanks again for your detailed explanation and review. I've sent in the new patch with the changes. Also writing 'qa' after visually selecting words by pressing v did not do anything. I also search the docs on <a href="http://vimdoc.sourceforge.net/htmldoc/editing.html">http://vimdoc.sourceforge.net/htmldoc/editing.html</a> but couldn't find anything. What is qa supposed to do? Is it related to formatting? </div><div><br></div><div>Please let me know.</div><div><br></div><div>Thanks,</div><div>Richi.</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Thu, Jun 18, 2020 at 10:42 PM Sebastian Huber <<a href="mailto:sebastian.huber@embedded-brains.de">sebastian.huber@embedded-brains.de</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 17/06/2020 14:13, Richi Dubey wrote:<br>
<br>
> ---<br>
>   c-user/glossary.rst | 29 +++++++++++++++++++++++++++++<br>
>   1 file changed, 29 insertions(+)<br>
><br>
> diff --git a/c-user/glossary.rst b/c-user/glossary.rst<br>
> index 86350a8..1d95f26 100644<br>
> --- a/c-user/glossary.rst<br>
> +++ b/c-user/glossary.rst<br>
> @@ -1,5 +1,6 @@<br>
>   .. SPDX-License-Identifier: CC-BY-SA-4.0<br>
>   <br>
> +.. Copyright (C) 2020 Richi Dubey (<a href="mailto:richidubey@gmail.com" target="_blank">richidubey@gmail.com</a>)<br>
>   .. Copyright (C) 2017, 2019 embedded brains GmbH (<a href="http://www.embedded-brains.de" rel="noreferrer" target="_blank">http://www.embedded-brains.de</a>)<br>
>   .. Copyright (C) 1988, 1998 On-Line Applications Research Corporation (OAR)<br>
>   <br>
> @@ -16,6 +17,13 @@ Glossary<br>
>           A term used to describe an object which has been created by an<br>
>           application.<br>
>   <br>
> +    APA<br>
> +        This term is an acronym for Arbitrary Processor Affinity.<br>
> +        In this model,<br>
Model of what?<br>
> a thread is allowed to have an arbitrary affinity to<br>
> +        the processor set, rather than a global mapping from one thread to all<br>
<br>
Maybe "a processor set"?<br>
<br>
I would say: rather than a restricted mapping to only one processor of <br>
the set or the ability to run on all processors of the set.<br>
<br>
> +        processors or one thread to one processor.<br>
> +        It has two variants, :term:`Weak APA` and :term:`Strong APA`.<br>
> +<br>
>       aperiodic task<br>
>           A task which must execute only at irregular intervals and has only a soft<br>
>           deadline.<br>
> @@ -777,6 +785,19 @@ Glossary<br>
>           :term:`return value` to indicate a successful operation or error<br>
>           conditions.<br>
>   <br>
> +    Strong APA<br>
> +        Strong APA is a specialization of :term:`APA`.<br>
> +        This variant of APA refers to a system model in which whenever a<br>
Is it really a system model?<br>
> +        :term:`thread` becomes ready for execution, recursively the processor<br>
> +        in the thread's affinity set is checked, followed by the processor in<br>
> +        the affinity set of threads that are assigned the processor present in<br>
> +        the ready thread's affinity set. This is done to find a thread to processor<br>
> +        mapping that does not violate the priority ordering and provide a schedule<br>
> +        with a higher total priority of the threads scheduled.<br>
> +        Similar analysis is done when a thread finishes its execution.<br>
Since you learn vim currently, maybe you can try to visually select this <br>
paragraph and then type "qa".<br>
> +<br>
> +     :cite:`Cerqueira:2014:LPA`<br>
Please use a sentence, for example "See also :cite:`Cerqueira:2014:LPA`".<br>
> +<br>
>       suspend<br>
>           A term used to describe a task that is not competing for the CPU because it<br>
>           has had a ``rtems_task_suspend`` directive.<br>
> @@ -905,6 +926,14 @@ Glossary<br>
>           Message queues, regions, and semaphores have a wait queue associated with<br>
>           them.<br>
>   <br>
> +    Weak APA<br>
> +        Weak APA is a specialization of :term:`APA`.<br>
> +        This refers to Linux's pull push implementation of APA model.<br>
push/pull or "push and pull"<br>
> +        A ready thread is scheduled when a processor in its affinity set is idle<br>
> +        or is executing a thread which is at a lower priority.<br>
Maybe mention that no threads are forced to migrate to find a processor.<br>
> +<br>
> +        :cite:`Cerqueira:2014:LPA`<br>
> +<br>
>       YAML<br>
>           This term is an acronym for `YAML Ain't Markup Language <<a href="https://yaml.org/" rel="noreferrer" target="_blank">https://yaml.org/</a>>`_.<br>
>   <br>
</blockquote></div>