bug-texinfo
[Top][All Lists]
Advanced

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

Re: `@findex` within paragraph doesn't work


From: Werner LEMBERG
Subject: Re: `@findex` within paragraph doesn't work
Date: Tue, 21 Mar 2023 04:04:49 +0000 (UTC)

>> > This was a deliberate change to make index commands terminate
>> > paragraphs.
>> 
>> Well, it stayed completely undocumented...
> 
> It is in NEWS, but not in a released version admittedly.

OK, but there isn't a single word in the Texinfo manual that index
commands now automatically end a paragraph if not immediately preceded
by `@item`.

> I looked at where this was used in the manual in question and it
> wasn't obvious that the index entries were in the right place as all
> the "Predefined commands" section was a list of commands but no
> explanation of those commands.

Yes, a list, but neither `@itemize` nor `@enumerate` but just a simple
paragraph.

> I can't think of a way right now of supporting this with the current
> approach.  [...]

What about introducing a new flag, something like

```
@set txiindexinpara
```

that restores the previous behaviour?  At least on the `texinfo.tex`
side this shouldn't be too difficult.  However, I have no idea about
`makeinfo` and `texi2any`...

Currently, there are more than 28500 index entries in the LilyPond
manuals (counting all translations), which really means *a lot* of
work of checking and reordering before being able to update to a more
recent `texinfo.tex`.  Hopefully, I can find a good regex for
`pcregrep` to simplify at least the checking.

This backward-incompatible change IMHO needs a *much* bigger
warning in the NEWS file, and it needs real documentation too, as
mentioned above.


    Werner



reply via email to

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