/usr/share/doc/texinfo/html/Splitting.html

<!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 5.2, 26 September 2013),
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 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 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Texinfo 5.2: Splitting</title>

<meta name="description" content="GNU Texinfo 5.2: Splitting">
<meta name="keywords" content="GNU Texinfo 5.2: Splitting">
<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="Running-Info_002dvalidate.html#Running-Info_002dvalidate" rel="up" title="Running Info-validate">
<link href="Info-Format-Specification.html#Info-Format-Specification" rel="next" title="Info Format Specification">
<link href="Tagifying.html#Tagifying" rel="previous" title="Tagifying">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
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.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Splitting"></a>
<div class="header">
<p>
Previous: <a href="Tagifying.html#Tagifying" accesskey="p" rel="previous">Tagifying</a>, Up: <a href="Running-Info_002dvalidate.html#Running-Info_002dvalidate" accesskey="u" rel="up">Running <tt>Info-validate</tt></a> &nbsp; [<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="Splitting-a-File-Manually"></a>
<h4 class="subsection">E.6.4 Splitting a File Manually</h4>
<a name="index-Splitting-an-Info-file-manually"></a>
<a name="index-Info-file_002c-splitting-manually"></a>

<p>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>
<p>The split-off files are called the indirect subfiles.
</p>
<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>
<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 <tt>Info-validate</tt></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>.)
</p>
<p>Visit the Info file you wish to tagify and split and type the two
commands:
</p>
<div class="example">
<pre class="example">M-x Info-tagify
M-x Info-split
</pre></div>

<p>(Note that the &lsquo;<samp>I</samp>&rsquo; in &lsquo;<samp>Info</samp>&rsquo; is uppercase.)
</p>
<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 &lsquo;<samp>-</samp>&rsquo; and a number to the original file name.
</p>
<p>The primary file still functions as an Info file, but it contains just
the tag table and a directory of subfiles.
</p>

<hr>
<div class="header">
<p>
Previous: <a href="Tagifying.html#Tagifying" accesskey="p" rel="previous">Tagifying</a>, Up: <a href="Running-Info_002dvalidate.html#Running-Info_002dvalidate" accesskey="u" rel="up">Running <tt>Info-validate</tt></a> &nbsp; [<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>



</body>
</html>
texinfo-doc-nonfree 5.2.0-1 / usr / share / doc / texinfo / html / Splitting.html
