Return-Path: DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=OZEBkLBblOqPVghNP1+oLU2DiC2EPu3VVw5cgcB85t8=; b=DKop3jdnWPwlVEtqHWRbE242+U/YghVhA7Kp/rzzTSP3Is3GefoVdS9QMuUNf8A/Us nD8qFhl0hiMNwF0OauGQXKUQLo6QHcyOwVtAhgqoOAjgnd3ZnXOyKgmuYdcwXh74KFTS Z+4Bkiyed96VNjWtZcHg/xfsXGE3yiTKdmQC6wOlPnIFH97vZNMgU0E4CTtfI4XL35vs s7JvgasxEhQCTqZaWChpXaK0WRel6on6CvhDRESxNs5k3fcmUaqfVzU0KfBgXSiw92U/ Fy3z6+VrQWXF5AlbDAydqjx1fGT54e4kyt0rEDAdCZX9FpNxA8kah/Suw/SgEXWxqDMc L07g== Subject: Re: [PATCH RESEND -perfbook 00/10] Index and acronym updates References: <20220106161945.GK4202@paulmck-ThinkPad-P17-Gen-1> <20220108050704.GA909013@paulmck-ThinkPad-P17-Gen-1> <21fde8e3-13d5-28d5-2666-679cae9ae9cb@gmail.com> <20220114134728.GT947480@paulmck-ThinkPad-P17-Gen-1> From: Akira Yokosawa Message-ID: Date: Fri, 14 Jan 2022 23:13:37 +0900 MIME-Version: 1.0 In-Reply-To: <20220114134728.GT947480@paulmck-ThinkPad-P17-Gen-1> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit To: "Paul E. McKenney" Cc: perfbook@vger.kernel.org, Akira Yokosawa List-ID: On Fri, 14 Jan 2022 05:47:28 -0800, Paul E. McKenney wrote: > On Fri, Jan 14, 2022 at 07:11:51PM +0900, Akira Yokosawa wrote: >> On Fri, 7 Jan 2022 21:07:04 -0800, >> Paul E. McKenney wrote: >>> On Thu, Jan 06, 2022 at 08:19:45AM -0800, Paul E. McKenney wrote: >>>> On Thu, Jan 06, 2022 at 04:29:25PM +0900, Akira Yokosawa wrote: >>>>> Hi Paul, >>>>> >>>>> This is another round of *never-ending* indexing updates. >>>> >>>> Maintaining indexes is non-trivial, no two ways about it! >>>> >>>> So special thanks for this series! >>>> >>>> At some point, for the index entries with lots of references, it may >>>> be necesary to flag the most important references. I sometimes see >>>> such entries italicized or marked with "ff", though I freely confess >>>> that I have no idea what the rationale for "ff" might be. >>> >>> And I did find this. The "ff" stands for "folios following", where >>> "folio" is used in the sense of "page". So "368 ff" means "page 368 >>> and some number of subsequent pages." >>> >>> I have spent most of my life fooled into thinking that "ff" indicated >>> the most significant page for a given index item. But there is some >>> connection, at least assuming that a longer discussion of a given term >>> is a more significant discussion of that term. ;-) >> >> So, prompted by your comment, I'm experimenting change of page number >> styles referenced in index. >> >> You can see a WIP tree at: >> >> -------- >> The following changes since commit 6eca56ccde0839f4ea81c5f02ddbe4c7c97e225f: >> >> Fix a typo in Bibliography (2022-01-12 09:48:13 -0800) >> >> are available in the Git repository at: >> >> https://github.com/akiyks/perfbook.git tags/WIP-index-page-style-2022.01.14 >> >> for you to fetch changes up to cc9e388aee6cd72ed757fa0ec193b8e35f2bbaff: >> >> index: Retouch prenote layout (2022-01-14 17:41:30 +0900) >> >> ---------------------------------------------------------------- >> Akira Yokosawa (6): >> Initial indexformat support >> locking, defer: POC of bold face page number in index >> defer: POC of hierarchical index with modifier part's case preserved >> index: Add prenotes of legends in Index pages >> index, glossary: Add underline for pages in Glossary >> index: Retouch prenote layout >> >> defer/rcu.tex | 2 +- >> defer/rcufundamental.tex | 2 +- >> defer/rcuintro.tex | 2 +- >> glossary.tex | 176 ++++++++++++++++++++--------------------- >> glsdict.tex | 10 ++- >> locking/locking.tex | 4 +- >> perfbook-lt.tex | 67 +++++++++++++++- >> utilities/adjustindexformat.pl | 20 +++++ >> utilities/runlatex.sh | 2 + >> 9 files changed, 189 insertions(+), 96 deletions(-) >> create mode 100755 utilities/adjustindexformat.pl >> -------- >> >> This is not yet ready for pull. I need to expand change logs >> at least. >> >> If we were using plain \index{} macro for tagging terms, you could >> say: >> >> \index{some word|textit} >> >> to italicize its page number. >> However, \IX{some word|textit} does not work. >> >> So I need to define a number of macros: >> >> \IXB{}, \IXBh{}{}, ... -> Bold, for that "ff" case >> \IXG{}, \IXGh{}{}. ... -> Underline, for definitions in Glossary >> >> , and to use one of them where you want to emphasize. >> >> The "B" in \IXB came from "Bold", but actual style of emphasis can >> be changed easily by redefining the \BF{} command. >> \IXF{} might be a better name. (Macro names embedded in .tex >> files need to be stable.) > > I will play with this later today, Pacific Time, but in the meantime I > just wanted to say that having the most significant page number in an > index list be bold works just fine. If we have bold, there is no need > for italics! OK! ;-) In case you encounter build errors while switching between WIP- and master branches, "make clean" should help you. Intermediate index-related files generated on a different branch might be incompatible. Thanks, Akira > > Thanx, Paul > >> Furthermore, I have not figured out the way to make those >> macros generate proper-format index entries in .idx file. >> This is mostly because I'm not good at low-level TeX programming. >> >> So I added adjustindexformat.pl so that it can be amended before >> fed into "makeindex". >> >> I'd like you to have a look at the changes and resulting looks of >> Index pages. >> >> Any feedback is welcome! >> >> Thanks, Akira >> >>> >>> Thanx, Paul >>>