Re: Display of cross references to other manuals

[Eli Zaretskii]

> Date: Sat, 13 Mar 2004 08:43:51 -0500
> From: address@hidden (Karl Berry)
> 
>     eliz> @xref{Top, , Overview of GNU Make, make, The GNU Make Manual}.
> 
> That works nicely for an xref to Top, but references to other nodes seem
> problematic.  For example, the Texinfo manual has references to
> Narrowing, Pages, Special Forms, Lisp Debug, Regexps, and plenty more in
> the Emacs and Elisp manuals.  I don't fancy manually changing them.

If we decide that theses xrefs need work, it's IMHO entirely
appropriate to manually change them.  Cross-references, like
indexing, is a human activity; computers cannot cut it.

For example, instead of

    (@xref{Narrowing, , , emacs, The GNU Emacs Manual}, for more
    information about the narrowing commands.)

I'd write

    (@xref{Narrowing commands in Emacs, Narrowing, , emacs, The GNU
    Emacs Manual}, for more information about the narrowing commands.)

> Seems like we should change that as well, for example add "(manualname)"
> to the link, as in <a href="emacs/Narrowing.html">Narrowing (emacs)</a>.

We could change makeinfo to do that, but we should carefully consider
what it should produce, given the existing Texinfo files out there.
The results should be readable in stand-alone Info and in HTML
browsers, i.e. they should not resemble a typo.