In the section documenting `@pxref` there is the following paragraph.

   In past versions of Texinfo, it was not allowed to write
   punctuation after a ‘@pxref’, so it could be used _only_ before a
   right parenthesis.  This is no longer the case.  The effect of
   ‘@pxref{NODE-NAME}’ is similar to that of ‘see @ref{NODE-NAME}’.
   However, in many circumstances the latter is preferable, as this
   makes it clear in the Info output that the word "see" should be
   present.

I don't understand what the last sentence means; please elaborate.  As
far as I understand the issue, `see @ref{}` should be avoided for the
sake of Info output.  In other words, it is better to write

```
Foo equals bar; @pxref{This} and @ref{That}.
Foo equals bar; @pxref{This}.
```

to get

```
Foo equals bar; *note This:: and *note That::.
Foo equals bar; *note This::.
```

What am I missing?


    Werner

Reply via email to