On Fri, 21 Jan 2022 16:12:58 -0800, Paul E. McKenney wrote:
> On Fri, Jan 21, 2022 at 09:29:24AM +0900, Akira Yokosawa wrote:
>> Not-signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx>
>> ---
>> Hi Paul,
>>
>> This is a reminder in sent as a patch.
>>
>> I find the indexing tag you put to "Non-Blocking" looks strange.
>> This entry talks about some classes of forward-progress guarantees,
>> not much about synchronization.
>> Also, the existing tags of NBS are \IXacr{}. You therefore
>> need to use \glsuseriii{nbs} as shown below in a separate entry
>> of "Non-Blocking Synchronization (NBS)".
>>
>> I think NBS deserves its own entry in the Glossary.
>>
>> Thanks, Akira
>>
>> --
>> glossary.tex | 4 +++-
>> 1 file changed, 3 insertions(+), 1 deletion(-)
>>
>> diff --git a/glossary.tex b/glossary.tex
>> index 86d9a025..4ea87f60 100644
>> --- a/glossary.tex
>> +++ b/glossary.tex
>> @@ -425,7 +425,7 @@
>> These are used for hardware-specific purposes such as profiling.
>> The advantage of using NMIs for profiling is that it allows you
>> to profile code that runs with interrupts disabled.
>> -\item[\IXGaltr{Non-Blocking}{Non-blocking synchronization (NBS)}:]
>> +\item[\IXG{Non-Blocking}:]
>> A group of academic forward-progress guarantees that includes
>> bounded population-oblivious wait free,
>> bounded wait free,
>> @@ -437,6 +437,8 @@
>> deadlock free.
>> See \cref{sec:advsync:Non-Blocking Synchronization}
>> for more information.
>> +\item[Non-Blocking Synchronization (NBS):]\glsuseriii{nbs}
>> + %@@@ Need expansion @@@
>> \item[NUCA:]\glsuseriii{nuca}
>> Non-uniform cache architecture, where groups of CPUs share
>> caches and/or store buffers.
>
> Good points!
>
> How about like this?
Looks good to me!
Thanks, Akira
>
> Thanx, Paul
>
> ------------------------------------------------------------------------
>
> commit a8152ff934df7cfaccb8bdc1fa376c5d11737995
> Author: Paul E. McKenney <paulmck@xxxxxxxxxx>
> Date: Fri Jan 21 16:11:09 2022 -0800
>
> glossary: Update non-blocking and add NBS
>
> Took index-addition commands from Akira's email dated January 20.
>
> Suggested-by: Akira Yokosawa <akiyks@xxxxxxxxx>
> Signed-off-by: Paul E. McKenney <paulmck@xxxxxxxxxx>
>
> diff --git a/glossary.tex b/glossary.tex
> index 86d9a025..1d4a2404 100644
> --- a/glossary.tex
> +++ b/glossary.tex
> @@ -425,7 +425,7 @@
> These are used for hardware-specific purposes such as profiling.
> The advantage of using NMIs for profiling is that it allows you
> to profile code that runs with interrupts disabled.
> -\item[\IXGaltr{Non-Blocking}{Non-blocking synchronization (NBS)}:]
> +\item[\IXG{Non-Blocking}:]
> A group of academic forward-progress guarantees that includes
> bounded population-oblivious wait free,
> bounded wait free,
> @@ -437,6 +437,13 @@
> deadlock free.
> See \cref{sec:advsync:Non-Blocking Synchronization}
> for more information.
> +\item[Non-Blocking Synchronization (NBS):]\glsuseriii{nbs}
> + The use of algorithms, mechanisms, or techniques that provide
> + non-blocking forward-progress guarantees.
> + NBS is often used in a more restrictive sense of providing one
> + of the stronger forward-progress guarantee, usually wait free or
> + lock free, but sometimes also obstruction free.
> + (See ``Non-blocking''.)
> \item[NUCA:]\glsuseriii{nuca}
> Non-uniform cache architecture, where groups of CPUs share
> caches and/or store buffers.
