[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Multiline @cindex entries misrender in groff Texinfo manual
From: |
G. Branden Robinson |
Subject: |
Re: Multiline @cindex entries misrender in groff Texinfo manual |
Date: |
Wed, 5 Jun 2024 02:58:52 -0500 |
At 2024-05-16T22:41:44+0200, Patrice Dumas wrote:
> > At 2024-05-16T12:55:51-0500, Dave Kemper wrote:
> > > In a few places, the groff Texinfo manual uses a line-ending @ to
> > > continue a @cindex entry. An example is:
[...]
> > > That is, the continued @code{} tags are being put into the output
> > > rather than considered part of the index entry.
>
> There is a specific context in which @ followed by a newline is removed
> and the line is not considered to be ended, on the @def* command line.
> It is said explicitely in that section that in other contexts, the @
> followed by a newline is not a continuation character:
> https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Def-Cmd-Continuation-Lines
>
> In the manual it is said that @ followed by a new line leads to the
> insertion of a single space in the output:
> https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Inserting-Space
>
> It is never said in the manual very explicitely whether a @ followed by a new
> line ends an @-command line or not, but the line @-command is described as
> being on a line:
> https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Command-Syntax
>
> So my interpretation is that @ followed by a space both produces a
> single space and ends the @-command line (except on @def* where it
> produces nothing and does not end the @-command line).
I've pushed a fix for this. Thanks for the consultation!
Regards,
Branden
signature.asc
Description: PGP signature