[Top][All Lists]

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

Re: Relating multiple index entries to one table item

From: Eli Zaretskii
Subject: Re: Relating multiple index entries to one table item
Date: Mon, 21 Nov 2022 15:23:58 +0200

> From: Arsen Arsenović <>
> Date: Sun, 20 Nov 2022 19:44:30 +0100
> In the GCC documentation, a construct that often appears is
>   @table @gcctabopt
>   @item -Wpedantic
>   @itemx -pedantic
>   @opindex pedantic
>   @opindex Wpedantic
>   @opindex Wno-pedantic
> The problem with this, though, is that all but the first of these index
> calls end up in the item body rather than the item itself, meaning that
> all but the first index will scroll HTML pages below the actual items.
> This result is not very pleasant to see, since it strips away essential
> context from the reader.  I tried working around this by interlacing
> @opindex calls between /@itemx?/ calls, but that didn't really help.

The index entries should precede the first @item, not be after it.  Maybe
doing so doesn't work in this case, but you should move the index entries
before the @item/@itemx lines regardless, since otherwise the indexing
commands will not land you where you want.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]