Re: Display of cross references to other manuals

[Eli Zaretskii]

> Date: Sun, 14 Mar 2004 15:57:07 -0600 (CST)
> From: Luc Teirlinck <address@hidden>
> 
>                  Overview(top).
> 
>    I think that is an improvement.  Would you like to install that part?
> 
> I of course meant Overview(cl).

FWIW, to me, "Overview(cl)" looks like a typo.  It certainly does not
spell out that a different manual is referenced, unless I happen to
know that there's an Info file called `cl' on my system.

"Overview (in the `cl' manual)" would be better, if we are pursuing
this class of solutions.  Putting the 5th arg of @xref in the parens,
prefixed with "in ", would be even better, but it will probably
disrupt the line filling too much, as names of manuals tend to be
longish.

> But I believe I can not just go ahead
> and install, because I remember that there was still some controversy
> over "See Overview(cl)" vs "Overview(cl)" or "*Note Overview(cl)",
> where if I remember well, "See Overview(cl)" produced some bugs.
> However, these bugs are already present in the current CVS, "See
> Overview(cl)" just ruins Juri's patch for these bugs and that patch
> was never installed.  Maybe we should reopen the discussion of Juri's
> changes on emacs-devel, get Juri to install just those parts of the
> changes that are non-controversial and then make decisions on those
> parts that are controversial.

Maybe we should just turn this feature off by default.  It has already
generated lots of discussions and controversy, which is a clear sign
of something that quite a few users will dislike.  We shouldn't make
such features be on by default, I think.