blob: c6a4b34cf036f52a404ccc67c81a9d323f9bb1c9 [file]
<!DOCTYPE html>
<html>
<!-- Created by Texinfo 6.8dev+dev, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This manual is for GNU Texinfo (version 6.8dev, 23 February 2022),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled
"GNU Free Documentation License". -->
<title>Cross Reference Commands (GNU Texinfo 6.8dev)</title>
<meta name="description" content="Cross Reference Commands (GNU Texinfo 6.8dev)">
<meta name="keywords" content="Cross Reference Commands (GNU Texinfo 6.8dev)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<meta name="viewport" content="width=device-width,initial-scale=1">
<link href="index.html" rel="start" title="Top">
<link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Cross-References.html" rel="up" title="Cross References">
<link href="Cross-Reference-Parts.html" rel="next" title="Cross Reference Parts">
<link href="References.html" rel="prev" title="References">
</head>
<body lang="en">
<div class="section-level-extent" id="Cross-Reference-Commands">
<div class="nav-panel">
<p>
Next: <a href="Cross-Reference-Parts.html" accesskey="n" rel="next">Parts of a Cross-reference</a>, Previous: <a href="References.html" accesskey="p" rel="prev">What References Are For</a>, Up: <a href="Cross-References.html" accesskey="u" rel="up">Cross-references</a> &nbsp; [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<h3 class="section" id="Different-Cross_002dreference-Commands">5.2 Different Cross-reference Commands</h3>
<a class="index-entry-id" id="index-Different-cross_002dreference-commands"></a>
<p>There are three different cross-reference commands:
</p>
<dl class="table">
<dt><code class="code">@xref</code></dt>
<dd><p>Used to start a sentence in the printed manual and in HTML with
&lsquo;See&nbsp;&hellip;&rsquo;<!-- /@w --> or an Info cross-reference saying &lsquo;<samp class="samp">*Note
<var class="var">name</var>: <var class="var">node</var>.</samp>&rsquo;.
</p>
</dd>
<dt><code class="code">@ref</code></dt>
<dd><p>Used within or, more often, at the end of a sentence; produces just
the reference in the printed manual and in HTML without the preceding
&lsquo;See&rsquo; (same as <code class="code">@xref</code> for Info).
</p>
</dd>
<dt><code class="code">@pxref</code></dt>
<dd><p>Used within parentheses, at the end of a sentence, or otherwise before
punctuation, to make a reference. Its output starts with a lowercase
&lsquo;see&rsquo; in the printed manual and in HTML, and a lowercase &lsquo;<samp class="samp">*note</samp>&rsquo;
in Info. (&lsquo;<samp class="samp">p</samp>&rsquo; is for &lsquo;parenthesis&rsquo;.)
</p></dd>
</dl>
<p>Additionally, there are commands to produce references to documents
outside the Texinfo system. The <code class="code">@cite</code> command is used
to make references to books and manuals. <code class="code">@url</code> produces
a <acronym class="acronym">URL</acronym>, for example a reference to a page on the World
Wide Web.
</p>
</div>
</body>
</html>