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? 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. > >> ------ > >>
