On Thu, 16 Jan 2020 19:36:08 -0800, Paul E. McKenney wrote:
> On Fri, Jan 17, 2020 at 06:59:10AM +0900, Akira Yokosawa wrote:
>> >From cd352d3dfd20d8fcfdddafe5547ad191cbdda37e Mon Sep 17 00:00:00 2001
>> From: Akira Yokosawa <akiyks@xxxxxxxxx>
>> Date: Mon, 13 Jan 2020 16:18:19 +0900
>> Subject: [PATCH 2/3] howto: Fix typo
>>
>> Signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx>
>
> I took the other two, thank you very much!
>
> I treated this one as a bug report, again, thank you! Please see below
> for the corresponding commit. Thoughts?
Please find inline comments below.
>
> Thanx, Paul
>
>> ---
>> howto/howto.tex | 2 +-
>> 1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/howto/howto.tex b/howto/howto.tex
>> index bbdacbf1..fe80cca8 100644
>> --- a/howto/howto.tex
>> +++ b/howto/howto.tex
>> @@ -23,7 +23,7 @@ Parallel programming is not as hard as some say, and we hope
>> that this book makes your parallel-programming projects easier and
>> more fun.
>>
>> -In short, where parallel programming once focused on science, research,
>> +In short, while parallel programming once focused on science, research,
>> and grand-challenge projects, it is quickly becoming an engineering
>> discipline.
>> We therefore examine specific parallel-programming tasks
>> --
>> 2.17.1
>
> ------------------------------------------------------------------------
>
> commit b094718ddbe4256e606a41c660b4d4f1836baa66
> Author: Paul E. McKenney <paulmck@xxxxxxxxxx>
> Date: Thu Jan 16 19:31:26 2020 -0800
>
> howto: Word parallel-programming-as-engineering less obscurely
>
> The "where ... once ... becoming" wording might be legal English, it
> is a bit obscure and less than friendly to those whose native language
> is not English. This commit therefore rewrites the offending paragraph.
>
> Reported-by: Akira Yokosawa <akiyks@xxxxxxxxx>
> Signed-off-by: Paul E. McKenney <paulmck@xxxxxxxxxx>
>
> diff --git a/howto/howto.tex b/howto/howto.tex
> index bbdacbf..8a93774 100644
> --- a/howto/howto.tex
> +++ b/howto/howto.tex
> @@ -23,11 +23,12 @@ Parallel programming is not as hard as some say, and we hope
> that this book makes your parallel-programming projects easier and
> more fun.
>
> -In short, where parallel programming once focused on science, research,
> -and grand-challenge projects, it is quickly becoming an engineering
> -discipline.
> -We therefore examine specific parallel-programming tasks
> -and describe how to approach them.
> +In short, the focus of parallel programming is quickly shifting away
> +from science, research, and grand-challenge projects.
> +And this is all to the good, because it means that parallel programming
> +is finally becoming an engineering discipline.
> +Therefore, as befits an engineering discipline, this book examines
> +specific parallel-programming tasks and describes how to approach them.
> In some surprisingly common cases, they can even be automated.
Well, nowadays, you can try "google translate".
It recognizes the use of "where" as a subordinate conjunction in the
original paragraph.
I don't know why such a use case of "where" is not on my dictionary...
And saying "shifting away from" could be misleading because "science,
research, and grand-challenge projects" are still driving parallel
programming.
So maybe it might be better to revert this change, or to rephrase some more.
Thanks, Akira
>
> This book is written in the hope that presenting the engineering
>
