D.2 texinfo-multiple-files-update
=================================

GNU Emacs Texinfo mode provides the texinfo-multiple-files-update
command.  This command creates or updates `Next', `Previous', and `Up'
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 whether you call it with optional arguments, the command
updates only the pointers in the first @node line of the
included files or all of them:

M-x texinfo-multiple-files-update
Called without any arguments:

- Create or update the `Next', `Previous', and `Up' pointers of the
first @node line in each file included in an outer or overall
Texinfo file.

- Create or update the `Top' level node pointers of the outer or
overall file.

- Create or update a main menu in the outer file.

C-u M-x texinfo-multiple-files-update
Called with C-u as a prefix argument:

- Create or update pointers in the first @node line in each
included file.

- Create or update the `Top' level node pointers of the outer file.

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

C-u 8 M-x texinfo-multiple-files-update
Called with a numeric prefix argument, such as C-u 8:

- Create or update all the `Next', `Previous', and `Up' pointers
of all the included files.

- Create or update all the menus of all the included
files.

- Create or update the `Top' level node pointers of the outer or
overall file.

- And then create a master menu in the outer file.  This is similar to
invoking texinfo-master-menu with an argument when you are
working with just one file.

Note the use of the prefix argument in interactive use: with a regular
prefix argument, just C-u, the
texinfo-multiple-files-update command inserts a master menu;
with a numeric prefix argument, such as C-u 8, the command
updates every pointer and menu in all the files and then inserts a
master menu.


