bug-texinfo
[Top][All Lists]
Advanced

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

second argument of @pxref fails to reflow text


From: Benno Schulenberg
Subject: second argument of @pxref fails to reflow text
Date: Tue, 19 Oct 2021 15:35:23 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0

Hi,

When an @pxref{} command has a second argument, the subsequent text is
arranged as if the text of the first argument were *also* there.

To reproduce, run in the source tree of texinfo-6.8:

  info  doc/texinfo.info  writ  doc  @cop

See that the first paragraph looks like this:

  The '@copying' command should be given very early in the document; the
  recommended location is right after the header material (see Texinfo
  File Header).  It conventionally consists of a sentence or two about
  what the program is, identification of the documentation itself, the
  legal copyright line, and the copying permissions.  [...]

Now edit doc/texinfo.texi and add ", Header" as second argument in the
@pxref{Texinfo File Header} command (line 1819).  Run make, and then
the same info command again.  The first paragraph now looks like this:

  The '@copying' command should be given very early in the document; the
  recommended location is right after the header material (see Header).
  It conventionally consists of a sentence or two
  about what the program is, identification of the documentation itself,
  the legal copyright line, and the copying permissions.  [...]

Expected behavior: the text should be flowed normally, making full use
of the available width.

(Bug was found while editing nano's manual and wanting to use a less
verbose name for a cross reference, but using it had zero effect on
how the rest of the text was arranged.)

Benno

Attachment: OpenPGP_signature
Description: OpenPGP digital signature


reply via email to

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