On Fri, Jan 14, 2022 at 11:13:37PM +0900, Akira Yokosawa wrote: > 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. I cheated and just cloned your repository separately. ;-) > Intermediate index-related files generated on a different branch > might be incompatible. So underlined is the glossary and bold is a primary reference. Looks quite reasonable to me, thank you! One other option for the glossary is to just give the page-number range in the note at the beginning of the glossary. However, the underlining does seem more convenient for the reader. Should that note be shortened? *Bold*: Major reference. _Underline_: Definition. Given that there are examples of both on the first page, there should not be too much confusion. (Famous last words...) Thanx, Paul > 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 > >>>