[GIT PULL] Another round of qqz improvement

[GIT PULL] Another round of qqz improvement

[Akira Yokosawa]

Hi Paul,

This is another round of qqz improvement.
1st and 3rd patch improve vertical spacings in Appendix D.
2nd patch modifies the target of back link at the end of QQA
to the end of QQ in the main text.
This makes it easier to continue reading after reading an Answer.
The white box at the end of QQA is added recently, and its change
in behavior will cause little confusion if any, I think.

                                             Thanks, Akira

---
The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:

   Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)

are available in the git repository at:

   https://github.com/akiyks/perfbook.git qqz-use-vspace

for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:

   qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)

----------------------------------------------------------------
Akira Yokosawa (3):
       qqz: Use \vspace{} for vertical spacing in Appendix D.
       qqz: Modify back link target at end of QQA to end of QQ
       qqz: Give room for \parskip to suppress orphans

  qqz.sty | 22 +++++++++++++++++-----
  1 file changed, 17 insertions(+), 5 deletions(-)

Re: [GIT PULL] Another round of qqz improvement

[Paul E. McKenney]

On Thu, Jul 07, 2016 at 07:29:24AM +0900, Akira Yokosawa wrote:
> Hi Paul,
> 
> This is another round of qqz improvement.
> 1st and 3rd patch improve vertical spacings in Appendix D.
> 2nd patch modifies the target of back link at the end of QQA
> to the end of QQ in the main text.
> This makes it easier to continue reading after reading an Answer.
> The white box at the end of QQA is added recently, and its change
> in behavior will cause little confusion if any, I think.

Hello, Akira,

I applied the first and third, but skipped the second.  I tried it, but
couldn't help thinking that showing the quick quiz upon return might
help with continuity.  "What was I doing again?  Oh, right, I just came
back to the quick quiz on the page."

							Thanx, Paul

>                                             Thanks, Akira
> 
> ---
> The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:
> 
>   Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)
> 
> are available in the git repository at:
> 
>   https://github.com/akiyks/perfbook.git qqz-use-vspace
> 
> for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:
> 
>   qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)
> 
> ----------------------------------------------------------------
> Akira Yokosawa (3):
>       qqz: Use \vspace{} for vertical spacing in Appendix D.
>       qqz: Modify back link target at end of QQA to end of QQ
>       qqz: Give room for \parskip to suppress orphans
> 
>  qqz.sty | 22 +++++++++++++++++-----
>  1 file changed, 17 insertions(+), 5 deletions(-)
> 

Re: [GIT PULL] Another round of qqz improvement

[Akira Yokosawa]

On 2016/07/06 19:45:57 -0700, Paul E. McKenney wrote:
> On Thu, Jul 07, 2016 at 07:29:24AM +0900, Akira Yokosawa wrote:
>> Hi Paul,
>>
>> This is another round of qqz improvement.
>> 1st and 3rd patch improve vertical spacings in Appendix D.
>> 2nd patch modifies the target of back link at the end of QQA
>> to the end of QQ in the main text.
>> This makes it easier to continue reading after reading an Answer.
>> The white box at the end of QQA is added recently, and its change
>> in behavior will cause little confusion if any, I think.
>
> Hello, Akira,
>
> I applied the first and third, but skipped the second.  I tried it, but
> couldn't help thinking that showing the quick quiz upon return might
> help with continuity.  "What was I doing again?  Oh, right, I just came
> back to the quick quiz on the page."

I see. I respect your preference.
As a matter of fact, it took a few days for me to get used to the modified
behavior. When you expect the behavior, it would feel smoother especially
where a Quick Quiz is broken at the bottom of a left column in two column
format.

Anyway, I agree with you that current behavior is suitable as a default.

                                                  Thanks, Akira

>
> 							Thanx, Paul
>
>>                                             Thanks, Akira
>>
>> ---
>> The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:
>>
>>   Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)
>>
>> are available in the git repository at:
>>
>>   https://github.com/akiyks/perfbook.git qqz-use-vspace
>>
>> for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:
>>
>>   qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)
>>
>> ----------------------------------------------------------------
>> Akira Yokosawa (3):
>>       qqz: Use \vspace{} for vertical spacing in Appendix D.
>>       qqz: Modify back link target at end of QQA to end of QQ
>>       qqz: Give room for \parskip to suppress orphans
>>
>>  qqz.sty | 22 +++++++++++++++++-----
>>  1 file changed, 17 insertions(+), 5 deletions(-)
>>
>
>

Re: [GIT PULL] Another round of qqz improvement

[Paul E. McKenney]

On Thu, Jul 07, 2016 at 10:46:18PM +0900, Akira Yokosawa wrote:
> On 2016/07/06 19:45:57 -0700, Paul E. McKenney wrote:
> >On Thu, Jul 07, 2016 at 07:29:24AM +0900, Akira Yokosawa wrote:
> >>Hi Paul,
> >>
> >>This is another round of qqz improvement.
> >>1st and 3rd patch improve vertical spacings in Appendix D.
> >>2nd patch modifies the target of back link at the end of QQA
> >>to the end of QQ in the main text.
> >>This makes it easier to continue reading after reading an Answer.
> >>The white box at the end of QQA is added recently, and its change
> >>in behavior will cause little confusion if any, I think.
> >
> >Hello, Akira,
> >
> >I applied the first and third, but skipped the second.  I tried it, but
> >couldn't help thinking that showing the quick quiz upon return might
> >help with continuity.  "What was I doing again?  Oh, right, I just came
> >back to the quick quiz on the page."
> 
> I see. I respect your preference.
> As a matter of fact, it took a few days for me to get used to the modified
> behavior. When you expect the behavior, it would feel smoother especially
> where a Quick Quiz is broken at the bottom of a left column in two column
> format.
> 
> Anyway, I agree with you that current behavior is suitable as a default.

I do plan to do another release soon, and the release note will highlight
Paolo's and your work on this.  So let's see what the readers think!

							Thanx, Paul

> >>---
> >>The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:
> >>
> >>  Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)
> >>
> >>are available in the git repository at:
> >>
> >>  https://github.com/akiyks/perfbook.git qqz-use-vspace
> >>
> >>for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:
> >>
> >>  qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)
> >>
> >>----------------------------------------------------------------
> >>Akira Yokosawa (3):
> >>      qqz: Use \vspace{} for vertical spacing in Appendix D.
> >>      qqz: Modify back link target at end of QQA to end of QQ
> >>      qqz: Give room for \parskip to suppress orphans
> >>
> >> qqz.sty | 22 +++++++++++++++++-----
> >> 1 file changed, 17 insertions(+), 5 deletions(-)
> >>
> >
> >
> 

Re: [GIT PULL] Another round of qqz improvement

[Akira Yokosawa]

On 2016/07/08 3:52, Paul E. McKenney wrote:
> On Thu, Jul 07, 2016 at 10:46:18PM +0900, Akira Yokosawa wrote:
>> On 2016/07/06 19:45:57 -0700, Paul E. McKenney wrote:
>>> On Thu, Jul 07, 2016 at 07:29:24AM +0900, Akira Yokosawa wrote:
>>>> Hi Paul,
>>>>
>>>> This is another round of qqz improvement.
>>>> 1st and 3rd patch improve vertical spacings in Appendix D.
>>>> 2nd patch modifies the target of back link at the end of QQA
>>>> to the end of QQ in the main text.
>>>> This makes it easier to continue reading after reading an Answer.
>>>> The white box at the end of QQA is added recently, and its change
>>>> in behavior will cause little confusion if any, I think.
>>>
>>> Hello, Akira,
>>>
>>> I applied the first and third, but skipped the second.  I tried it, but
>>> couldn't help thinking that showing the quick quiz upon return might
>>> help with continuity.  "What was I doing again?  Oh, right, I just came
>>> back to the quick quiz on the page."
>>
>> I see. I respect your preference.
>> As a matter of fact, it took a few days for me to get used to the modified
>> behavior. When you expect the behavior, it would feel smoother especially
>> where a Quick Quiz is broken at the bottom of a left column in two column
>> format.
>>
>> Anyway, I agree with you that current behavior is suitable as a default.
>
> I do plan to do another release soon, and the release note will highlight
> Paolo's and your work on this.  So let's see what the readers think!

Oh, that would be of my great pleasure!

And how soon would the release be?
I'm preparing a (hopefully) final round of cosmetic fixes.
It's getting larger than I expected. I need to cleanup the commits to
distinguish actual fixes of something from just cosmetic ones so that you can
review them easily.  It may take another week or so.

                                                   Thanks, Akira
>
> 							Thanx, Paul
>
>>>> ---
>>>> The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:
>>>>
>>>>  Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)
>>>>
>>>> are available in the git repository at:
>>>>
>>>>  https://github.com/akiyks/perfbook.git qqz-use-vspace
>>>>
>>>> for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:
>>>>
>>>>  qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)
>>>>
>>>> ----------------------------------------------------------------
>>>> Akira Yokosawa (3):
>>>>      qqz: Use \vspace{} for vertical spacing in Appendix D.
>>>>      qqz: Modify back link target at end of QQA to end of QQ
>>>>      qqz: Give room for \parskip to suppress orphans
>>>>
>>>> qqz.sty | 22 +++++++++++++++++-----
>>>> 1 file changed, 17 insertions(+), 5 deletions(-)
>>>>
>>>
>>>
>>
>
>

Re: [GIT PULL] Another round of qqz improvement

[Paul E. McKenney]

On Sat, Jul 09, 2016 at 12:54:37AM +0900, Akira Yokosawa wrote:
> On 2016/07/08 3:52, Paul E. McKenney wrote:
> >On Thu, Jul 07, 2016 at 10:46:18PM +0900, Akira Yokosawa wrote:
> >>On 2016/07/06 19:45:57 -0700, Paul E. McKenney wrote:
> >>>On Thu, Jul 07, 2016 at 07:29:24AM +0900, Akira Yokosawa wrote:
> >>>>Hi Paul,
> >>>>
> >>>>This is another round of qqz improvement.
> >>>>1st and 3rd patch improve vertical spacings in Appendix D.
> >>>>2nd patch modifies the target of back link at the end of QQA
> >>>>to the end of QQ in the main text.
> >>>>This makes it easier to continue reading after reading an Answer.
> >>>>The white box at the end of QQA is added recently, and its change
> >>>>in behavior will cause little confusion if any, I think.
> >>>
> >>>Hello, Akira,
> >>>
> >>>I applied the first and third, but skipped the second.  I tried it, but
> >>>couldn't help thinking that showing the quick quiz upon return might
> >>>help with continuity.  "What was I doing again?  Oh, right, I just came
> >>>back to the quick quiz on the page."
> >>
> >>I see. I respect your preference.
> >>As a matter of fact, it took a few days for me to get used to the modified
> >>behavior. When you expect the behavior, it would feel smoother especially
> >>where a Quick Quiz is broken at the bottom of a left column in two column
> >>format.
> >>
> >>Anyway, I agree with you that current behavior is suitable as a default.
> >
> >I do plan to do another release soon, and the release note will highlight
> >Paolo's and your work on this.  So let's see what the readers think!
> 
> Oh, that would be of my great pleasure!
> 
> And how soon would the release be?

With luck, in a few days.  More likely in a few weeks.

> I'm preparing a (hopefully) final round of cosmetic fixes.
> It's getting larger than I expected. I need to cleanup the commits to
> distinguish actual fixes of something from just cosmetic ones so that you can
> review them easily.  It may take another week or so.

Well, unless the weekend's writing goes faster than normal (or, equivalently,
as fast as hoped), you should make the current release.  Otherwise, there
will be another release, hopefully much sooner than 18 months from now.

							Thanx, Paul

>                                                   Thanks, Akira
> >
> >							Thanx, Paul
> >
> >>>>---
> >>>>The following changes since commit 22af283e2a52cdf4a1c944fc97f00ce6a7a25ef8:
> >>>>
> >>>> Add diagnostics to route_rcu to reliably detect use-after-free (2016-07-05 15:52:16 -0700)
> >>>>
> >>>>are available in the git repository at:
> >>>>
> >>>> https://github.com/akiyks/perfbook.git qqz-use-vspace
> >>>>
> >>>>for you to fetch changes up to 746d78491c4dc47bcf72bfaf23724d568582d192:
> >>>>
> >>>> qqz: Give room for \parskip to suppress orphans (2016-07-07 07:07:17 +0900)
> >>>>
> >>>>----------------------------------------------------------------
> >>>>Akira Yokosawa (3):
> >>>>     qqz: Use \vspace{} for vertical spacing in Appendix D.
> >>>>     qqz: Modify back link target at end of QQA to end of QQ
> >>>>     qqz: Give room for \parskip to suppress orphans
> >>>>
> >>>>qqz.sty | 22 +++++++++++++++++-----
> >>>>1 file changed, 17 insertions(+), 5 deletions(-)
> >>>>
> >>>
> >>>
> >>
> >
> >
> 

Suggestion (was Re: [GIT PULL] Another round of qqz improvement)

[Akira Yokosawa]

On 2016/07/08 15:18:43 -0700, Paul E. McKenney wrote:
[snip]
>> And how soon would the release be?
>
> With luck, in a few days.  More likely in a few weeks.
>
>> I'm preparing a (hopefully) final round of cosmetic fixes.
>> It's getting larger than I expected. I need to cleanup the commits to
>> distinguish actual fixes of something from just cosmetic ones so that you can
>> review them easily.  It may take another week or so.
>
> Well, unless the weekend's writing goes faster than normal (or, equivalently,
> as fast as hoped), you should make the current release.  Otherwise, there
> will be another release, hopefully much sooner than 18 months from now.

Before I forget it, I noticed a small issue I don't plan to fix in the cosmetic
fixes.

In Section 1.1, there is no mention of Chapter 16.  You might want to add
a sentence there.

                                                    Thanks, Akira

Re: Suggestion (was Re: [GIT PULL] Another round of qqz improvement)

[Paul E. McKenney]

On Sat, Jul 09, 2016 at 10:44:25AM +0900, Akira Yokosawa wrote:
> On 2016/07/08 15:18:43 -0700, Paul E. McKenney wrote:
> [snip]
> >>And how soon would the release be?
> >
> >With luck, in a few days.  More likely in a few weeks.
> >
> >>I'm preparing a (hopefully) final round of cosmetic fixes.
> >>It's getting larger than I expected. I need to cleanup the commits to
> >>distinguish actual fixes of something from just cosmetic ones so that you can
> >>review them easily.  It may take another week or so.
> >
> >Well, unless the weekend's writing goes faster than normal (or, equivalently,
> >as fast as hoped), you should make the current release.  Otherwise, there
> >will be another release, hopefully much sooner than 18 months from now.
> 
> Before I forget it, I noticed a small issue I don't plan to fix in the cosmetic
> fixes.
> 
> In Section 1.1, there is no mention of Chapter 16.  You might want to add
> a sentence there.

Good catch!  I forgot to add the new real-time chapter.  Fixed with your
Reported-by.

							Thanx, Paul