JezK
Edit File: Splitting.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>Splitting (GNU Texinfo 6.8)</title> <meta name="description" content="Splitting (GNU Texinfo 6.8)"> <meta name="keywords" content="Splitting (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="Running-Info_002dvalidate.html" rel="up" title="Running Info-validate"> <link href="Tagifying.html" rel="prev" title="Tagifying"> <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="subsection" id="Splitting"> <div class="header"> <p> Previous: <a href="Tagifying.html" accesskey="p" rel="prev">Tagifying a File</a>, Up: <a href="Running-Info_002dvalidate.html" accesskey="u" rel="up">Finding Badly Referenced Nodes</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="Splitting-a-File-Manually"></span><h4 class="subsubsection">D.9.6.4 Splitting a File Manually</h4> <span id="index-Splitting-an-Info-file-manually"></span> <span id="index-Info-files-3"></span> <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</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 to 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 <code>Info-validate</code></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 ‘<samp>I</samp>’ in ‘<samp>Info</samp>’ 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 ‘<samp>-</samp>’ 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> </div> <hr> <div class="header"> <p> Previous: <a href="Tagifying.html">Tagifying a File</a>, Up: <a href="Running-Info_002dvalidate.html">Finding Badly Referenced Nodes</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> </body> </html>