Re: [PATCH RESEND -perfbook 00/10] Index and acronym updates

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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



[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Linux NFS]     [Linux NILFS]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux