18.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 on 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.