[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
OpenPGP_signature
Description: OpenPGP digital signature
- second argument of @pxref fails to reflow text,
Benno Schulenberg <=