JezK
Edit File: References.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://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.8, 8 June 2021), 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-2021 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>References (GNU Texinfo 6.8)</title> <meta name="description" content="References (GNU Texinfo 6.8)"> <meta name="keywords" content="References (GNU Texinfo 6.8)"> <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-Commands.html" rel="next" title="Cross Reference Commands"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="section" id="References"> <div class="header"> <p> Next: <a href="Cross-Reference-Commands.html" accesskey="n" rel="next">Different Cross-reference Commands</a>, Up: <a href="Cross-References.html" accesskey="u" rel="up">Cross-references</a> [<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> <span id="What-References-Are-For"></span><h3 class="section">5.1 What References Are For</h3> <p>Often, but not always, a printed document should be designed so that it can be read sequentially. People tire of flipping back and forth to find information that should be presented to them as they need it. </p> <p>However, in any document, some information will be too detailed for the current context, or incidental to it; use cross-references to provide access to such information. Also, an online help system or a reference manual is not like a novel; few read such documents in sequence from beginning to end. Instead, people look up what they need. For this reason, such creations should contain many cross-references to help readers find other information that they may not have read. </p> <p>In a printed manual, a cross-reference results in a page reference, unless it is to another manual altogether, in which case the cross-reference names that manual. In Info, a cross-reference results in an entry that you can follow using the Info ‘<samp>f</samp>’ command. (See <a data-manual="info" href="../info/Help_002dXref.html#Help_002dXref">Following cross-references</a> in <cite>Info</cite>.) In HTML, a cross-reference results in an hyperlink. </p> <p>The various cross-reference commands use nodes (or anchors, see <a href="_0040anchor.html"><code>@anchor</code>: Defining Arbitrary Cross-reference Targets</a>) to define cross-reference locations. TeX needs nodes to define cross-reference locations. When TeX generates a DVI file, it records each node’s page number and uses the page numbers in making references. Thus, even if you are writing a manual that will only be printed, and not used online, you must nonetheless write <code>@node</code> lines in order to name the places to which you make cross-references. </p> </div> </body> </html>