On Mon, Dec 29, 2025 at 08:19:37AM -0800, Raymond Toy wrote:
> In the Maxima manual, there's this macro:
>
> |@macro mxref {nodename, text} @code{@ref{\nodename\, \text\}} @end macro |
>
> A typical usage is |@mxref{expintrep-gamma-incomplete, gamma_incomplete}|.
> This works fine in html and info which shows |gamma_incomplete|. However, in
> the pdf output, it shows |expintrep-gamma-incomplete|.
>
> This is with a self-built git version of texinfo that reports the version as
> 7.2.90 for makeinfo.
>
> ​
(You can see how the plain text version of your email misses line breaks
from code samples).
I expect you need to use an extra comma in the definition:
@ref{\nodename\,, \text\}
The five arguments for @ref are shown here:
@ref{NODE-NAME, ONLINE-LABEL, PRINTED-LABEL,
MANUAL-NAME, PRINTED-MANUAL-TITLE}.
(from the Texinfo manual).
You can see that the second argument is the "online" label which is not
used for the PDF output.
> ...often, you will leave out the second argument when you use
> the long version of ‘@xref’. In this case, the third argument, the
> topic description, will be used as the cross-reference name in online
> formats. For example,
>
> @xref{Electrical Effects, , Thunder and Lightning,
> weather, An Introduction to Meteorology}.
>
> produces
>
> *Note Thunder and Lightning: (weather)Electrical Effects.
>
> in Info and
>
> See section "Thunder and Lightning" in ‘An Introduction to
> Meteorology’.
>
> in a printed manual.
