/usr/share/doc/texinfo/html/Splitting.html is in texinfo-doc-nonfree 4.13a-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 | <html lang="en">
<head>
<title>Splitting - GNU Texinfo 4.13</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Texinfo 4.13">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Running-Info_002dValidate.html#Running-Info_002dValidate" title="Running Info-Validate">
<link rel="prev" href="Tagifying.html#Tagifying" title="Tagifying">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual is for GNU Texinfo (version 4.13, 18 September 2008),
a documentation system that can produce both online information and a
printed manual from a single source.
Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
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.2 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 are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Splitting"></a>
<p>
Previous: <a rel="previous" accesskey="p" href="Tagifying.html#Tagifying">Tagifying</a>,
Up: <a rel="up" accesskey="u" href="Running-Info_002dValidate.html#Running-Info_002dValidate">Running Info-Validate</a>
<hr>
</div>
<!-- node-name, next, previous, up -->
<h4 class="subsection">F.6.4 Splitting a File Manually</h4>
<p><a name="index-Splitting-an-Info-file-manually-1480"></a><a name="index-Info-file_002c-splitting-manually-1481"></a>
You should split a large file or else let the
<code>texinfo-format-buffer</code> or <code>makeinfo-buffer</code> command do it
for you automatically. (Generally you will let one of the formatting
commands do this job for you. See <a href="Creating-an-Info-File.html#Creating-an-Info-File">Creating an Info File</a>.)
<p>The split-off files are called the indirect subfiles.
<p>Info files are split to save memory. With smaller files, Emacs does not
have make such a large buffer to hold the information.
<p>If an Info file has more than 30 nodes, you should also make a tag
table for it. See <a href="Using-Info_002dvalidate.html#Using-Info_002dvalidate">Using Info-validate</a>, for information
about creating a tag table. (Again, tag tables are usually created
automatically by the formatting command; you only need to create a tag
table yourself if you are doing the job manually. Most likely, you
will do this for a large, unsplit file on which you have run
<code>Info-validate</code>.)
<!-- Info-split is autoloaded in `loaddefs.el' in Emacs 18.51 -->
<p>Visit the Info file you wish to tagify and split and type the two
commands:
<pre class="example"> M-x Info-tagify
M-x Info-split
</pre>
<p class="noindent">(Note that the ‘<samp><span class="samp">I</span></samp>’ in ‘<samp><span class="samp">Info</span></samp>’ is upper case.)
<p>When you use the <code>Info-split</code> command, the buffer is modified into a
(small) Info file which lists the indirect subfiles. This file should be
saved in place of the original visited file. The indirect subfiles are
written in the same directory the original file is in, with names generated
by appending ‘<samp><span class="samp">-</span></samp>’ and a number to the original file name.
<p>The primary file still functions as an Info file, but it contains just
the tag table and a directory of subfiles.
<!-- These are no longer ``new'', and the explanations -->
<!-- are all given elsewhere anyway, I think. -karl, 25apr97. -->
<!-- So ignore the entire appendix. -->
</body></html>
|