[latexrefman-commits] [SCM] latexrefman updated: r911 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Tue May 25 20:07:17 CEST 2021
Author: jimhefferon
Date: 2021-05-25 18:07:16 +0000 (Tue, 25 May 2021)
New Revision: 911
Modified:
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
add section on xr base package
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2021-05-24 21:27:21 UTC (rev 910)
+++ trunk/latex2e.html 2021-05-25 18:07:16 UTC (rev 911)
@@ -217,6 +217,7 @@
<li><a id="toc-_005clabel-1" href="#g_t_005clabel">7.1 <code>\label</code></a></li>
<li><a id="toc-_005cpageref-1" href="#g_t_005cpageref">7.2 <code>\pageref</code></a></li>
<li><a id="toc-_005cref-1" href="#g_t_005cref">7.3 <code>\ref</code></a></li>
+ <li><a id="toc-xr-Package" href="#xr-package">7.4 <code>xr</code> Package</a></li>
</ul></li>
<li><a id="toc-Environments-1" href="#Environments">8 Environments</a>
<ul class="no-bullet">
@@ -4939,6 +4940,8 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005cref" accesskey="3">\ref</a></td><td> </td><td align="left" valign="top">Refer to a section, figure or similar.
</td></tr>
+<tr><td align="left" valign="top">• <a href="#xr-package" accesskey="4">xr package</a></td><td> </td><td align="left" valign="top">References from another document.
+</td></tr>
</table>
@@ -5063,7 +5066,7 @@
<hr>
<span id="g_t_005cref"></span><div class="header">
<p>
-Previous: <a href="#g_t_005cpageref" accesskey="p" rel="prev">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+Next: <a href="#xr-package" accesskey="n" rel="next">xr package</a>, Previous: <a href="#g_t_005cpageref" accesskey="p" rel="prev">\pageref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
</div>
<span id="g_t_005cref-1"></span><h3 class="section">7.3 <code>\ref</code></h3>
@@ -5110,6 +5113,85 @@
</p>
<hr>
+<span id="xr-package"></span><div class="header">
+<p>
+Previous: <a href="#g_t_005cref" accesskey="p" rel="prev">\ref</a>, Up: <a href="#Cross-references" accesskey="u" rel="up">Cross references</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
+</div>
+<span id="xr-Package"></span><h3 class="section">7.4 <code>xr</code> Package</h3>
+
+<span id="index-xr-package"></span>
+<span id="index-xr_002dhyper-package"></span>
+<span id="index-_005cexternaldocument"></span>
+<span id="index-cross-referencing_002c-across-documents"></span>
+
+<p>Synopsis:
+</p>
+<div class="example">
+<pre class="example">\usepackage{xr}
+ \externaldocument{<var>document-basename</var>}
+</pre></div>
+
+<p>or
+</p>
+<div class="example">
+<pre class="example">\usepackage{xr}
+ \externaldocument[<var>reference-prefix</var>]{<var>document-basename</var>}
+</pre></div>
+
+<p>Make cross references to the external document
+<code><var>document-basename</var>.tex</code>.
+</p>
+<p>Here is an example. If <code>lectures.tex</code> has this in the preamble
+</p>
+<div class="example">
+<pre class="example">\usepackage{xr}
+ \externaldocument{exercises}
+ \externaldocument[H-]{hints}
+ \externaldocument{answers}
+</pre></div>
+
+<p>then it can use cross reference labels from the other three documents.
+Suppose that <code>exercises.tex</code> has an enumerated list containing
+this,
+</p>
+<div class="example">
+<pre class="example">\item \label{exer:EulersThm} What if every vertex has odd degree?
+</pre></div>
+
+<p>and <code>hints.tex</code> has an enumerated list with this,
+</p>
+<div class="example">
+<pre class="example">\item \label{exer:EulersThm} Distinguish the case of two vertices.
+</pre></div>
+
+<p>and <code>answers.tex</code> has an enumerated list with this.
+</p>
+<div class="example">
+<pre class="example">\item \label{ans:EulersThm} There is no Euler path, except if there
+ are exactly two vertices.
+</pre></div>
+
+<p>After compiling the exercises, hints, and answers documents, entering
+this in the body of <code>lectures.tex</code> will result in the lectures
+getting the reference numbers used in the other documents.
+</p>
+<div class="example">
+<pre class="example">See Exercise~\ref{exer:EulersThm}, with Hint~\ref{H-exer:EulersThm}.
+The solution is Answer~\ref{ans:EulersThm}.
+</pre></div>
+
+<p>The prefix <code>H-</code> for the reference from the hints file is needed
+because the label in the hints file is the same as the label in the
+exercises file. Without that prefix, both references would get the
+number from the later file.
+</p>
+<p>Note: if the document uses the <code>hyperref</code> package then in place of
+<code>xr</code>, put <code>\usepackage{xr-hyper}</code> before the
+<code>\usepackage{hyperref}</code>. Also, if any of the multiple documents
+uses <code>hyperref</code> then they all must use it.
+</p>
+
+<hr>
<span id="Environments"></span><div class="header">
<p>
Next: <a href="#Line-breaking" accesskey="n" rel="next">Line breaking</a>, Previous: <a href="#Cross-references" accesskey="p" rel="prev">Cross references</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p>
@@ -20729,13 +20811,12 @@
</p>
<p>In a computer file, the characters are stored as binary according to
some scheme, called the encoding. There are many different encodings.
-The simplest is ASCII, but it does not accomodate many characters so
-that for instance to get the a-umlaut character ä in an
-ASCII-encoded text file a user must enter <code>\"a</code>, which makes the
-file hard to read and also means that TeX won’t hyphenation the word
-containing that character. Often a more inclusive encoding is more
-convenient. The modern standard, in some ways a union of the others, is
-UTF-8.
+The simplest is ASCII, but it does not accomodate many characters. For
+instance, to get the a-umlaut character ä in an ASCII-encoded text
+file a user must enter <code>\"a</code>, which makes the file hard to read and
+also means that TeX won’t hyphenation the word containing that
+character. Often a more inclusive encoding is more convenient. The
+modern standard, in some ways a union of the others, is UTF-8.
</p>
<p>In short, to enter material a user sets their file editor to use an
encoding scheme and this package is how LaTeX knows what encoding
@@ -24335,6 +24416,7 @@
<tr><td></td><td valign="top"><a href="#index-_005cExecuteOptions"><code>\ExecuteOptions</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cexists"><code>\exists</code></a>:</td><td> </td><td valign="top"><a href="#Math-symbols">Math symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cexp"><code>\exp</code></a>:</td><td> </td><td valign="top"><a href="#Math-functions">Math functions</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_005cexternaldocument"><code>\externaldocument</code></a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cextracolsep"><code>\extracolsep</code></a>:</td><td> </td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfbox"><code>\fbox</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfbox-_0026-_005cframebox">\fbox & \framebox</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005cfboxrule-1"><code>\fboxrule</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cframebox-_0028picture_0029">\framebox (picture)</a></td></tr>
@@ -25283,6 +25365,7 @@
<tr><td></td><td valign="top"><a href="#index-cross-references">cross references</a>:</td><td> </td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross-references_002c-resolving">cross references, resolving</a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross-referencing-with-page-number">cross referencing with page number</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpageref">\pageref</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cross-referencing_002c-across-documents">cross referencing, across documents</a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross-referencing_002c-symbolic">cross referencing, symbolic</a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-CTAN">CTAN</a>:</td><td> </td><td valign="top"><a href="#CTAN">CTAN</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-curly-braces">curly braces</a>:</td><td> </td><td valign="top"><a href="#Delimiters">Delimiters</a></td></tr>
@@ -26387,6 +26470,8 @@
<tr><td></td><td valign="top"><a href="#index-xindy-program"><code>xindy</code> program</a>:</td><td> </td><td valign="top"><a href="#makeindex">makeindex</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xparse-package"><code>xparse</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#LaTeX-command-syntax">LaTeX command syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-xparse-package-1"><code>xparse</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0040ifstar">\@ifstar</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xr-package"><code><code>xr</code> package</code></a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-xr_002dhyper-package"><code><code>xr-hyper</code> package</code></a>:</td><td> </td><td valign="top"><a href="#xr-package">xr package</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
<table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>$</b></a>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2021-05-24 21:27:21 UTC (rev 910)
+++ trunk/latex2e.info 2021-05-25 18:07:16 UTC (rev 911)
@@ -3144,6 +3144,7 @@
* \label:: Assign a symbolic name to a piece of text.
* \pageref:: Refer to a page number.
* \ref:: Refer to a section, figure or similar.
+* xr package:: References from another document.
File: latex2e.info, Node: \label, Next: \pageref, Up: Cross references
@@ -3234,7 +3235,7 @@
\end{equation}
-File: latex2e.info, Node: \ref, Prev: \pageref, Up: Cross references
+File: latex2e.info, Node: \ref, Next: xr package, Prev: \pageref, Up: Cross references
7.3 '\ref'
==========
@@ -3266,6 +3267,64 @@
reference. See the documentation on CTAN.
+File: latex2e.info, Node: xr package, Prev: \ref, Up: Cross references
+
+7.4 'xr' Package
+================
+
+Synopsis:
+
+ \usepackage{xr}
+ \externaldocument{DOCUMENT-BASENAME}
+
+ or
+
+ \usepackage{xr}
+ \externaldocument[REFERENCE-PREFIX]{DOCUMENT-BASENAME}
+
+ Make cross references to the external document
+'DOCUMENT-BASENAME.tex'.
+
+ Here is an example. If 'lectures.tex' has this in the preamble
+
+ \usepackage{xr}
+ \externaldocument{exercises}
+ \externaldocument[H-]{hints}
+ \externaldocument{answers}
+
+ then it can use cross reference labels from the other three
+documents. Suppose that 'exercises.tex' has an enumerated list
+containing this,
+
+ \item \label{exer:EulersThm} What if every vertex has odd degree?
+
+ and 'hints.tex' has an enumerated list with this,
+
+ \item \label{exer:EulersThm} Distinguish the case of two vertices.
+
+ and 'answers.tex' has an enumerated list with this.
+
+ \item \label{ans:EulersThm} There is no Euler path, except if there
+ are exactly two vertices.
+
+ After compiling the exercises, hints, and answers documents, entering
+this in the body of 'lectures.tex' will result in the lectures getting
+the reference numbers used in the other documents.
+
+ See Exercise~\ref{exer:EulersThm}, with Hint~\ref{H-exer:EulersThm}.
+ The solution is Answer~\ref{ans:EulersThm}.
+
+ The prefix 'H-' for the reference from the hints file is needed
+because the label in the hints file is the same as the label in the
+exercises file. Without that prefix, both references would get the
+number from the later file.
+
+ Note: if the document uses the 'hyperref' package then in place of
+'xr', put '\usepackage{xr-hyper}' before the '\usepackage{hyperref}'.
+Also, if any of the multiple documents uses 'hyperref' then they all
+must use it.
+
+
File: latex2e.info, Node: Environments, Next: Line breaking, Prev: Cross references, Up: Top
8 Environments
@@ -14230,12 +14289,12 @@
In a computer file, the characters are stored as binary according to
some scheme, called the encoding. There are many different encodings.
-The simplest is ASCII, but it does not accomodate many characters so
-that for instance to get the a-umlaut character ä in an ASCII-encoded
-text file a user must enter '\"a', which makes the file hard to read and
-also means that TeX won't hyphenation the word containing that
-character. Often a more inclusive encoding is more convenient. The
-modern standard, in some ways a union of the others, is UTF-8.
+The simplest is ASCII, but it does not accomodate many characters. For
+instance, to get the a-umlaut character ä in an ASCII-encoded text file
+a user must enter '\"a', which makes the file hard to read and also
+means that TeX won't hyphenation the word containing that character.
+Often a more inclusive encoding is more convenient. The modern
+standard, in some ways a union of the others, is UTF-8.
In short, to enter material a user sets their file editor to use an
encoding scheme and this package is how LaTeX knows what encoding they
@@ -16988,6 +17047,7 @@
(line 172)
* \exists: Math symbols. (line 212)
* \exp: Math functions. (line 48)
+* \externaldocument: xr package. (line 6)
* \extracolsep: tabular. (line 108)
* \fbox: \fbox & \framebox. (line 6)
* \fboxrule: \framebox (picture). (line 31)
@@ -18116,6 +18176,7 @@
* cross references: Cross references. (line 6)
* cross references, resolving: Output files. (line 33)
* cross referencing with page number: \pageref. (line 6)
+* cross referencing, across documents: xr package. (line 6)
* cross referencing, symbolic: \ref. (line 6)
* CTAN: CTAN. (line 6)
* curly braces: Delimiters. (line 6)
@@ -19384,6 +19445,8 @@
* xparse package: LaTeX command syntax.
(line 37)
* xparse package <1>: \@ifstar. (line 66)
+* xr package: xr package. (line 6)
+* xr-hyper package: xr package. (line 6)
@@ -19513,409 +19576,410 @@
Ref: startsection style123095
Ref: \@startsection/style123095
Node: Cross references126796
-Node: \label128889
-Node: \pageref130709
-Node: \ref131499
-Node: Environments132475
-Node: abstract134477
-Node: array136066
-Node: center138958
-Node: \centering140711
-Node: description142208
-Node: displaymath144425
-Node: document146121
-Node: \AtBeginDocument146551
-Node: \AtEndDocument147175
-Node: enumerate147819
-Ref: enumerate enumi149682
-Ref: enumerate enumii149682
-Ref: enumerate enumiii149682
-Ref: enumerate enumiv149682
-Ref: enumerate labelenumi150080
-Ref: enumerate labelenumii150080
-Ref: enumerate labelenumiii150080
-Ref: enumerate labelenumiv150080
-Node: eqnarray150619
-Node: equation152615
-Node: figure153283
-Node: filecontents155437
-Node: flushleft157346
-Node: \raggedright158373
-Node: flushright159571
-Node: \raggedleft160395
-Node: itemize161266
-Ref: itemize labelitemi162814
-Ref: itemize labelitemii162814
-Ref: itemize labelitemiii162814
-Ref: itemize labelitemiv162814
-Ref: itemize leftmargin163473
-Ref: itemize leftmargini163473
-Ref: itemize leftmarginii163473
-Ref: itemize leftmarginiii163473
-Ref: itemize leftmarginiv163473
-Ref: itemize leftmarginv163473
-Ref: itemize leftmarginvi163473
-Node: letter164955
-Node: list165193
-Ref: list makelabel167640
-Ref: list itemindent169025
-Ref: list itemsep169162
-Ref: list labelsep169815
-Ref: list labelwidth169978
-Ref: list leftmargin170989
-Ref: list listparindent171842
-Ref: list parsep172073
-Ref: list partopsep172541
-Ref: list rightmargin173339
-Ref: list topsep173524
-Ref: list beginparpenalty177099
-Ref: list itempenalty177198
-Ref: list endparpenalty177302
-Node: \item178173
-Node: trivlist179419
-Node: math180947
-Node: minipage181253
-Node: picture186782
-Node: \put193003
-Node: \multiput193568
-Node: \qbezier194307
-Node: \graphpaper195780
-Node: \line196574
-Node: \linethickness198548
-Node: \thinlines198997
-Node: \thicklines199408
-Node: \circle199792
-Node: \oval200334
-Node: \shortstack201310
-Node: \vector202707
-Node: \makebox (picture)203621
-Node: \framebox (picture)204803
-Node: \frame206276
-Node: \dashbox206716
-Node: quotation & quote207851
-Node: tabbing208747
-Node: table214650
-Node: tabular216714
-Ref: tabular arrayrulewidth223051
-Ref: tabular arraystrech223291
-Ref: tabular doublerulesep223512
-Ref: tabular tabcolsep223648
-Node: \multicolumn224169
-Node: \vline228045
-Node: \cline229436
-Node: \hline230146
-Node: thebibliography230828
-Node: \bibitem233311
-Node: \cite235605
-Node: \nocite237473
-Node: Using BibTeX237981
-Node: theorem240152
-Node: titlepage241074
-Node: verbatim242357
-Node: \verb244170
-Node: verse246263
-Node: Line breaking247490
-Node: \\248856
-Node: \obeycr & \restorecr251289
-Node: \newline252100
-Node: \- (hyphenation)253129
-Node: \discretionary254767
-Node: \fussy & \sloppy255655
-Node: sloppypar256438
-Node: \hyphenation257584
-Node: \linebreak & \nolinebreak258178
-Node: Page breaking259326
-Node: \clearpage & \cleardoublepage261356
-Node: \newpage262876
-Node: \enlargethispage264174
-Node: \pagebreak & \nopagebreak265130
-Node: Footnotes266797
-Node: \footnote267943
-Ref: footnote footnoterule269211
-Ref: footnote footnotesep269822
-Node: \footnotemark270888
-Node: \footnotetext273227
-Node: Footnotes in section headings273829
-Node: Footnotes in a table274662
-Node: Footnotes of footnotes277584
-Node: Definitions278288
-Node: \newcommand & \renewcommand279264
-Node: \providecommand284565
-Node: \makeatletter & \makeatother285730
-Node: \@ifstar287832
-Node: \newcounter291317
-Node: \newlength293037
-Node: \newsavebox293859
-Node: \newenvironment & \renewenvironment294838
-Node: \newtheorem300162
-Node: \newfont303734
-Node: \protect304967
-Node: \ignorespaces & \ignorespacesafterend307355
-Node: Counters310093
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol311794
-Node: \usecounter314419
-Node: \value315278
-Node: \setcounter316331
-Node: \addtocounter316927
-Node: \refstepcounter317381
-Node: \stepcounter318050
-Node: \day & \month & \year318603
-Node: Lengths319414
-Node: Units of length323890
-Ref: units of length pt324093
-Ref: units of length pc324193
-Ref: units of length in324216
-Ref: units of length bp324242
-Ref: units of length cm324373
-Ref: units of length mm324395
-Ref: units of length dd324417
-Ref: units of length cc324449
-Ref: units of length sp324474
-Ref: Lengths/em324505
-Ref: Lengths/en324505
-Ref: Lengths/ex324505
-Ref: units of length em324505
-Ref: units of length en324505
-Ref: units of length ex324505
-Node: \setlength325361
-Node: \addtolength326446
-Node: \settodepth327521
-Node: \settoheight328399
-Node: \settowidth329292
-Node: Making paragraphs330160
-Node: \par331931
-Node: \indent & \noindent333878
-Node: \parindent & \parskip335413
-Node: Marginal notes336720
-Ref: marginal notes marginparpush338116
-Ref: marginal notes marginparsep338290
-Ref: marginal notes marginparwidth338422
-Node: Math formulas338771
-Node: Subscripts & superscripts342939
-Node: Math symbols345100
-Node: Arrows368871
-Node: \boldmath & \unboldmath370059
-Node: Blackboard bold371578
-Node: Calligraphic372380
-Node: Delimiters372911
-Node: \left & \right375099
-Node: \bigl & \bigr etc.379107
-Node: Dots381860
-Ref: ellipses cdots382291
-Ref: ellipses ddots382436
-Ref: ellipses ldots382517
-Ref: ellipses vdots382934
-Node: Greek letters384118
-Node: Math functions385797
-Node: Math accents387441
-Node: Over- and Underlining388340
-Node: Spacing in math mode390167
-Ref: spacing in math mode thickspace391102
-Ref: spacing in math mode medspace391527
-Ref: Spacing in math mode/\thinspace391954
-Ref: spacing in math mode thinspace391954
-Ref: spacing in math mode negthinspace392435
-Ref: spacing in math mode quad392762
-Ref: spacing in math mode qquad393018
-Node: \smash393281
-Node: \phantom & \vphantom & \hphantom395498
-Node: Math miscellany397536
-Node: Colon character & \colon398042
-Node: \*398735
-Node: \frac399315
-Node: \sqrt399686
-Node: \stackrel400272
-Node: Modes400545
-Ref: modes paragraph mode400995
-Ref: modes lr mode401191
-Ref: modes math mode401797
-Ref: modes vertical mode402132
-Ref: modes internal vertical mode402303
-Ref: modes inner paragraph mode402776
-Ref: modes outer paragraph mode402776
-Node: \ensuremath403190
-Node: Page styles403895
-Node: \maketitle404658
-Node: \pagenumbering407676
-Node: \pagestyle409664
-Node: \thispagestyle413166
-Node: Spaces414120
-Node: \enspace & \quad & \qquad415561
-Node: \hspace416476
-Node: \hfill418314
-Node: \hss419378
-Node: \spacefactor420072
-Node: \@423459
-Ref: \AT423559
-Node: \frenchspacing425499
-Node: \normalsfcodes426334
-Node: \(SPACE)426581
-Node: ~428371
-Node: \thinspace & \negthinspace430948
-Node: \/432119
-Node: \hrulefill & \dotfill434075
-Node: \bigskip & \medskip & \smallskip435431
-Ref: bigskip436249
-Ref: medskip436453
-Ref: smallskip436662
-Node: \bigbreak & \medbreak & \smallbreak437323
-Node: \strut438309
-Node: \vspace441504
-Node: \vfill443068
-Node: \addvspace443996
-Node: Boxes445992
-Node: \mbox & \makebox446698
-Ref: mbox makebox depth447966
-Ref: mbox makebox height447966
-Ref: mbox makebox width447966
-Ref: mbox makebox totalheight447966
-Node: \fbox & \framebox450061
-Ref: fbox framebox fboxrule451375
-Ref: fbox framebox fboxsep451565
-Node: \parbox452655
-Node: \raisebox454961
-Ref: raisebox depth455934
-Ref: raisebox height455934
-Ref: raisebox width455934
-Ref: raisebox totalheight455934
-Node: \sbox & \savebox456635
-Node: lrbox459697
-Node: \usebox460583
-Node: Color461022
-Node: Color package options461821
-Node: Color models463467
-Ref: color models cmyk464264
-Ref: color models gray464627
-Ref: color models rgb464776
-Ref: color models RGB465113
-Ref: color models named465488
-Node: Commands for color465776
-Node: Define colors466191
-Node: Colored text466916
-Node: Colored boxes469313
-Node: Colored pages470702
-Node: Graphics471395
-Node: Graphics package options473522
-Node: Graphics package configuration476275
-Node: \graphicspath477077
-Node: \DeclareGraphicsExtensions480035
-Node: \DeclareGraphicsRule481853
-Node: Commands for graphics485034
-Node: \includegraphics485539
-Ref: includegraphics width490593
-Ref: includegraphics height491126
-Ref: includegraphics totalheight491532
-Ref: includegraphics keepaspectratio491796
-Ref: includegraphics viewport493482
-Ref: includegraphics trim493877
-Ref: includegraphics clip494333
-Ref: includegraphics page494593
-Ref: includegraphics pagebox494684
-Ref: includegraphics interpolate495549
-Ref: includegraphics quiet495754
-Ref: includegraphics draft495915
-Ref: includegraphics bb496720
-Ref: includegraphics bbllx497118
-Ref: includegraphics bblly497118
-Ref: includegraphics bburx497118
-Ref: includegraphics bbury497118
-Ref: includegraphics natwidth497260
-Ref: includegraphics natheight497260
-Ref: includegraphics hiresbb497446
-Ref: includegraphics type498208
-Ref: includegraphics ext498248
-Ref: includegraphics read498351
-Ref: includegraphics command498468
-Node: \rotatebox498714
-Node: \scalebox501568
-Node: \resizebox502624
-Node: Special insertions503816
-Node: Reserved characters504684
-Node: Upper and lower case505944
-Node: Symbols by font position508330
-Node: Text symbols509009
-Node: Accents513194
-Node: \accent515347
-Node: Additional Latin letters517109
-Ref: Non-English characters517291
-Node: Inputenc package518310
-Node: \rule520447
-Node: \today521612
-Node: Splitting the input522548
-Node: \endinput524290
-Node: \include & \includeonly525593
-Node: \input529890
-Node: Front/back matter531105
-Node: Table of contents etc.531438
-Node: \addcontentsline535263
-Node: \addtocontents538105
-Node: \nofiles539696
-Node: Indexes540428
-Node: \index542036
-Node: makeindex547141
-Ref: makeindex preamble548809
-Ref: makeindex postamble548949
-Ref: makeindex group skip549034
-Ref: makeindex letheadflag549367
-Ref: makeindex lethead prefix549828
-Ref: makeindex lethead suffix549980
-Ref: makeindex item 0550128
-Ref: makeindex item 1550208
-Ref: makeindex item 2550283
-Ref: makeindex item 01550361
-Ref: makeindex item x1550466
-Ref: makeindex item 12550671
-Ref: makeindex item x2550779
-Ref: makeindex delim 0550939
-Ref: makeindex delim 1551069
-Ref: makeindex delim 2551199
-Ref: makeindex delim n551325
-Ref: makeindex delim r551460
-Ref: makeindex line max551568
-Ref: makeindex indent space551703
-Ref: makeindex indent length551798
-Ref: makeindex page precedence551983
-Node: \printindex552857
-Node: Glossaries553330
-Node: \newglossaryentry555297
-Node: \gls556764
-Node: Letters557558
-Node: \address561176
-Node: \cc561987
-Node: \closing562429
-Node: \encl562743
-Node: \location563157
-Node: \makelabels563421
-Node: \name565738
-Node: \opening565979
-Node: \ps566260
-Node: \signature566549
-Node: \telephone567777
-Node: Input/output568142
-Node: \openin & \openout568872
-Node: \read571615
-Node: \typein572802
-Node: \typeout574062
-Node: \write575112
-Node: \write and security579839
-Node: \message580783
-Node: \wlog582612
-Node: \write18583113
-Node: Command line interface586604
-Ref: Command line586768
-Node: Command line options588851
-Ref: interaction modes589847
-Ref: output directory590801
-Node: Command line input592500
-Node: Jobname594329
-Node: Recovering from errors595144
-Node: Document templates596489
-Node: beamer template596923
-Node: article template597565
-Node: book template598028
-Node: Larger book template598507
-Node: Index600049
-Ref: Command Index600135
+Node: \label128945
+Node: \pageref130765
+Node: \ref131555
+Node: xr package132550
+Node: Environments134384
+Node: abstract136386
+Node: array137975
+Node: center140867
+Node: \centering142620
+Node: description144117
+Node: displaymath146334
+Node: document148030
+Node: \AtBeginDocument148460
+Node: \AtEndDocument149084
+Node: enumerate149728
+Ref: enumerate enumi151591
+Ref: enumerate enumii151591
+Ref: enumerate enumiii151591
+Ref: enumerate enumiv151591
+Ref: enumerate labelenumi151989
+Ref: enumerate labelenumii151989
+Ref: enumerate labelenumiii151989
+Ref: enumerate labelenumiv151989
+Node: eqnarray152528
+Node: equation154524
+Node: figure155192
+Node: filecontents157346
+Node: flushleft159255
+Node: \raggedright160282
+Node: flushright161480
+Node: \raggedleft162304
+Node: itemize163175
+Ref: itemize labelitemi164723
+Ref: itemize labelitemii164723
+Ref: itemize labelitemiii164723
+Ref: itemize labelitemiv164723
+Ref: itemize leftmargin165382
+Ref: itemize leftmargini165382
+Ref: itemize leftmarginii165382
+Ref: itemize leftmarginiii165382
+Ref: itemize leftmarginiv165382
+Ref: itemize leftmarginv165382
+Ref: itemize leftmarginvi165382
+Node: letter166864
+Node: list167102
+Ref: list makelabel169549
+Ref: list itemindent170934
+Ref: list itemsep171071
+Ref: list labelsep171724
+Ref: list labelwidth171887
+Ref: list leftmargin172898
+Ref: list listparindent173751
+Ref: list parsep173982
+Ref: list partopsep174450
+Ref: list rightmargin175248
+Ref: list topsep175433
+Ref: list beginparpenalty179008
+Ref: list itempenalty179107
+Ref: list endparpenalty179211
+Node: \item180082
+Node: trivlist181328
+Node: math182856
+Node: minipage183162
+Node: picture188691
+Node: \put194912
+Node: \multiput195477
+Node: \qbezier196216
+Node: \graphpaper197689
+Node: \line198483
+Node: \linethickness200457
+Node: \thinlines200906
+Node: \thicklines201317
+Node: \circle201701
+Node: \oval202243
+Node: \shortstack203219
+Node: \vector204616
+Node: \makebox (picture)205530
+Node: \framebox (picture)206712
+Node: \frame208185
+Node: \dashbox208625
+Node: quotation & quote209760
+Node: tabbing210656
+Node: table216559
+Node: tabular218623
+Ref: tabular arrayrulewidth224960
+Ref: tabular arraystrech225200
+Ref: tabular doublerulesep225421
+Ref: tabular tabcolsep225557
+Node: \multicolumn226078
+Node: \vline229954
+Node: \cline231345
+Node: \hline232055
+Node: thebibliography232737
+Node: \bibitem235220
+Node: \cite237514
+Node: \nocite239382
+Node: Using BibTeX239890
+Node: theorem242061
+Node: titlepage242983
+Node: verbatim244266
+Node: \verb246079
+Node: verse248172
+Node: Line breaking249399
+Node: \\250765
+Node: \obeycr & \restorecr253198
+Node: \newline254009
+Node: \- (hyphenation)255038
+Node: \discretionary256676
+Node: \fussy & \sloppy257564
+Node: sloppypar258347
+Node: \hyphenation259493
+Node: \linebreak & \nolinebreak260087
+Node: Page breaking261235
+Node: \clearpage & \cleardoublepage263265
+Node: \newpage264785
+Node: \enlargethispage266083
+Node: \pagebreak & \nopagebreak267039
+Node: Footnotes268706
+Node: \footnote269852
+Ref: footnote footnoterule271120
+Ref: footnote footnotesep271731
+Node: \footnotemark272797
+Node: \footnotetext275136
+Node: Footnotes in section headings275738
+Node: Footnotes in a table276571
+Node: Footnotes of footnotes279493
+Node: Definitions280197
+Node: \newcommand & \renewcommand281173
+Node: \providecommand286474
+Node: \makeatletter & \makeatother287639
+Node: \@ifstar289741
+Node: \newcounter293226
+Node: \newlength294946
+Node: \newsavebox295768
+Node: \newenvironment & \renewenvironment296747
+Node: \newtheorem302071
+Node: \newfont305643
+Node: \protect306876
+Node: \ignorespaces & \ignorespacesafterend309264
+Node: Counters312002
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol313703
+Node: \usecounter316328
+Node: \value317187
+Node: \setcounter318240
+Node: \addtocounter318836
+Node: \refstepcounter319290
+Node: \stepcounter319959
+Node: \day & \month & \year320512
+Node: Lengths321323
+Node: Units of length325799
+Ref: units of length pt326002
+Ref: units of length pc326102
+Ref: units of length in326125
+Ref: units of length bp326151
+Ref: units of length cm326282
+Ref: units of length mm326304
+Ref: units of length dd326326
+Ref: units of length cc326358
+Ref: units of length sp326383
+Ref: Lengths/em326414
+Ref: Lengths/en326414
+Ref: Lengths/ex326414
+Ref: units of length em326414
+Ref: units of length en326414
+Ref: units of length ex326414
+Node: \setlength327270
+Node: \addtolength328355
+Node: \settodepth329430
+Node: \settoheight330308
+Node: \settowidth331201
+Node: Making paragraphs332069
+Node: \par333840
+Node: \indent & \noindent335787
+Node: \parindent & \parskip337322
+Node: Marginal notes338629
+Ref: marginal notes marginparpush340025
+Ref: marginal notes marginparsep340199
+Ref: marginal notes marginparwidth340331
+Node: Math formulas340680
+Node: Subscripts & superscripts344848
+Node: Math symbols347009
+Node: Arrows370780
+Node: \boldmath & \unboldmath371968
+Node: Blackboard bold373487
+Node: Calligraphic374289
+Node: Delimiters374820
+Node: \left & \right377008
+Node: \bigl & \bigr etc.381016
+Node: Dots383769
+Ref: ellipses cdots384200
+Ref: ellipses ddots384345
+Ref: ellipses ldots384426
+Ref: ellipses vdots384843
+Node: Greek letters386027
+Node: Math functions387706
+Node: Math accents389350
+Node: Over- and Underlining390249
+Node: Spacing in math mode392076
+Ref: spacing in math mode thickspace393011
+Ref: spacing in math mode medspace393436
+Ref: Spacing in math mode/\thinspace393863
+Ref: spacing in math mode thinspace393863
+Ref: spacing in math mode negthinspace394344
+Ref: spacing in math mode quad394671
+Ref: spacing in math mode qquad394927
+Node: \smash395190
+Node: \phantom & \vphantom & \hphantom397407
+Node: Math miscellany399445
+Node: Colon character & \colon399951
+Node: \*400644
+Node: \frac401224
+Node: \sqrt401595
+Node: \stackrel402181
+Node: Modes402454
+Ref: modes paragraph mode402904
+Ref: modes lr mode403100
+Ref: modes math mode403706
+Ref: modes vertical mode404041
+Ref: modes internal vertical mode404212
+Ref: modes inner paragraph mode404685
+Ref: modes outer paragraph mode404685
+Node: \ensuremath405099
+Node: Page styles405804
+Node: \maketitle406567
+Node: \pagenumbering409585
+Node: \pagestyle411573
+Node: \thispagestyle415075
+Node: Spaces416029
+Node: \enspace & \quad & \qquad417470
+Node: \hspace418385
+Node: \hfill420223
+Node: \hss421287
+Node: \spacefactor421981
+Node: \@425368
+Ref: \AT425468
+Node: \frenchspacing427408
+Node: \normalsfcodes428243
+Node: \(SPACE)428490
+Node: ~430280
+Node: \thinspace & \negthinspace432857
+Node: \/434028
+Node: \hrulefill & \dotfill435984
+Node: \bigskip & \medskip & \smallskip437340
+Ref: bigskip438158
+Ref: medskip438362
+Ref: smallskip438571
+Node: \bigbreak & \medbreak & \smallbreak439232
+Node: \strut440218
+Node: \vspace443413
+Node: \vfill444977
+Node: \addvspace445905
+Node: Boxes447901
+Node: \mbox & \makebox448607
+Ref: mbox makebox depth449875
+Ref: mbox makebox height449875
+Ref: mbox makebox width449875
+Ref: mbox makebox totalheight449875
+Node: \fbox & \framebox451970
+Ref: fbox framebox fboxrule453284
+Ref: fbox framebox fboxsep453474
+Node: \parbox454564
+Node: \raisebox456870
+Ref: raisebox depth457843
+Ref: raisebox height457843
+Ref: raisebox width457843
+Ref: raisebox totalheight457843
+Node: \sbox & \savebox458544
+Node: lrbox461606
+Node: \usebox462492
+Node: Color462931
+Node: Color package options463730
+Node: Color models465376
+Ref: color models cmyk466173
+Ref: color models gray466536
+Ref: color models rgb466685
+Ref: color models RGB467022
+Ref: color models named467397
+Node: Commands for color467685
+Node: Define colors468100
+Node: Colored text468825
+Node: Colored boxes471222
+Node: Colored pages472611
+Node: Graphics473304
+Node: Graphics package options475431
+Node: Graphics package configuration478184
+Node: \graphicspath478986
+Node: \DeclareGraphicsExtensions481944
+Node: \DeclareGraphicsRule483762
+Node: Commands for graphics486943
+Node: \includegraphics487448
+Ref: includegraphics width492502
+Ref: includegraphics height493035
+Ref: includegraphics totalheight493441
+Ref: includegraphics keepaspectratio493705
+Ref: includegraphics viewport495391
+Ref: includegraphics trim495786
+Ref: includegraphics clip496242
+Ref: includegraphics page496502
+Ref: includegraphics pagebox496593
+Ref: includegraphics interpolate497458
+Ref: includegraphics quiet497663
+Ref: includegraphics draft497824
+Ref: includegraphics bb498629
+Ref: includegraphics bbllx499027
+Ref: includegraphics bblly499027
+Ref: includegraphics bburx499027
+Ref: includegraphics bbury499027
+Ref: includegraphics natwidth499169
+Ref: includegraphics natheight499169
+Ref: includegraphics hiresbb499355
+Ref: includegraphics type500117
+Ref: includegraphics ext500157
+Ref: includegraphics read500260
+Ref: includegraphics command500377
+Node: \rotatebox500623
+Node: \scalebox503477
+Node: \resizebox504533
+Node: Special insertions505725
+Node: Reserved characters506593
+Node: Upper and lower case507853
+Node: Symbols by font position510239
+Node: Text symbols510918
+Node: Accents515103
+Node: \accent517256
+Node: Additional Latin letters519018
+Ref: Non-English characters519200
+Node: Inputenc package520219
+Node: \rule522350
+Node: \today523515
+Node: Splitting the input524451
+Node: \endinput526193
+Node: \include & \includeonly527496
+Node: \input531793
+Node: Front/back matter533008
+Node: Table of contents etc.533341
+Node: \addcontentsline537166
+Node: \addtocontents540008
+Node: \nofiles541599
+Node: Indexes542331
+Node: \index543939
+Node: makeindex549044
+Ref: makeindex preamble550712
+Ref: makeindex postamble550852
+Ref: makeindex group skip550937
+Ref: makeindex letheadflag551270
+Ref: makeindex lethead prefix551731
+Ref: makeindex lethead suffix551883
+Ref: makeindex item 0552031
+Ref: makeindex item 1552111
+Ref: makeindex item 2552186
+Ref: makeindex item 01552264
+Ref: makeindex item x1552369
+Ref: makeindex item 12552574
+Ref: makeindex item x2552682
+Ref: makeindex delim 0552842
+Ref: makeindex delim 1552972
+Ref: makeindex delim 2553102
+Ref: makeindex delim n553228
+Ref: makeindex delim r553363
+Ref: makeindex line max553471
+Ref: makeindex indent space553606
+Ref: makeindex indent length553701
+Ref: makeindex page precedence553886
+Node: \printindex554760
+Node: Glossaries555233
+Node: \newglossaryentry557200
+Node: \gls558667
+Node: Letters559461
+Node: \address563079
+Node: \cc563890
+Node: \closing564332
+Node: \encl564646
+Node: \location565060
+Node: \makelabels565324
+Node: \name567641
+Node: \opening567882
+Node: \ps568163
+Node: \signature568452
+Node: \telephone569680
+Node: Input/output570045
+Node: \openin & \openout570775
+Node: \read573518
+Node: \typein574705
+Node: \typeout575965
+Node: \write577015
+Node: \write and security581742
+Node: \message582686
+Node: \wlog584515
+Node: \write18585016
+Node: Command line interface588507
+Ref: Command line588671
+Node: Command line options590754
+Ref: interaction modes591750
+Ref: output directory592704
+Node: Command line input594403
+Node: Jobname596232
+Node: Recovering from errors597047
+Node: Document templates598392
+Node: beamer template598826
+Node: article template599468
+Node: book template599931
+Node: Larger book template600410
+Node: Index601952
+Ref: Command Index602038
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2021-05-24 21:27:21 UTC (rev 910)
+++ trunk/latex2e.texi 2021-05-25 18:07:16 UTC (rev 911)
@@ -4162,6 +4162,7 @@
* \label:: Assign a symbolic name to a piece of text.
* \pageref:: Refer to a page number.
* \ref:: Refer to a section, figure or similar.
+* xr package:: References from another document.
@end menu
@@ -4313,6 +4314,81 @@
reference. See the documentation on CTAN.
+ at node xr package
+ at section @code{xr} Package
+
+ at findex @code{xr} package
+ at findex @code{xr-hyper} package
+ at findex \externaldocument
+ at cindex cross referencing, across documents
+
+Synopsis:
+
+ at example
+\usepackage@{xr@}
+ \externaldocument@{@var{document-basename}@}
+ at end example
+
+or
+
+ at example
+\usepackage@{xr@}
+ \externaldocument[@var{reference-prefix}]@{@var{document-basename}@}
+ at end example
+
+Make cross references to the external document
+ at code{@var{document-basename}.tex}.
+
+Here is an example. If @code{lectures.tex} has this in the preamble
+
+ at example
+\usepackage@{xr@}
+ \externaldocument@{exercises@}
+ \externaldocument[H-]@{hints@}
+ \externaldocument@{answers@}
+ at end example
+
+then it can use cross reference labels from the other three documents.
+Suppose that @code{exercises.tex} has an enumerated list containing
+this,
+
+ at example
+\item \label@{exer:EulersThm@} What if every vertex has odd degree?
+ at end example
+
+and @code{hints.tex} has an enumerated list with this,
+
+ at example
+\item \label@{exer:EulersThm@} Distinguish the case of two vertices.
+ at end example
+
+and @code{answers.tex} has an enumerated list with this.
+
+ at example
+\item \label@{ans:EulersThm@} There is no Euler path, except if there
+ are exactly two vertices.
+ at end example
+
+After compiling the exercises, hints, and answers documents, entering
+this in the body of @code{lectures.tex} will result in the lectures
+getting the reference numbers used in the other documents.
+
+ at example
+See Exercise~\ref@{exer:EulersThm@}, with Hint~\ref@{H-exer:EulersThm@}.
+The solution is Answer~\ref@{ans:EulersThm@}.
+ at end example
+
+The prefix @code{H-} for the reference from the hints file is needed
+because the label in the hints file is the same as the label in the
+exercises file. Without that prefix, both references would get the
+number from the later file.
+
+Note: if the document uses the @code{hyperref} package then in place of
+ at code{xr}, put @code{\usepackage@{xr-hyper@}} before the
+ at code{\usepackage@{hyperref@}}. Also, if any of the multiple documents
+uses @code{hyperref} then they all must use it.
+
+
@node Environments
@chapter Environments
@@ -17979,7 +18055,7 @@
In a computer file, the characters are stored as binary according to
some scheme, called the encoding. There are many different encodings.
The simplest is ASCII, but it does not accomodate many characters. For
-instance to get the a-umlaut character @"{a} in an ASCII-encoded text
+instance, to get the a-umlaut character @"{a} in an ASCII-encoded text
file a user must enter @code{\"a}, which makes the file hard to read and
also means that @TeX{} won't hyphenation the word containing that
character. Often a more inclusive encoding is more convenient. The
More information about the latexrefman-commits
mailing list.