Viewing File: /usr/share/doc/texinfo/html/texinfo_002dmultiple_002dfiles_002dupdate.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 6.7, 23 September 2019),
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, 2017, 2018, 2019 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". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>texinfo-multiple-files-update (GNU Texinfo 6.7)</title>

<meta name="description" content="texinfo-multiple-files-update (GNU Texinfo 6.7)">
<meta name="keywords" content="texinfo-multiple-files-update (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<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="Include-Files.html" rel="up" title="Include Files">
<link href="Include-Files-Requirements.html" rel="next" title="Include Files Requirements">
<link href="Using-Include-Files.html" rel="prev" title="Using Include Files">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {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}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<span id="texinfo_002dmultiple_002dfiles_002dupdate"></span><div class="header">
<p>
Next: <a href="Include-Files-Requirements.html" accesskey="n" rel="next">Include Files Requirements</a>, Previous: <a href="Using-Include-Files.html" accesskey="p" rel="prev">Using Include Files</a>, Up: <a href="Include-Files.html" accesskey="u" rel="up">Include Files</a> &nbsp; [<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="texinfo_002dmultiple_002dfiles_002dupdate-1"></span><h3 class="section">18.2 <code>texinfo-multiple-files-update</code></h3>

<span id="index-texinfo_002dmultiple_002dfiles_002dupdate"></span>

<p>GNU Emacs Texinfo mode provides the
<code>texinfo-multiple-files-update</code> command.  This command creates or
updates &lsquo;Next&rsquo;, &lsquo;Previous&rsquo;, and &lsquo;Up&rsquo; pointers of included files as
well as those in the outer or overall Texinfo file, and it creates or
updates a main menu in the outer file.  Depending on whether you call
it with optional arguments, the command updates only the pointers in
the first <code>@node</code> line of the included files or all of them:
</p>
<dl compact="compact">
<dt><kbd>M-x texinfo-multiple-files-update</kbd></dt>
<dd><p>Called without any arguments:
</p>
<ul class="no-bullet">
<li>- Create or update the &lsquo;Next&rsquo;, &lsquo;Previous&rsquo;, and &lsquo;Up&rsquo; pointers of the
first <code>@node</code> line in each file included in an outer or overall
Texinfo file.

</li><li>- Create or update the &lsquo;Top&rsquo; level node pointers of the outer or
overall file.

</li><li>- Create or update a main menu in the outer file.
</li></ul>

</dd>
<dt><kbd>C-u M-x texinfo-multiple-files-update</kbd></dt>
<dd><p>Called with <kbd>C-u</kbd> as a prefix argument:
</p>
<ul class="no-bullet">
<li>- Create or update pointers in the first <code>@node</code> line in each
included file.

</li><li>- Create or update the &lsquo;Top&rsquo; level node pointers of the outer file.

</li><li>- Create and insert a master menu in the outer file.  The master menu
is made from all the menus in all the included files.
</li></ul>

</dd>
<dt><kbd>C-u 8 M-x texinfo-multiple-files-update</kbd></dt>
<dd><p>Called with a numeric prefix argument, such as <kbd>C-u 8</kbd>:
</p>
<ul class="no-bullet">
<li>- Create or update <em>all</em> the &lsquo;Next&rsquo;, &lsquo;Previous&rsquo;, and &lsquo;Up&rsquo; pointers
of all the included files.

</li><li>- Create or update <em>all</em> the menus of all the included
files.

</li><li>- Create or update the &lsquo;Top&rsquo; level node pointers of the outer or
overall file.

</li><li>- And then create a master menu in the outer file.  This is similar to
invoking <code>texinfo-master-menu</code> with an argument when you are
working with just one file.
</li></ul>
</dd>
</dl>

<p>Note the use of the prefix argument in interactive use: with a regular
prefix argument, just <kbd><span class="nolinebreak">C-u</span></kbd><!-- /@w -->, the
<code>texinfo-multiple-files-update</code> command inserts a master menu;
with a numeric prefix argument, such as <kbd>C-u 8</kbd>, the command
updates <em>every</em> pointer and menu in <em>all</em> the files and
then inserts a master menu.
</p>

<hr>
<div class="header">
<p>
Next: <a href="Include-Files-Requirements.html" accesskey="n" rel="next">Include Files Requirements</a>, Previous: <a href="Using-Include-Files.html" accesskey="p" rel="prev">Using Include Files</a>, Up: <a href="Include-Files.html" accesskey="u" rel="up">Include Files</a> &nbsp; [<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>
Back to Directory File Manager