/usr/share/doc/texinfo/html/HTML-Xref-Mismatch.html is in texinfo-doc-nonfree 6.5.0-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.5, 25 August 2017),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016 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 the Front-Cover Texts being "A GNU Manual",
and with the Back-Cover Texts as in (a) below. A copy of the license
is included in the section entitled "GNU Free Documentation
License".
(a) The FSF's Back-Cover Text is: "You have the freedom to copy and
modify this GNU manual. Buying copies from the FSF supports it in
developing GNU and promoting software freedom." -->
<!-- Created by GNU Texinfo 6.4.90, http://www.gnu.org/software/texinfo/ -->
<head>
<title>HTML Xref Mismatch (GNU Texinfo 6.5)</title>
<meta name="description" content="HTML Xref Mismatch (GNU Texinfo 6.5)">
<meta name="keywords" content="HTML Xref Mismatch (GNU Texinfo 6.5)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Command-and-Variable-Index.html#Command-and-Variable-Index" rel="index" title="Command and Variable Index">
<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="HTML-Xref.html#HTML-Xref" rel="up" title="HTML Xref">
<link href="HTML-Xref-Configuration.html#HTML-Xref-Configuration" rel="next" title="HTML Xref Configuration">
<link href="HTML-Xref-8_002dbit-Character-Expansion.html#HTML-Xref-8_002dbit-Character-Expansion" rel="prev" title="HTML Xref 8-bit Character Expansion">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {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}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="HTML-Xref-Mismatch"></a>
<div class="header">
<p>
Next: <a href="HTML-Xref-Configuration.html#HTML-Xref-Configuration" accesskey="n" rel="next">HTML Xref Configuration</a>, Previous: <a href="HTML-Xref-8_002dbit-Character-Expansion.html#HTML-Xref-8_002dbit-Character-Expansion" accesskey="p" rel="prev">HTML Xref 8-bit Character Expansion</a>, Up: <a href="HTML-Xref.html#HTML-Xref" accesskey="u" rel="up">HTML Xref</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html#Command-and-Variable-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="HTML-Cross_002dreference-Mismatch"></a>
<h4 class="subsection">22.4.5 HTML Cross-reference Mismatch</h4>
<a name="index-HTML-cross_002dreference-mismatch"></a>
<a name="index-Mismatched-HTML-cross_002dreference-source-and-target"></a>
<p>As mentioned earlier (see <a href="HTML-Xref-Link-Basics.html#HTML-Xref-Link-Basics">HTML Xref Link Basics</a>), the generating
software may need to guess whether a given manual being cross
referenced is available in split or monolithic form—and, inevitably,
it might guess wrong. However, when the <em>referent</em> manual is
generated, it is possible to handle at least some mismatches.
</p>
<p>In the case where we assume the referent is split, but it is actually
available in mono, the only recourse would be to generate a
<samp>manual/</samp> subdirectory full of HTML files which redirect back to
the monolithic <samp>manual.html</samp>. Since this is essentially the same
as a split manual in the first place, it’s not very appealing.
</p>
<p>On the other hand, in the case where we assume the referent is mono,
but it is actually available in split, it is possible to use
JavaScript to redirect from the putatively monolithic
<samp>manual.html</samp> to the different <samp>manual/node.html</samp> files.
Here’s an example:
</p>
<div class="example">
<pre class="example">function redirect() {
switch (location.hash) {
case "#Node1":
location.replace("manual/Node1.html#Node1"); break;
case "#Node2" :
location.replace("manual/Node2.html#Node2"); break;
…
default:;
}
}
</pre></div>
<p>Then, in the <code><body></code> tag of <samp>manual.html</samp>:
</p>
<div class="example">
<pre class="example"><body onLoad="redirect();">
</pre></div>
<p>Once again, this is something the software which generated the
<em>referent</em> manual has to do in advance, it’s not something the
software generating the cross-reference in the present manual can
control.
</p>
</body>
</html>
|