* [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
@ 2020-03-21 2:24 Akira Yokosawa
2020-03-22 18:24 ` Paul E. McKenney
2020-03-26 15:04 ` [RFC PULL v2] Add experimental targets 'nq' and '1cnq' " Akira Yokosawa
0 siblings, 2 replies; 10+ messages in thread
From: Akira Yokosawa @ 2020-03-21 2:24 UTC (permalink / raw)
To: Paul E. McKenney; +Cc: perfbook, Akira Yokosawa
Hi Paul,
So this in an improved "noqq" relative to qqz.2020.03.17a.
It presents anchors to Appendix E in framed boxes.
To display essential quizzes inline, I added additional macros to be
used in the form of:
\EQuickQuiz{
quiz part
}\EQuickQuizAnswer{
answer part
}\EQuickQuizEnd
To improve the looks of consecutive quizzes, I further added macros
to be used for sequence of Quick Quizzes in the form of:
\QuickQuizSeries{%
\QuickQuizB{
quiz part 1
}\QuickQuizAnswerB{
answer part 1
}\QuickQuizEndB
%
\QuickQuizM{
quiz part 2
}\QuickQuizAnswerM{
answer part 2
}\QuickQuizEndM
%
\QuickQuizE{
quiz part 3
}\QuickQuizAnswerE{
answer part 3
}\QuickQuizEndE
} % end of \QuickQuizSeries
As a PoC, I applied schemes above to count/count.tex.
Does this amount of changes in .tex files look acceptable to you?
If you think they are acceptable, I'll do the changes in other consecutive
quick quizzes.
Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
"noqq" looks OK, though.
Any feedback is welcome!
Thanks, Akira
--
The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
are available in the Git repository at:
https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
----------------------------------------------------------------
Akira Yokosawa (3):
Add experimental target 'noqq' (sans inline Quick Quizzes)
Permit consecutive QQs to appear in a framed box
qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
Makefile | 5 +-
count/count.tex | 270 ++++++++++++++++++++++++++----------------------
perfbook.tex | 3 +
qqz.sty | 73 ++++++++++++-
utilities/extractqqz.sh | 8 +-
5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
2020-03-21 2:24 [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes) Akira Yokosawa
@ 2020-03-22 18:24 ` Paul E. McKenney
2020-03-25 15:19 ` Akira Yokosawa
2020-03-26 15:04 ` [RFC PULL v2] Add experimental targets 'nq' and '1cnq' " Akira Yokosawa
1 sibling, 1 reply; 10+ messages in thread
From: Paul E. McKenney @ 2020-03-22 18:24 UTC (permalink / raw)
To: Akira Yokosawa; +Cc: perfbook
On Sat, Mar 21, 2020 at 11:24:14AM +0900, Akira Yokosawa wrote:
> Hi Paul,
>
> So this in an improved "noqq" relative to qqz.2020.03.17a.
> It presents anchors to Appendix E in framed boxes.
>
> To display essential quizzes inline, I added additional macros to be
> used in the form of:
>
> \EQuickQuiz{
> quiz part
> }\EQuickQuizAnswer{
> answer part
> }\EQuickQuizEnd
>
>
> To improve the looks of consecutive quizzes, I further added macros
> to be used for sequence of Quick Quizzes in the form of:
>
> \QuickQuizSeries{%
> \QuickQuizB{
> quiz part 1
> }\QuickQuizAnswerB{
> answer part 1
> }\QuickQuizEndB
> %
> \QuickQuizM{
> quiz part 2
> }\QuickQuizAnswerM{
> answer part 2
> }\QuickQuizEndM
> %
> \QuickQuizE{
> quiz part 3
> }\QuickQuizAnswerE{
> answer part 3
> }\QuickQuizEndE
> } % end of \QuickQuizSeries
>
> As a PoC, I applied schemes above to count/count.tex.
> Does this amount of changes in .tex files look acceptable to you?
>
> If you think they are acceptable, I'll do the changes in other consecutive
> quick quizzes.
>
> Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
> "noqq" looks OK, though.
>
> Any feedback is welcome!
These are now on branch qqz.2020.03.22a, which is on top of the earlier
qqz.2020.03.17a.
I do like the comma-separated list of quick-quiz IDs for the -noqq
variant, and marking a few of the quizzes as "essential" makes sense.
I believe that the churn should be fine in this case. This does after
all at least partially address a long-standing complaint from a small
but noisy group of people. ;-)
Should the "hb" target also put boxes around the quick quizzes?
(I freely confess to having lost track of what most of the targets do!)
Thanx, Paul
> Thanks, Akira
> --
> The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
>
> qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
>
> are available in the Git repository at:
>
> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
>
> for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
>
> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
>
> ----------------------------------------------------------------
> Akira Yokosawa (3):
> Add experimental target 'noqq' (sans inline Quick Quizzes)
> Permit consecutive QQs to appear in a framed box
> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
>
> Makefile | 5 +-
> count/count.tex | 270 ++++++++++++++++++++++++++----------------------
> perfbook.tex | 3 +
> qqz.sty | 73 ++++++++++++-
> utilities/extractqqz.sh | 8 +-
> 5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
2020-03-22 18:24 ` Paul E. McKenney
@ 2020-03-25 15:19 ` Akira Yokosawa
2020-03-25 16:17 ` Paul E. McKenney
0 siblings, 1 reply; 10+ messages in thread
From: Akira Yokosawa @ 2020-03-25 15:19 UTC (permalink / raw)
To: Paul E. McKenney; +Cc: perfbook, Akira Yokosawa
On Sun, 22 Mar 2020 11:24:15 -0700, Paul E. McKenney wrote:
> On Sat, Mar 21, 2020 at 11:24:14AM +0900, Akira Yokosawa wrote:
>> Hi Paul,
>>
>> So this in an improved "noqq" relative to qqz.2020.03.17a.
>> It presents anchors to Appendix E in framed boxes.
>>
>> To display essential quizzes inline, I added additional macros to be
>> used in the form of:
>>
>> \EQuickQuiz{
>> quiz part
>> }\EQuickQuizAnswer{
>> answer part
>> }\EQuickQuizEnd
>>
>>
>> To improve the looks of consecutive quizzes, I further added macros
>> to be used for sequence of Quick Quizzes in the form of:
>>
>> \QuickQuizSeries{%
>> \QuickQuizB{
>> quiz part 1
>> }\QuickQuizAnswerB{
>> answer part 1
>> }\QuickQuizEndB
>> %
>> \QuickQuizM{
>> quiz part 2
>> }\QuickQuizAnswerM{
>> answer part 2
>> }\QuickQuizEndM
>> %
>> \QuickQuizE{
>> quiz part 3
>> }\QuickQuizAnswerE{
>> answer part 3
>> }\QuickQuizEndE
>> } % end of \QuickQuizSeries
>>
>> As a PoC, I applied schemes above to count/count.tex.
>> Does this amount of changes in .tex files look acceptable to you?
>>
>> If you think they are acceptable, I'll do the changes in other consecutive
>> quick quizzes.
>>
>> Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
>> "noqq" looks OK, though.
>>
>> Any feedback is welcome!
>
> These are now on branch qqz.2020.03.22a, which is on top of the earlier
> qqz.2020.03.17a.
>
> I do like the comma-separated list of quick-quiz IDs for the -noqq
> variant, and marking a few of the quizzes as "essential" makes sense.
>
> I believe that the churn should be fine in this case. This does after
> all at least partially address a long-standing complaint from a small
> but noisy group of people. ;-)
>
> Should the "hb" target also put boxes around the quick quizzes?
> (I freely confess to having lost track of what most of the targets do!)
Prompted by this question, I was looking into the -hb build.
It turned out that the change made in commit 648af1774e3a ("Stop using
modified book.cls") I submitted back in April 2018 broke the -hb build
in that pdflatex generates PDF having page size of normal letterpaper.
It looks like the letterpaperhb option needs to be in the modified
book.cls file.
As there was no complaint regarding this regression, I guess nobody
cares -hb build.
And I'm wondering how the -hb build is supposed to work.
Do you choose paper of 10.75in x 8.25in in printing -hb PDF?
Or do you use normal letterpaper and cut edges by 0.25in afterwords?
Thanks, Akira
>
> Thanx, Paul
>
>> Thanks, Akira
>> --
>> The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
>>
>> qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
>>
>> are available in the Git repository at:
>>
>> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
>>
>> for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
>>
>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
>>
>> ----------------------------------------------------------------
>> Akira Yokosawa (3):
>> Add experimental target 'noqq' (sans inline Quick Quizzes)
>> Permit consecutive QQs to appear in a framed box
>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
>>
>> Makefile | 5 +-
>> count/count.tex | 270 ++++++++++++++++++++++++++----------------------
>> perfbook.tex | 3 +
>> qqz.sty | 73 ++++++++++++-
>> utilities/extractqqz.sh | 8 +-
>> 5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
2020-03-25 15:19 ` Akira Yokosawa
@ 2020-03-25 16:17 ` Paul E. McKenney
2020-03-25 22:19 ` Akira Yokosawa
0 siblings, 1 reply; 10+ messages in thread
From: Paul E. McKenney @ 2020-03-25 16:17 UTC (permalink / raw)
To: Akira Yokosawa; +Cc: perfbook
On Thu, Mar 26, 2020 at 12:19:56AM +0900, Akira Yokosawa wrote:
> On Sun, 22 Mar 2020 11:24:15 -0700, Paul E. McKenney wrote:
> > On Sat, Mar 21, 2020 at 11:24:14AM +0900, Akira Yokosawa wrote:
> >> Hi Paul,
> >>
> >> So this in an improved "noqq" relative to qqz.2020.03.17a.
> >> It presents anchors to Appendix E in framed boxes.
> >>
> >> To display essential quizzes inline, I added additional macros to be
> >> used in the form of:
> >>
> >> \EQuickQuiz{
> >> quiz part
> >> }\EQuickQuizAnswer{
> >> answer part
> >> }\EQuickQuizEnd
> >>
> >>
> >> To improve the looks of consecutive quizzes, I further added macros
> >> to be used for sequence of Quick Quizzes in the form of:
> >>
> >> \QuickQuizSeries{%
> >> \QuickQuizB{
> >> quiz part 1
> >> }\QuickQuizAnswerB{
> >> answer part 1
> >> }\QuickQuizEndB
> >> %
> >> \QuickQuizM{
> >> quiz part 2
> >> }\QuickQuizAnswerM{
> >> answer part 2
> >> }\QuickQuizEndM
> >> %
> >> \QuickQuizE{
> >> quiz part 3
> >> }\QuickQuizAnswerE{
> >> answer part 3
> >> }\QuickQuizEndE
> >> } % end of \QuickQuizSeries
> >>
> >> As a PoC, I applied schemes above to count/count.tex.
> >> Does this amount of changes in .tex files look acceptable to you?
> >>
> >> If you think they are acceptable, I'll do the changes in other consecutive
> >> quick quizzes.
> >>
> >> Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
> >> "noqq" looks OK, though.
> >>
> >> Any feedback is welcome!
> >
> > These are now on branch qqz.2020.03.22a, which is on top of the earlier
> > qqz.2020.03.17a.
> >
> > I do like the comma-separated list of quick-quiz IDs for the -noqq
> > variant, and marking a few of the quizzes as "essential" makes sense.
> >
> > I believe that the churn should be fine in this case. This does after
> > all at least partially address a long-standing complaint from a small
> > but noisy group of people. ;-)
> >
> > Should the "hb" target also put boxes around the quick quizzes?
> > (I freely confess to having lost track of what most of the targets do!)
>
> Prompted by this question, I was looking into the -hb build.
> It turned out that the change made in commit 648af1774e3a ("Stop using
> modified book.cls") I submitted back in April 2018 broke the -hb build
> in that pdflatex generates PDF having page size of normal letterpaper.
>
> It looks like the letterpaperhb option needs to be in the modified
> book.cls file.
> As there was no complaint regarding this regression, I guess nobody
> cares -hb build.
The only time I might have used it was when creating the hardbound
version of the first edition.
> And I'm wondering how the -hb build is supposed to work.
>
> Do you choose paper of 10.75in x 8.25in in printing -hb PDF?
> Or do you use normal letterpaper and cut edges by 0.25in afterwords?
I will know (hopefully) in a few months, once I have the remaining
scalability results regenerated. It might well be different this time,
depending on what formatting options are available from whichever online
printing service.
So I might be asking for your assistance at that point, in the all too
likely event that I cannot figure it out on my own. ;-)
Thanx, Paul
> >> Thanks, Akira
> >> --
> >> The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
> >>
> >> qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
> >>
> >> are available in the Git repository at:
> >>
> >> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
> >>
> >> for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
> >>
> >> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
> >>
> >> ----------------------------------------------------------------
> >> Akira Yokosawa (3):
> >> Add experimental target 'noqq' (sans inline Quick Quizzes)
> >> Permit consecutive QQs to appear in a framed box
> >> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
> >>
> >> Makefile | 5 +-
> >> count/count.tex | 270 ++++++++++++++++++++++++++----------------------
> >> perfbook.tex | 3 +
> >> qqz.sty | 73 ++++++++++++-
> >> utilities/extractqqz.sh | 8 +-
> >> 5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
2020-03-25 16:17 ` Paul E. McKenney
@ 2020-03-25 22:19 ` Akira Yokosawa
2020-03-26 2:37 ` Paul E. McKenney
0 siblings, 1 reply; 10+ messages in thread
From: Akira Yokosawa @ 2020-03-25 22:19 UTC (permalink / raw)
To: Paul E. McKenney; +Cc: perfbook, Akira Yokosawa
On Wed, 25 Mar 2020 09:17:16 -0700, Paul E. McKenney wrote:
> On Thu, Mar 26, 2020 at 12:19:56AM +0900, Akira Yokosawa wrote:
>> On Sun, 22 Mar 2020 11:24:15 -0700, Paul E. McKenney wrote:
>>> On Sat, Mar 21, 2020 at 11:24:14AM +0900, Akira Yokosawa wrote:
>>>> Hi Paul,
>>>>
>>>> So this in an improved "noqq" relative to qqz.2020.03.17a.
>>>> It presents anchors to Appendix E in framed boxes.
>>>>
>>>> To display essential quizzes inline, I added additional macros to be
>>>> used in the form of:
>>>>
>>>> \EQuickQuiz{
>>>> quiz part
>>>> }\EQuickQuizAnswer{
>>>> answer part
>>>> }\EQuickQuizEnd
>>>>
>>>>
>>>> To improve the looks of consecutive quizzes, I further added macros
>>>> to be used for sequence of Quick Quizzes in the form of:
>>>>
>>>> \QuickQuizSeries{%
>>>> \QuickQuizB{
>>>> quiz part 1
>>>> }\QuickQuizAnswerB{
>>>> answer part 1
>>>> }\QuickQuizEndB
>>>> %
>>>> \QuickQuizM{
>>>> quiz part 2
>>>> }\QuickQuizAnswerM{
>>>> answer part 2
>>>> }\QuickQuizEndM
>>>> %
>>>> \QuickQuizE{
>>>> quiz part 3
>>>> }\QuickQuizAnswerE{
>>>> answer part 3
>>>> }\QuickQuizEndE
>>>> } % end of \QuickQuizSeries
>>>>
>>>> As a PoC, I applied schemes above to count/count.tex.
>>>> Does this amount of changes in .tex files look acceptable to you?
>>>>
>>>> If you think they are acceptable, I'll do the changes in other consecutive
>>>> quick quizzes.
>>>>
>>>> Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
>>>> "noqq" looks OK, though.
>>>>
>>>> Any feedback is welcome!
>>>
>>> These are now on branch qqz.2020.03.22a, which is on top of the earlier
>>> qqz.2020.03.17a.
>>>
>>> I do like the comma-separated list of quick-quiz IDs for the -noqq
>>> variant, and marking a few of the quizzes as "essential" makes sense.
>>>
>>> I believe that the churn should be fine in this case. This does after
>>> all at least partially address a long-standing complaint from a small
>>> but noisy group of people. ;-)
>>>
>>> Should the "hb" target also put boxes around the quick quizzes?
>>> (I freely confess to having lost track of what most of the targets do!)
>>
>> Prompted by this question, I was looking into the -hb build.
>> It turned out that the change made in commit 648af1774e3a ("Stop using
>> modified book.cls") I submitted back in April 2018 broke the -hb build
>> in that pdflatex generates PDF having page size of normal letterpaper.
>>
>> It looks like the letterpaperhb option needs to be in the modified
>> book.cls file.
>> As there was no complaint regarding this regression, I guess nobody
>> cares -hb build.
>
> The only time I might have used it was when creating the hardbound
> version of the first edition.
>
>> And I'm wondering how the -hb build is supposed to work.
>>
>> Do you choose paper of 10.75in x 8.25in in printing -hb PDF?
>> Or do you use normal letterpaper and cut edges by 0.25in afterwords?
>
> I will know (hopefully) in a few months, once I have the remaining
> scalability results regenerated. It might well be different this time,
> depending on what formatting options are available from whichever online
> printing service.
Ah, I see.
>
> So I might be asking for your assistance at that point, in the all too
> likely event that I cannot figure it out on my own. ;-)
So, I'll see what would be a proper way to add a customized paper size.
As for the addition of Quick Quiz annotation, one of your recent updates
conflicts with my working branch.
So please wait a while for another "[RFC NOT PULL]".
Thanks, Akira
>
>
> Thanx, Paul
>
>>>> Thanks, Akira
>>>> --
>>>> The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
>>>>
>>>> qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
>>>>
>>>> are available in the Git repository at:
>>>>
>>>> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
>>>>
>>>> for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
>>>>
>>>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
>>>>
>>>> ----------------------------------------------------------------
>>>> Akira Yokosawa (3):
>>>> Add experimental target 'noqq' (sans inline Quick Quizzes)
>>>> Permit consecutive QQs to appear in a framed box
>>>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
>>>>
>>>> Makefile | 5 +-
>>>> count/count.tex | 270 ++++++++++++++++++++++++++----------------------
>>>> perfbook.tex | 3 +
>>>> qqz.sty | 73 ++++++++++++-
>>>> utilities/extractqqz.sh | 8 +-
>>>> 5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes)
2020-03-25 22:19 ` Akira Yokosawa
@ 2020-03-26 2:37 ` Paul E. McKenney
0 siblings, 0 replies; 10+ messages in thread
From: Paul E. McKenney @ 2020-03-26 2:37 UTC (permalink / raw)
To: Akira Yokosawa; +Cc: perfbook
On Thu, Mar 26, 2020 at 07:19:04AM +0900, Akira Yokosawa wrote:
> On Wed, 25 Mar 2020 09:17:16 -0700, Paul E. McKenney wrote:
> > On Thu, Mar 26, 2020 at 12:19:56AM +0900, Akira Yokosawa wrote:
> >> On Sun, 22 Mar 2020 11:24:15 -0700, Paul E. McKenney wrote:
> >>> On Sat, Mar 21, 2020 at 11:24:14AM +0900, Akira Yokosawa wrote:
> >>>> Hi Paul,
> >>>>
> >>>> So this in an improved "noqq" relative to qqz.2020.03.17a.
> >>>> It presents anchors to Appendix E in framed boxes.
> >>>>
> >>>> To display essential quizzes inline, I added additional macros to be
> >>>> used in the form of:
> >>>>
> >>>> \EQuickQuiz{
> >>>> quiz part
> >>>> }\EQuickQuizAnswer{
> >>>> answer part
> >>>> }\EQuickQuizEnd
> >>>>
> >>>>
> >>>> To improve the looks of consecutive quizzes, I further added macros
> >>>> to be used for sequence of Quick Quizzes in the form of:
> >>>>
> >>>> \QuickQuizSeries{%
> >>>> \QuickQuizB{
> >>>> quiz part 1
> >>>> }\QuickQuizAnswerB{
> >>>> answer part 1
> >>>> }\QuickQuizEndB
> >>>> %
> >>>> \QuickQuizM{
> >>>> quiz part 2
> >>>> }\QuickQuizAnswerM{
> >>>> answer part 2
> >>>> }\QuickQuizEndM
> >>>> %
> >>>> \QuickQuizE{
> >>>> quiz part 3
> >>>> }\QuickQuizAnswerE{
> >>>> answer part 3
> >>>> }\QuickQuizEndE
> >>>> } % end of \QuickQuizSeries
> >>>>
> >>>> As a PoC, I applied schemes above to count/count.tex.
> >>>> Does this amount of changes in .tex files look acceptable to you?
> >>>>
> >>>> If you think they are acceptable, I'll do the changes in other consecutive
> >>>> quick quizzes.
> >>>>
> >>>> Futher tuning of noqq's look can be done by tweaking qqz.sty. I think
> >>>> "noqq" looks OK, though.
> >>>>
> >>>> Any feedback is welcome!
> >>>
> >>> These are now on branch qqz.2020.03.22a, which is on top of the earlier
> >>> qqz.2020.03.17a.
> >>>
> >>> I do like the comma-separated list of quick-quiz IDs for the -noqq
> >>> variant, and marking a few of the quizzes as "essential" makes sense.
> >>>
> >>> I believe that the churn should be fine in this case. This does after
> >>> all at least partially address a long-standing complaint from a small
> >>> but noisy group of people. ;-)
> >>>
> >>> Should the "hb" target also put boxes around the quick quizzes?
> >>> (I freely confess to having lost track of what most of the targets do!)
> >>
> >> Prompted by this question, I was looking into the -hb build.
> >> It turned out that the change made in commit 648af1774e3a ("Stop using
> >> modified book.cls") I submitted back in April 2018 broke the -hb build
> >> in that pdflatex generates PDF having page size of normal letterpaper.
> >>
> >> It looks like the letterpaperhb option needs to be in the modified
> >> book.cls file.
> >> As there was no complaint regarding this regression, I guess nobody
> >> cares -hb build.
> >
> > The only time I might have used it was when creating the hardbound
> > version of the first edition.
> >
> >> And I'm wondering how the -hb build is supposed to work.
> >>
> >> Do you choose paper of 10.75in x 8.25in in printing -hb PDF?
> >> Or do you use normal letterpaper and cut edges by 0.25in afterwords?
> >
> > I will know (hopefully) in a few months, once I have the remaining
> > scalability results regenerated. It might well be different this time,
> > depending on what formatting options are available from whichever online
> > printing service.
>
> Ah, I see.
>
> >
> > So I might be asking for your assistance at that point, in the all too
> > likely event that I cannot figure it out on my own. ;-)
>
> So, I'll see what would be a proper way to add a customized paper size.
>
> As for the addition of Quick Quiz annotation, one of your recent updates
> conflicts with my working branch.
>
> So please wait a while for another "[RFC NOT PULL]".
Or just send me the pull request and tell me which commit it is against.
Then let me sort out the merge-conflict breakage. I do have significant
practice with this sort of task. ;-)
Thanx, Paul
> >>>> Thanks, Akira
> >>>> --
> >>>> The following changes since commit 01dcc70d3f66a1224ba63dc50bbe8370d3711c1b:
> >>>>
> >>>> qqz.sty: Add background color to Quiz part of Quick Quizzes (2020-03-17 20:24:09 +0900)
> >>>>
> >>>> are available in the Git repository at:
> >>>>
> >>>> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.21a
> >>>>
> >>>> for you to fetch changes up to 77e161e26d37453b751429799fd3c8b49cf7e0c9:
> >>>>
> >>>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's (2020-03-21 10:53:16 +0900)
> >>>>
> >>>> ----------------------------------------------------------------
> >>>> Akira Yokosawa (3):
> >>>> Add experimental target 'noqq' (sans inline Quick Quizzes)
> >>>> Permit consecutive QQs to appear in a framed box
> >>>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
> >>>>
> >>>> Makefile | 5 +-
> >>>> count/count.tex | 270 ++++++++++++++++++++++++++----------------------
> >>>> perfbook.tex | 3 +
> >>>> qqz.sty | 73 ++++++++++++-
> >>>> utilities/extractqqz.sh | 8 +-
> >>>> 5 files changed, 231 insertions(+), 128 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* [RFC PULL v2] Add experimental targets 'nq' and '1cnq' (sans inline Quick Quizzes)
2020-03-21 2:24 [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes) Akira Yokosawa
2020-03-22 18:24 ` Paul E. McKenney
@ 2020-03-26 15:04 ` Akira Yokosawa
2020-03-26 16:05 ` Paul E. McKenney
1 sibling, 1 reply; 10+ messages in thread
From: Akira Yokosawa @ 2020-03-26 15:04 UTC (permalink / raw)
To: Paul E. McKenney; +Cc: perfbook, Akira Yokosawa
Hi Paul,
This is the rebased pull request of "noqq" branch.
The conflict was easy to resolve.
I added several commits since v1 (was [RFC NOT PULL]).
As this branch does not change any behavior of official targets,
I think it is safe for you to pull if you'd like to.
Changes since v1:
Target name changes and additions:
- qq: 2c with framed Quick Quizzes (was 2cqq)
- 1cqq: 1c with framed Quick Quizzes
- nq: 2c without inline Quick Quizzes (was noqq)
- 1cnq: 1c without inline Quick Quizzes
Note: Existing targets for 2c layout do not have
"2c" except for the default "2c".
Accuracy fix of cross links to framed Quick Quizzes
Treewide annotation of Quick Quizzes for nq build
Target names updates in synctex-forward.sh
Minor fixes in Quick Quizzes 5.49 and 5.52
Try "make help" to see which target does what.
Thanks, Akira
PS:
As for -hb build, I've found a clue to use "geometry" package as a
workaround. It looks promising.
Enabling qqzbg at release tags for official targets is next in my
todo list.
--
The following changes since commit dcb1d4e43b2c1edba5a61bd0e63e0804478bf520:
toolsoftrade: Improve rwlockscale.sh sampling strategy (2020-03-25 07:14:47 -0700)
are available in the Git repository at:
https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.26a
for you to fetch changes up to 1dd2b89ab3e7bb64a380d7ccef7033757dd442ef:
Makefile: Add and rename targets for framed and no Quick Quizzes (2020-03-26 23:23:10 +0900)
----------------------------------------------------------------
Akira Yokosawa (10):
qqz.sty: Add background color to Quiz part of Quick Quizzes
Add experimental target 'noqq' (sans inline Quick Quizzes)
Permit consecutive QQs to appear in a framed box
qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
qqz.sty: Improve accuracy of cross links
treewide: Use macros for consecutive quick quizzes
synctex-forward: Add recently added targets
qqz.sty: Add comment on how to use new sets of macros
count: Wordsmith Quick Quizzes 5.49 and 5.52
Makefile: Add and rename targets for framed and no Quick Quizzes
Makefile | 34 ++++-
SMPdesign/SMPdesign.tex | 16 +-
SMPdesign/partexercises.tex | 32 ++--
advsync/rt.tex | 16 +-
appendix/toyrcu/toyrcu.tex | 88 ++++++-----
appendix/whymb/whymemorybarriers.tex | 40 ++---
count/count.tex | 277 +++++++++++++++++++----------------
cpu/overheads.tex | 16 +-
datastruct/datastruct.tex | 16 +-
debugging/debugging.tex | 72 +++++----
defer/hazptr.tex | 16 +-
defer/rcuapi.tex | 32 ++--
defer/rcuexercises.tex | 17 ++-
defer/rcufundamental.tex | 16 +-
defer/rcuintro.tex | 32 ++--
defer/rcuusage.tex | 32 ++--
defer/refcnt.tex | 16 +-
defer/seqlock.tex | 40 ++---
formal/axiomatic.tex | 16 +-
formal/dyntickrcu.tex | 48 +++---
formal/ppcmem.tex | 14 +-
formal/spinhint.tex | 33 +++--
future/formalregress.tex | 32 ++--
future/htm.tex | 24 +--
howto/howto.tex | 24 +--
intro/intro.tex | 32 ++--
locking/locking-existence.tex | 16 +-
locking/locking.tex | 48 +++---
memorder/memorder.tex | 96 ++++++------
owned/owned.tex | 16 +-
perfbook.tex | 7 +
qqz.sty | 133 ++++++++++++++++-
together/refcnt.tex | 24 +--
toolsoftrade/toolsoftrade.tex | 104 +++++++------
utilities/extractqqz.sh | 8 +-
utilities/synctex-forward.sh | 2 +-
36 files changed, 892 insertions(+), 593 deletions(-)
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC PULL v2] Add experimental targets 'nq' and '1cnq' (sans inline Quick Quizzes)
2020-03-26 15:04 ` [RFC PULL v2] Add experimental targets 'nq' and '1cnq' " Akira Yokosawa
@ 2020-03-26 16:05 ` Paul E. McKenney
2020-03-26 22:56 ` Akira Yokosawa
0 siblings, 1 reply; 10+ messages in thread
From: Paul E. McKenney @ 2020-03-26 16:05 UTC (permalink / raw)
To: Akira Yokosawa; +Cc: perfbook
On Fri, Mar 27, 2020 at 12:04:52AM +0900, Akira Yokosawa wrote:
> Hi Paul,
>
> This is the rebased pull request of "noqq" branch.
> The conflict was easy to resolve.
> I added several commits since v1 (was [RFC NOT PULL]).
>
> As this branch does not change any behavior of official targets,
> I think it is safe for you to pull if you'd like to.
>
> Changes since v1:
>
> Target name changes and additions:
> - qq: 2c with framed Quick Quizzes (was 2cqq)
> - 1cqq: 1c with framed Quick Quizzes
> - nq: 2c without inline Quick Quizzes (was noqq)
> - 1cnq: 1c without inline Quick Quizzes
>
> Note: Existing targets for 2c layout do not have
> "2c" except for the default "2c".
>
> Accuracy fix of cross links to framed Quick Quizzes
>
> Treewide annotation of Quick Quizzes for nq build
>
> Target names updates in synctex-forward.sh
>
> Minor fixes in Quick Quizzes 5.49 and 5.52
>
> Try "make help" to see which target does what.
That "make help" is great, thank you very much!!!
I believe that the new options for quick quizzes will be quite useful
as well.
I have pulled this and pushed out the result.
A few questions on "make help":
o Why no .pdf on the perfbook-qq, perfbook-1cqq, perfbook-nq,
perfbook-1cnq, and perfbook-tcb full-length targets?
o Would it make sense to just say prepending "1c" gets you
single-column output unless otherwise stated? Doing this
would shorten the output by quite a bit.
o Can some of the old defaults be retired? For example,
perfbook-tcb, perfbook-msns.pdf, and perfbook-mss.pdf?
o Would it make sense for "make help" to omit the experimental
targets, with something like "make fullhelp" printing the
current list? The last line of "make help" might point to
"make fullhelp" (or whatever you decide to call it) so that
people can easily get at the full list.
And a question on quick quizzes. This is a real question that I have
not really thought about, so I have no idea what makes sense here.
Would it be reasonable to have a "textbook" or "academic" build target
that collected the non-essential quick quizzes at the end of each chapter,
omitting them from the text (though maybe leaving a marker as nq currently
does, or not, I have no idea)? If this does make sense, it would probably
be necesary to place a new macro at the end of each quick-quiz chapter.
Thoughts?
Thanx, Paul
> Thanks, Akira
>
> PS:
>
> As for -hb build, I've found a clue to use "geometry" package as a
> workaround. It looks promising.
>
> Enabling qqzbg at release tags for official targets is next in my
> todo list.
>
> --
> The following changes since commit dcb1d4e43b2c1edba5a61bd0e63e0804478bf520:
>
> toolsoftrade: Improve rwlockscale.sh sampling strategy (2020-03-25 07:14:47 -0700)
>
> are available in the Git repository at:
>
> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.26a
>
> for you to fetch changes up to 1dd2b89ab3e7bb64a380d7ccef7033757dd442ef:
>
> Makefile: Add and rename targets for framed and no Quick Quizzes (2020-03-26 23:23:10 +0900)
>
> ----------------------------------------------------------------
> Akira Yokosawa (10):
> qqz.sty: Add background color to Quiz part of Quick Quizzes
> Add experimental target 'noqq' (sans inline Quick Quizzes)
> Permit consecutive QQs to appear in a framed box
> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
> qqz.sty: Improve accuracy of cross links
> treewide: Use macros for consecutive quick quizzes
> synctex-forward: Add recently added targets
> qqz.sty: Add comment on how to use new sets of macros
> count: Wordsmith Quick Quizzes 5.49 and 5.52
> Makefile: Add and rename targets for framed and no Quick Quizzes
>
> Makefile | 34 ++++-
> SMPdesign/SMPdesign.tex | 16 +-
> SMPdesign/partexercises.tex | 32 ++--
> advsync/rt.tex | 16 +-
> appendix/toyrcu/toyrcu.tex | 88 ++++++-----
> appendix/whymb/whymemorybarriers.tex | 40 ++---
> count/count.tex | 277 +++++++++++++++++++----------------
> cpu/overheads.tex | 16 +-
> datastruct/datastruct.tex | 16 +-
> debugging/debugging.tex | 72 +++++----
> defer/hazptr.tex | 16 +-
> defer/rcuapi.tex | 32 ++--
> defer/rcuexercises.tex | 17 ++-
> defer/rcufundamental.tex | 16 +-
> defer/rcuintro.tex | 32 ++--
> defer/rcuusage.tex | 32 ++--
> defer/refcnt.tex | 16 +-
> defer/seqlock.tex | 40 ++---
> formal/axiomatic.tex | 16 +-
> formal/dyntickrcu.tex | 48 +++---
> formal/ppcmem.tex | 14 +-
> formal/spinhint.tex | 33 +++--
> future/formalregress.tex | 32 ++--
> future/htm.tex | 24 +--
> howto/howto.tex | 24 +--
> intro/intro.tex | 32 ++--
> locking/locking-existence.tex | 16 +-
> locking/locking.tex | 48 +++---
> memorder/memorder.tex | 96 ++++++------
> owned/owned.tex | 16 +-
> perfbook.tex | 7 +
> qqz.sty | 133 ++++++++++++++++-
> together/refcnt.tex | 24 +--
> toolsoftrade/toolsoftrade.tex | 104 +++++++------
> utilities/extractqqz.sh | 8 +-
> utilities/synctex-forward.sh | 2 +-
> 36 files changed, 892 insertions(+), 593 deletions(-)
>
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC PULL v2] Add experimental targets 'nq' and '1cnq' (sans inline Quick Quizzes)
2020-03-26 16:05 ` Paul E. McKenney
@ 2020-03-26 22:56 ` Akira Yokosawa
2020-03-27 0:11 ` Paul E. McKenney
0 siblings, 1 reply; 10+ messages in thread
From: Akira Yokosawa @ 2020-03-26 22:56 UTC (permalink / raw)
To: Paul E. McKenney; +Cc: perfbook, Akira Yokosawa
On Thu, 26 Mar 2020 09:05:51 -0700, Paul E. McKenney wrote:
> On Fri, Mar 27, 2020 at 12:04:52AM +0900, Akira Yokosawa wrote:
>> Hi Paul,
>>
>> This is the rebased pull request of "noqq" branch.
>> The conflict was easy to resolve.
>> I added several commits since v1 (was [RFC NOT PULL]).
>>
>> As this branch does not change any behavior of official targets,
>> I think it is safe for you to pull if you'd like to.
>>
>> Changes since v1:
>>
>> Target name changes and additions:
>> - qq: 2c with framed Quick Quizzes (was 2cqq)
>> - 1cqq: 1c with framed Quick Quizzes
>> - nq: 2c without inline Quick Quizzes (was noqq)
>> - 1cnq: 1c without inline Quick Quizzes
>>
>> Note: Existing targets for 2c layout do not have
>> "2c" except for the default "2c".
>>
>> Accuracy fix of cross links to framed Quick Quizzes
>>
>> Treewide annotation of Quick Quizzes for nq build
>>
>> Target names updates in synctex-forward.sh
>>
>> Minor fixes in Quick Quizzes 5.49 and 5.52
>>
>> Try "make help" to see which target does what.
>
> That "make help" is great, thank you very much!!!
>
> I believe that the new options for quick quizzes will be quite useful
> as well.
>
> I have pulled this and pushed out the result.
Thanks!
>
> A few questions on "make help":
>
> o Why no .pdf on the perfbook-qq, perfbook-1cqq, perfbook-nq,
> perfbook-1cnq, and perfbook-tcb full-length targets?
Umm, I'll fix them soon.
>
> o Would it make sense to just say prepending "1c" gets you
> single-column output unless otherwise stated? Doing this
> would shorten the output by quite a bit.
Unfortunately, prepending "1c" doesn't work at the moment.
E.g. "1chb" or "1cmsnt" doesn't work.
I _guess_ such restructuring of target rules might be possible
without adding every rule in the Makefile.
>
> o Can some of the old defaults be retired? For example,
> perfbook-tcb, perfbook-msns.pdf, and perfbook-mss.pdf?
>
Maybe.
They can be useful in testing the portability of .tex code base
by using fonts of different width and detecting minor issues such
as orphan headings.
> o Would it make sense for "make help" to omit the experimental
> targets, with something like "make fullhelp" printing the
> current list? The last line of "make help" might point to
> "make fullhelp" (or whatever you decide to call it) so that
> people can easily get at the full list.
Good point!
It would be much better than the official targets scrolled away.
I'll give it a try.
>
> And a question on quick quizzes. This is a real question that I have
> not really thought about, so I have no idea what makes sense here.
> Would it be reasonable to have a "textbook" or "academic" build target
> that collected the non-essential quick quizzes at the end of each chapter,
> omitting them from the text (though maybe leaving a marker as nq currently
> does, or not, I have no idea)? If this does make sense, it would probably
> be necesary to place a new macro at the end of each quick-quiz chapter.
>
> Thoughts?
This would involve splitting qqz.tex into chapter-wise .tex files, which
should be possible.
Most important thing you'd need is to make those question parts
independent of context in the text.
Quite a few questions look dependent on where they are.
Also, we need to pick essential quizzes or rephrase the text around them.
This requires us to review the story line of the whole text in the "nq"
build.
So the addition of such a framework would be the easy part,
improving the text would be much time consuming, I guess.
Thanks, Akira
>
> Thanx, Paul
>
>> Thanks, Akira
>>
>> PS:
>>
>> As for -hb build, I've found a clue to use "geometry" package as a
>> workaround. It looks promising.
>>
>> Enabling qqzbg at release tags for official targets is next in my
>> todo list.
>>
>> --
>> The following changes since commit dcb1d4e43b2c1edba5a61bd0e63e0804478bf520:
>>
>> toolsoftrade: Improve rwlockscale.sh sampling strategy (2020-03-25 07:14:47 -0700)
>>
>> are available in the Git repository at:
>>
>> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.26a
>>
>> for you to fetch changes up to 1dd2b89ab3e7bb64a380d7ccef7033757dd442ef:
>>
>> Makefile: Add and rename targets for framed and no Quick Quizzes (2020-03-26 23:23:10 +0900)
>>
>> ----------------------------------------------------------------
>> Akira Yokosawa (10):
>> qqz.sty: Add background color to Quiz part of Quick Quizzes
>> Add experimental target 'noqq' (sans inline Quick Quizzes)
>> Permit consecutive QQs to appear in a framed box
>> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
>> qqz.sty: Improve accuracy of cross links
>> treewide: Use macros for consecutive quick quizzes
>> synctex-forward: Add recently added targets
>> qqz.sty: Add comment on how to use new sets of macros
>> count: Wordsmith Quick Quizzes 5.49 and 5.52
>> Makefile: Add and rename targets for framed and no Quick Quizzes
>>
>> Makefile | 34 ++++-
>> SMPdesign/SMPdesign.tex | 16 +-
>> SMPdesign/partexercises.tex | 32 ++--
>> advsync/rt.tex | 16 +-
>> appendix/toyrcu/toyrcu.tex | 88 ++++++-----
>> appendix/whymb/whymemorybarriers.tex | 40 ++---
>> count/count.tex | 277 +++++++++++++++++++----------------
>> cpu/overheads.tex | 16 +-
>> datastruct/datastruct.tex | 16 +-
>> debugging/debugging.tex | 72 +++++----
>> defer/hazptr.tex | 16 +-
>> defer/rcuapi.tex | 32 ++--
>> defer/rcuexercises.tex | 17 ++-
>> defer/rcufundamental.tex | 16 +-
>> defer/rcuintro.tex | 32 ++--
>> defer/rcuusage.tex | 32 ++--
>> defer/refcnt.tex | 16 +-
>> defer/seqlock.tex | 40 ++---
>> formal/axiomatic.tex | 16 +-
>> formal/dyntickrcu.tex | 48 +++---
>> formal/ppcmem.tex | 14 +-
>> formal/spinhint.tex | 33 +++--
>> future/formalregress.tex | 32 ++--
>> future/htm.tex | 24 +--
>> howto/howto.tex | 24 +--
>> intro/intro.tex | 32 ++--
>> locking/locking-existence.tex | 16 +-
>> locking/locking.tex | 48 +++---
>> memorder/memorder.tex | 96 ++++++------
>> owned/owned.tex | 16 +-
>> perfbook.tex | 7 +
>> qqz.sty | 133 ++++++++++++++++-
>> together/refcnt.tex | 24 +--
>> toolsoftrade/toolsoftrade.tex | 104 +++++++------
>> utilities/extractqqz.sh | 8 +-
>> utilities/synctex-forward.sh | 2 +-
>> 36 files changed, 892 insertions(+), 593 deletions(-)
>>
^ permalink raw reply [flat|nested] 10+ messages in thread
* Re: [RFC PULL v2] Add experimental targets 'nq' and '1cnq' (sans inline Quick Quizzes)
2020-03-26 22:56 ` Akira Yokosawa
@ 2020-03-27 0:11 ` Paul E. McKenney
0 siblings, 0 replies; 10+ messages in thread
From: Paul E. McKenney @ 2020-03-27 0:11 UTC (permalink / raw)
To: Akira Yokosawa; +Cc: perfbook
On Fri, Mar 27, 2020 at 07:56:39AM +0900, Akira Yokosawa wrote:
> On Thu, 26 Mar 2020 09:05:51 -0700, Paul E. McKenney wrote:
> > On Fri, Mar 27, 2020 at 12:04:52AM +0900, Akira Yokosawa wrote:
> >> Hi Paul,
> >>
> >> This is the rebased pull request of "noqq" branch.
> >> The conflict was easy to resolve.
> >> I added several commits since v1 (was [RFC NOT PULL]).
> >>
> >> As this branch does not change any behavior of official targets,
> >> I think it is safe for you to pull if you'd like to.
> >>
> >> Changes since v1:
> >>
> >> Target name changes and additions:
> >> - qq: 2c with framed Quick Quizzes (was 2cqq)
> >> - 1cqq: 1c with framed Quick Quizzes
> >> - nq: 2c without inline Quick Quizzes (was noqq)
> >> - 1cnq: 1c without inline Quick Quizzes
> >>
> >> Note: Existing targets for 2c layout do not have
> >> "2c" except for the default "2c".
> >>
> >> Accuracy fix of cross links to framed Quick Quizzes
> >>
> >> Treewide annotation of Quick Quizzes for nq build
> >>
> >> Target names updates in synctex-forward.sh
> >>
> >> Minor fixes in Quick Quizzes 5.49 and 5.52
> >>
> >> Try "make help" to see which target does what.
> >
> > That "make help" is great, thank you very much!!!
> >
> > I believe that the new options for quick quizzes will be quite useful
> > as well.
> >
> > I have pulled this and pushed out the result.
>
> Thanks!
>
> > A few questions on "make help":
> >
> > o Why no .pdf on the perfbook-qq, perfbook-1cqq, perfbook-nq,
> > perfbook-1cnq, and perfbook-tcb full-length targets?
>
> Umm, I'll fix them soon.
>
> >
> > o Would it make sense to just say prepending "1c" gets you
> > single-column output unless otherwise stated? Doing this
> > would shorten the output by quite a bit.
>
> Unfortunately, prepending "1c" doesn't work at the moment.
> E.g. "1chb" or "1cmsnt" doesn't work.
>
> I _guess_ such restructuring of target rules might be possible
> without adding every rule in the Makefile.
Or just add something like "(no 1c)" to the exceptions.
> > o Can some of the old defaults be retired? For example,
> > perfbook-tcb, perfbook-msns.pdf, and perfbook-mss.pdf?
>
> Maybe.
>
> They can be useful in testing the portability of .tex code base
> by using fonts of different width and detecting minor issues such
> as orphan headings.
OK, if they are useful, no point in getting rid of them. Besides, if
"make help" displays only the official targets, there is much less reason
to get rid of them.
> > o Would it make sense for "make help" to omit the experimental
> > targets, with something like "make fullhelp" printing the
> > current list? The last line of "make help" might point to
> > "make fullhelp" (or whatever you decide to call it) so that
> > people can easily get at the full list.
>
> Good point!
> It would be much better than the official targets scrolled away.
> I'll give it a try.
Looking forward to it!
> > And a question on quick quizzes. This is a real question that I have
> > not really thought about, so I have no idea what makes sense here.
> > Would it be reasonable to have a "textbook" or "academic" build target
> > that collected the non-essential quick quizzes at the end of each chapter,
> > omitting them from the text (though maybe leaving a marker as nq currently
> > does, or not, I have no idea)? If this does make sense, it would probably
> > be necesary to place a new macro at the end of each quick-quiz chapter.
> >
> > Thoughts?
>
> This would involve splitting qqz.tex into chapter-wise .tex files, which
> should be possible.
>
> Most important thing you'd need is to make those question parts
> independent of context in the text.
> Quite a few questions look dependent on where they are.
> Also, we need to pick essential quizzes or rephrase the text around them.
> This requires us to review the story line of the whole text in the "nq"
> build.
>
> So the addition of such a framework would be the easy part,
> improving the text would be much time consuming, I guess.
Definitely not something to do prior to the second edition, then.
Thank you for looking into this!
Thanx, Paul
> Thanks, Akira
>
> >
> > Thanx, Paul
> >
> >> Thanks, Akira
> >>
> >> PS:
> >>
> >> As for -hb build, I've found a clue to use "geometry" package as a
> >> workaround. It looks promising.
> >>
> >> Enabling qqzbg at release tags for official targets is next in my
> >> todo list.
> >>
> >> --
> >> The following changes since commit dcb1d4e43b2c1edba5a61bd0e63e0804478bf520:
> >>
> >> toolsoftrade: Improve rwlockscale.sh sampling strategy (2020-03-25 07:14:47 -0700)
> >>
> >> are available in the Git repository at:
> >>
> >> https://github.com/akiyks/perfbook.git tags/for-paul-2020.03.26a
> >>
> >> for you to fetch changes up to 1dd2b89ab3e7bb64a380d7ccef7033757dd442ef:
> >>
> >> Makefile: Add and rename targets for framed and no Quick Quizzes (2020-03-26 23:23:10 +0900)
> >>
> >> ----------------------------------------------------------------
> >> Akira Yokosawa (10):
> >> qqz.sty: Add background color to Quiz part of Quick Quizzes
> >> Add experimental target 'noqq' (sans inline Quick Quizzes)
> >> Permit consecutive QQs to appear in a framed box
> >> qqz.sty: Make noqq's Appendix E look same as that of 2cqq's
> >> qqz.sty: Improve accuracy of cross links
> >> treewide: Use macros for consecutive quick quizzes
> >> synctex-forward: Add recently added targets
> >> qqz.sty: Add comment on how to use new sets of macros
> >> count: Wordsmith Quick Quizzes 5.49 and 5.52
> >> Makefile: Add and rename targets for framed and no Quick Quizzes
> >>
> >> Makefile | 34 ++++-
> >> SMPdesign/SMPdesign.tex | 16 +-
> >> SMPdesign/partexercises.tex | 32 ++--
> >> advsync/rt.tex | 16 +-
> >> appendix/toyrcu/toyrcu.tex | 88 ++++++-----
> >> appendix/whymb/whymemorybarriers.tex | 40 ++---
> >> count/count.tex | 277 +++++++++++++++++++----------------
> >> cpu/overheads.tex | 16 +-
> >> datastruct/datastruct.tex | 16 +-
> >> debugging/debugging.tex | 72 +++++----
> >> defer/hazptr.tex | 16 +-
> >> defer/rcuapi.tex | 32 ++--
> >> defer/rcuexercises.tex | 17 ++-
> >> defer/rcufundamental.tex | 16 +-
> >> defer/rcuintro.tex | 32 ++--
> >> defer/rcuusage.tex | 32 ++--
> >> defer/refcnt.tex | 16 +-
> >> defer/seqlock.tex | 40 ++---
> >> formal/axiomatic.tex | 16 +-
> >> formal/dyntickrcu.tex | 48 +++---
> >> formal/ppcmem.tex | 14 +-
> >> formal/spinhint.tex | 33 +++--
> >> future/formalregress.tex | 32 ++--
> >> future/htm.tex | 24 +--
> >> howto/howto.tex | 24 +--
> >> intro/intro.tex | 32 ++--
> >> locking/locking-existence.tex | 16 +-
> >> locking/locking.tex | 48 +++---
> >> memorder/memorder.tex | 96 ++++++------
> >> owned/owned.tex | 16 +-
> >> perfbook.tex | 7 +
> >> qqz.sty | 133 ++++++++++++++++-
> >> together/refcnt.tex | 24 +--
> >> toolsoftrade/toolsoftrade.tex | 104 +++++++------
> >> utilities/extractqqz.sh | 8 +-
> >> utilities/synctex-forward.sh | 2 +-
> >> 36 files changed, 892 insertions(+), 593 deletions(-)
> >>
^ permalink raw reply [flat|nested] 10+ messages in thread
end of thread, other threads:[~2020-03-27 0:11 UTC | newest]
Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-03-21 2:24 [RFC NOT PULL] Add experimental target 'noqq' (sans inline Quick Quizzes) Akira Yokosawa
2020-03-22 18:24 ` Paul E. McKenney
2020-03-25 15:19 ` Akira Yokosawa
2020-03-25 16:17 ` Paul E. McKenney
2020-03-25 22:19 ` Akira Yokosawa
2020-03-26 2:37 ` Paul E. McKenney
2020-03-26 15:04 ` [RFC PULL v2] Add experimental targets 'nq' and '1cnq' " Akira Yokosawa
2020-03-26 16:05 ` Paul E. McKenney
2020-03-26 22:56 ` Akira Yokosawa
2020-03-27 0:11 ` Paul E. McKenney
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.