On Tue, 30 Mar 2021 11:07:00 +1100, Balbir Singh wrote:
> On Tue, Mar 30, 2021 at 08:24:22AM +0900, Akira Yokosawa wrote:
>> +CC: Barbir
>>
>> On Mon, 29 Mar 2021 08:32:10 -0700, Paul E. McKenney wrote:
>>> On Mon, Mar 29, 2021 at 08:54:05PM +0900, Akira Yokosawa wrote:
>>>> On Sun, 28 Mar 2021 17:06:56 -0700, Paul E. McKenney wrote:
>> [...]
>>>>> Would it help reduce Makefile complexity by having the default target
>>>>> do fancy Quick Quizzes like it does for releases and editions?
>>>>
>>>> Yes, it is high time to do some refactoring of make targets.
>>>>
>>>> Before changing Makefile, how does the provisional "make help-full" text
>>>> at the bottom look to you? Still too complex?
>>>>
>>>> Its commit log would be something like:
>>>>
>>>> EXP Makefile: (help text only) Refactor build targets
>>>>
>>>> Main points:
>>>>
>>>> o Promote qq+ix (- highlighting) -> default "perfbook.pdf"
>>>> o "df" (draft) as the same as current default (no QQZ framing, no indexing)
>>>> for quicker build
>>>> o "ix" for draft check of indexing (with indexed terms/names highlighted),
>>>> no QQZ framing
>>>> o Promote "nq", "sf" "sfnq" as semi-official targets. (some might prefer
>>>> sans serif font for ebook)
>>>> o Prepare ebook specific targets "eb", "ebnq", "ebsf", "ebsfnq", "ebix",
>>>> and "ebdf" (independent of PERFBOOK_PAPER).
>>>> o Prepare 1c* variants for all the 2c targets. (there is no "1ceb*" nor
>>>> "eb1c*", as "eb" implies "1c".)
>>>>
>>>> Not-Signed-off-by: Akira Yokosawa <akiyks@xxxxxxxxx>
>>>
>>> As long as "make help" is short, I am fine with "make help-full" being
>>> long and detailed. It does look like some of the options might be ready
>>> to be removed, but I will trust your judgment on that.
>>
>> Looks like there is some room to simplify.
>> See inline comment below.
>>
>>>
>>> Thanx, Paul
>>>
>>>> Thanks, Akira
>>>>
>>>>>
>>>>> Thanx, Paul
>> [...]
>>>>
>>>> ------
>>>> $ make help-full
>>>> Official targets (Latin Modern Typewriter for monospace font):
>>>> Full, Abbr.
>>>> perfbook.pdf, 2c: (default) 2-column layout
>>>> perfbook-1c.pdf, 1c: 1-column layout
>>>> Note:
>>>> Official targets now enable indexing and Quick-Quiz framing.
>>>>
>>>> Set env variable PERFBOOK_PAPER to change paper size:
>>>> PERFBOOK_PAPER=A4: a4paper
>>>> PERFBOOK_PAPER=HB: hard cover book
>>>> PERFBOOK_PAPER=EB: ebook reader, always 1c layout (WIP)
>>
>> I think "PERFBOOK_PAPER=EB" is not necessary if we add ebook-size
>> specific targets like "eb", "ebnq", "ebsf", "ebsfnq", "ebix",
>> and "ebdf". (See "Prefixed targets:" below.)
>>
>> Balbir, do you mind if I drop support of PERFBOOK_PAPER=EB ?
>>
>
>
> I'd love to use the eb format with an index if possible, I presume
> it has no impact on the target as such?
New perfbook-eb.pdf will have index as well as Quick Quiz framing.
Please wait for a while until my indexing-scheme branch gets ready,
hopefully, by this weekend.
Of course, we need to continue indexing after the merge.
Thanks, Akira
>
> Balbir Singh.
>
>> Thanks, Akira
>>
>>>> other (default): letterpaper
>>>> Note:
>>>> Modified PERFBOOK_PAPER takes effect after "make paper-clean".
>>>>
>>>> Paper-size specific targets (independent of PERFBOOK_PAPER):
>>>> perfbook-lt.pdf, lt: 2c layout on letterpaper
>>>> perfbook-hb.pdf, hb: 2c layout for hard cover book
>>>> perfbook-a4.pdf, a4: 2c layout on a4paper
>>>> perfbook-eb.pdf, eb: 1c layout for ebook reader (WIP)
>>>>
>>>> Semi-official targets:
>>>> Full, Abbr.
>>>> perfbook-nq.pdf, nq: 2c without inline Quick Quizzes (chapterwise Q&As)
>>>> perfbook-sf.pdf, sf: 2c with sans serif font
>>>> perfbook-sfnq.pdf, sfnq: sf + nq
>>>>
>>>> Targets for draft check, non-framed Quick Quizzes (quicker build)
>>>> perfbook-ix.pdf, ix: for draft check, with indexed terms highlighted
>>>> perfbook-df.pdf, df: for draft check, without indexing
>>>>
>>>> Prefixed targets:
>>>> "1c*" such as "1cnq", "1csf", and "1cix" are for 1c-layout.
>>>> "ebnq", "ebsf", "ebsfnq", "ebix", and "ebdf" are for ebook-size 1c-layout,
>>>> independent of PERFBOOK_PAPER. (WIP)
>>>>
>>>> Experimental targets:
>>>> perfbook-msnt.pdf, msnt: newtxtt as monospace (non-slashed 0)
>>>> perfbook-mstx.pdf, mstx: txtt as monospace
>>>> perfbook-msr.pdf, msr: regular thickness courier clone as monospace
>>>> perfbook-msn.pdf, msn: narrow courier clone as monospace
>>>>
>>>> Historical targets:
>>>> perfbook-tcb.pdf, tcb: table caption at bottom (First Edition)
>>>> perfbook-msns.pdf, msns: non-scaled courier (First Edition)
>>>> perfbook-mss.pdf, mss: scaled courier (default in early 2017)
>>>>
>>>> Notes:
>>>> - "msnt" requires "newtxtt". "mstx" is a fallback target for older TeX env.
>>>> - "msr" and "msn" require "nimbus15".
>>>> - "msn" doesn't cover bold face monospace.
>>>> - "sf" requires "newtxsf".
>>>> - All the targets except for "msn" use "Latin Modern Typewriter" font
>>>> for code snippets.
>>>> ------
>>>>
