groff
[Top][All Lists]
Advanced

[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

Attachment: signature.asc
Description: PGP signature


reply via email to

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