> Date: Thu, 06 Jan 2022 08:17:45 +0000 (UTC) > From: Werner LEMBERG <w...@gnu.org> > > The `@ref` command can tempt writers to express themselves in a > manner that is suitable for a printed manual but looks awkward in > the Info format. Bear in mind that your audience could be using > both the printed and the Info format. > > This implies exactly the opposite.
No, it doesn't. It refers to a different issue: a tendency to use @ref without "see" or anything like that, because people think about HTML-style hyperlinks. Here's a relevant example: @multitable @columnfractions .30 .20 .50 [...] @item agent expression @tab length of @tab @ref{agent expression object} Another one: @table @code [...] @item -address [@code{on}|@code{off}] Set printing of addresses. Related setting: @ref{set print address}. > IMHO, the first quote should be improved, probably referring to the > second quote if good formatting for the Info format is desired. They are unrelated. Perhaps the second one should be made more explicit.