>>>> "Jake" == Jake Colman
<jake.colman(a)xemacs.org> writes:
Jake> What is the proper way to do a cross-ref to another info
Jake> file? I cannot figure this out.
Jake> As a specific example, if I reference the `customize'
Jake> command or to the cc-mode package I might want to make a
Jake> xref to the info file that documents the custom and cc-mode
Jake> packages.
Jake> 1) What is the proper syntax?
Hi Jake, see the four and five argument version in
(Info-goto-node "(texinfo)xref")
See
xemacs-21.5\man\lispref\backups.texi
for one correct example:
idle time. @xref{Auto Save, Auto-Save, Auto-Saving: Protection Against
Disasters, xemacs, The XEmacs User's Manual}, for information on
and an incorrect one too :-):
of the file with the @code{revert-buffer} command. @xref{Reverting, ,
Reverting a Buffer, xemacs, The XEmacs Lisp Reference Manual}.
The fifth argument in the latter should also say "The XEmacs User's
Manual" since it's referring to the xemacs file.
Jake> 2) What is the proper way stylistically?
See
(Info-goto-node "(texinfo)Cross References")
for the proper variant, be it for the beginning or end of a sentence,
info-only, or parenthetical.
Documentation spreads the word!
Good Luck,
Adrian
Jake> Thanks!
Jake> --
Jake> Jake Colman -- XEmacs Tinkerer
--
Adrian Aichner
mailto:adrian@xemacs.org
http://www.xemacs.org/