> From: Gavin Smith <gavinsmith0...@gmail.com>
> Date: Sat, 2 Aug 2025 20:33:34 +0100
> Cc: w...@gnu.org, bug-texinfo@gnu.org
>
> > So my firm recommendation is to never use @ref as the last
> > cross-reference in parentheses, and never use @pxref outside of
> > parentheses. Using them contrary to that recommendation will "mostly
> > work", but will be sub-optimal in quite a few cases, as Gavin
> > explains.
>
> What do you think of multiple cross-references in parentheses: you
> advise against "(see @ref{foo} and @ref{bar})" and apparently would
> favour "(see @ref{foo} and @pxref{bar})" or "(@pxref{foo} and @pxref{bar})".
Yes, the latter two are IMO preferred, with the last one slightly better.
(In practice, more than a single reference in parentheses is rare.)
> Why is that?
Because it does TRT with older versions of Texinfo as well. Also,
"see @ref" should be used very rarely, since @ref was invented for
those cases where you want to use something other than "see". Its
output in Info, "see *note", makes "see" redundant, so if the user
reads without Info-hide-note-references set, it's awkward at best. So
my recommendation about @ref is not to use it where "see" is used.
