/usr/share/doc/texinfo/html/Updating-Commands.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 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 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 | <html lang="en">
<head>
<title>Updating Commands - 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="Updating-Nodes-and-Menus.html#Updating-Nodes-and-Menus" title="Updating Nodes and Menus">
<link rel="next" href="Updating-Requirements.html#Updating-Requirements" title="Updating Requirements">
<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="Updating-Commands"></a>
<p>
Next: <a rel="next" accesskey="n" href="Updating-Requirements.html#Updating-Requirements">Updating Requirements</a>,
Up: <a rel="up" accesskey="u" href="Updating-Nodes-and-Menus.html#Updating-Nodes-and-Menus">Updating Nodes and Menus</a>
<hr>
</div>
<h4 class="subsection">2.5.1 The Updating Commands</h4>
<p>You can use the updating commands to:
<ul>
<li>insert or update the `Next', `Previous', and `Up' pointers of a
node,
<li>insert or update the menu for a section, and
<li>create a master menu for a Texinfo source file.
</ul>
<p>You can also use the commands to update all the nodes and menus in a
region or in a whole Texinfo file.
<p>The updating commands work only with conventional Texinfo files, which
are structured hierarchically like books. In such files, a structuring
command line must follow closely after each <code>@node</code> line, except
for the `Top' <code>@node</code> line. (A <dfn>structuring command line</dfn> is
a line beginning with <code>@chapter</code>, <code>@section</code>, or other
similar command.)
<p>You can write the structuring command line on the line that follows
immediately after an <code>@node</code> line or else on the line that
follows after a single <code>@comment</code> line or a single
<code>@ifinfo</code> line. You cannot interpose more than one line between
the <code>@node</code> line and the structuring command line; and you may
interpose only an <code>@comment</code> line or an <code>@ifinfo</code> line.
<p>Commands which work on a whole buffer require that the `Top' node be
followed by a node with an <code>@chapter</code> or equivalent-level command.
The menu updating commands will not create a main or master menu for a
Texinfo file that has only <code>@chapter</code>-level nodes! The menu
updating commands only create menus <em>within</em> nodes for lower level
nodes. To create a menu of chapters, you must provide a `Top'
node.
<p>The menu updating commands remove menu entries that refer to other Info
files since they do not refer to nodes within the current buffer. This
is a deficiency. Rather than use menu entries, you can use cross
references to refer to other Info files. None of the updating commands
affect cross references.
<p>Texinfo mode has five updating commands that are used most often: two
are for updating the node pointers or menu of a single node (or a
region); two are for updating every node pointer and menu in a file;
and one, the <code>texinfo-master-menu</code> command, is for creating a
master menu for a complete file, and optionally, for updating every
node and menu in the whole Texinfo file.
<p>The <code>texinfo-master-menu</code> command is the primary command:
<dl>
<dt><kbd>C-c C-u m</kbd><dt><kbd>M-x texinfo-master-menu</kbd><dd><a name="index-texinfo_002dmaster_002dmenu-130"></a>Create or update a master menu that includes all the other menus
(incorporating the descriptions from pre-existing menus, if
any).
<p>With an argument (prefix argument, <kbd>C-u,</kbd> if interactive), first create or
update all the nodes and all the regular menus in the buffer before
constructing the master menu. (See <a href="The-Top-Node.html#The-Top-Node">The Top Node and Master Menu</a>, for more about a master menu.)
<p>For <code>texinfo-master-menu</code> to work, the Texinfo file must have a
`Top' node and at least one subsequent node.
<p>After extensively editing a Texinfo file, you can type the following:
<pre class="example"> C-u M-x texinfo-master-menu
<br>or<br>
C-u C-c C-u m
</pre>
<p class="noindent">This updates all the nodes and menus completely and all at once.
</dl>
<p>The other major updating commands do smaller jobs and are designed for
the person who updates nodes and menus as he or she writes a Texinfo
file.
<p>The commands are:
<dl>
<dt><kbd>C-c C-u C-n</kbd><dt><kbd>M-x texinfo-update-node</kbd><dd><a name="index-texinfo_002dupdate_002dnode-131"></a>Insert the `Next', `Previous', and `Up' pointers for the node that point is
within (i.e., for the <code>@node</code> line preceding point). If the
<code>@node</code> line has pre-existing `Next', `Previous', or `Up'
pointers in it, the old pointers are removed and new ones inserted.
With an argument (prefix argument, <kbd>C-u</kbd>, if interactive), this command
updates all <code>@node</code> lines in the region (which is the text
between point and mark).
<br><dt><kbd>C-c C-u C-m</kbd><dt><kbd>M-x texinfo-make-menu</kbd><dd><a name="index-texinfo_002dmake_002dmenu-132"></a>Create or update the menu in the node that point is within.
With an argument (<kbd>C-u</kbd> as prefix argument, if
interactive), the command makes or updates menus for the
nodes which are either within or a part of the
region.
<p>Whenever <code>texinfo-make-menu</code> updates an existing menu, the
descriptions from that menu are incorporated into the new menu. This
is done by copying descriptions from the existing menu to the entries
in the new menu that have the same node names. If the node names are
different, the descriptions are not copied to the new menu.
<br><dt><kbd>C-c C-u C-e</kbd><dt><kbd>M-x texinfo-every-node-update</kbd><dd><a name="index-texinfo_002devery_002dnode_002dupdate-133"></a>Insert or update the `Next', `Previous', and `Up' pointers for every
node in the buffer.
<br><dt><kbd>C-c C-u C-a</kbd><dt><kbd>M-x texinfo-all-menus-update</kbd><dd><a name="index-texinfo_002dall_002dmenus_002dupdate-134"></a>Create or update all the menus in the buffer. With an argument
(<kbd>C-u</kbd> as prefix argument, if interactive), first insert
or update all the node
pointers before working on the menus.
<p>If a master menu exists, the <code>texinfo-all-menus-update</code> command
updates it; but the command does not create a new master menu if none
already exists. (Use the <code>texinfo-master-menu</code> command for
that.)
<p>When working on a document that does not merit a master menu, you can
type the following:
<pre class="example"> C-u C-c C-u C-a
<br>or<br>
C-u M-x texinfo-all-menus-update
</pre>
<p class="noindent">This updates all the nodes and menus.
</dl>
<p>The <code>texinfo-column-for-description</code> variable specifies the
column to which menu descriptions are indented. By default, the value
is 32 although it can be useful to reduce it to as low as 24. You
can set the variable via customization (see <a href="../emacs/Changing-an-Option.html#Changing-an-Option">Changing an Option</a>) or with the <kbd>M-x set-variable</kbd>
command (see <a href="../emacs/Examining.html#Examining">Examining and Setting Variables</a>).
<p>Also, the <code>texinfo-indent-menu-description</code> command may be used to
indent existing menu descriptions to a specified column. Finally, if
you wish, you can use the <code>texinfo-insert-node-lines</code> command to
insert missing <code>@node</code> lines into a file. (See <a href="Other-Updating-Commands.html#Other-Updating-Commands">Other Updating Commands</a>, for more information.)
</body></html>
|