diff options
| author | Glenn Morris | 2021-04-29 11:42:03 -0700 |
|---|---|---|
| committer | Glenn Morris | 2021-04-29 11:42:03 -0700 |
| commit | 68bf917896daa10601c3fdff172205e9aa06d155 (patch) | |
| tree | c7419211aa93e2ee2e1de6ec525ba191aea52715 | |
| parent | a8aa217bff255aa92eae5207c10df8877b0d137a (diff) | |
| download | emacs-68bf917896daa10601c3fdff172205e9aa06d155.tar.gz emacs-68bf917896daa10601c3fdff172205e9aa06d155.zip | |
Automatically generate texinfo.el internal autoloads
* lisp/textmodes/texinfo.el: Replace manual autoloads.
* lisp/textmodes/makeinfo.el (makeinfo-region, makeinfo-buffer)
(makeinfo-recenter-compilation-buffer):
* lisp/textmodes/texnfo-upd.el (texinfo-make-menu)
(texinfo-all-menus-update, texinfo-start-menu-description)
(texinfo-indent-menu-description, texinfo-master-menu)
(texinfo-update-node, texinfo-every-node-update)
(texinfo-sequential-node-update, texinfo-insert-node-lines)
(texinfo-multiple-files-update):
Add autoload cookies, and set generated-autoload-file.
| -rw-r--r-- | lisp/textmodes/makeinfo.el | 7 | ||||
| -rw-r--r-- | lisp/textmodes/texinfo.el | 192 | ||||
| -rw-r--r-- | lisp/textmodes/texnfo-upd.el | 14 |
3 files changed, 22 insertions, 191 deletions
diff --git a/lisp/textmodes/makeinfo.el b/lisp/textmodes/makeinfo.el index 653540ad415..13367a09bcf 100644 --- a/lisp/textmodes/makeinfo.el +++ b/lisp/textmodes/makeinfo.el | |||
| @@ -85,6 +85,7 @@ the proper way to specify those is with the Texinfo commands | |||
| 85 | 85 | ||
| 86 | ;;; The `makeinfo' function definitions | 86 | ;;; The `makeinfo' function definitions |
| 87 | 87 | ||
| 88 | ;;;###autoload | ||
| 88 | (defun makeinfo-region (region-beginning region-end) | 89 | (defun makeinfo-region (region-beginning region-end) |
| 89 | "Make Info file from region of current Texinfo file, and switch to it. | 90 | "Make Info file from region of current Texinfo file, and switch to it. |
| 90 | 91 | ||
| @@ -222,6 +223,7 @@ nonsensical results." | |||
| 222 | (match-string 1) | 223 | (match-string 1) |
| 223 | "Top"))) | 224 | "Top"))) |
| 224 | 225 | ||
| 226 | ;;;###autoload | ||
| 225 | (defun makeinfo-buffer () | 227 | (defun makeinfo-buffer () |
| 226 | "Make Info file from current buffer. | 228 | "Make Info file from current buffer. |
| 227 | 229 | ||
| @@ -266,6 +268,7 @@ Use the \\[next-error] command to move to the next error | |||
| 266 | (Info-revert-find-node | 268 | (Info-revert-find-node |
| 267 | makeinfo-output-file-name makeinfo-output-node-name)))) | 269 | makeinfo-output-file-name makeinfo-output-node-name)))) |
| 268 | 270 | ||
| 271 | ;;;###autoload | ||
| 269 | (defun makeinfo-recenter-compilation-buffer (linenum) | 272 | (defun makeinfo-recenter-compilation-buffer (linenum) |
| 270 | "Redisplay `*compilation*' buffer so most recent output can be seen. | 273 | "Redisplay `*compilation*' buffer so most recent output can be seen. |
| 271 | The last line of the buffer is displayed on | 274 | The last line of the buffer is displayed on |
| @@ -286,4 +289,8 @@ line LINE of the window, or centered if LINE is nil." | |||
| 286 | 289 | ||
| 287 | (provide 'makeinfo) | 290 | (provide 'makeinfo) |
| 288 | 291 | ||
| 292 | ;; Local Variables: | ||
| 293 | ;; generated-autoload-file: "texinfo-loaddefs.el" | ||
| 294 | ;; End: | ||
| 295 | |||
| 289 | ;;; makeinfo.el ends here | 296 | ;;; makeinfo.el ends here |
diff --git a/lisp/textmodes/texinfo.el b/lisp/textmodes/texinfo.el index 750a33db0aa..11d60e1eb03 100644 --- a/lisp/textmodes/texinfo.el +++ b/lisp/textmodes/texinfo.el | |||
| @@ -69,202 +69,12 @@ | |||
| 69 | 69 | ||
| 70 | ;;; Autoloads: | 70 | ;;; Autoloads: |
| 71 | 71 | ||
| 72 | (autoload 'makeinfo-region | ||
| 73 | "makeinfo" | ||
| 74 | "Make Info file from region of current Texinfo file, and switch to it. | ||
| 75 | |||
| 76 | This command does not offer the `next-error' feature since it would | ||
| 77 | apply to a temporary file, not the original; use the `makeinfo-buffer' | ||
| 78 | command to gain use of `next-error'." | ||
| 79 | t nil) | ||
| 80 | |||
| 81 | (autoload 'makeinfo-buffer | ||
| 82 | "makeinfo" | ||
| 83 | "Make Info file from current buffer. | ||
| 84 | |||
| 85 | Use the \\[next-error] command to move to the next error | ||
| 86 | \(if there are errors)." | ||
| 87 | t nil) | ||
| 88 | |||
| 89 | (autoload 'kill-compilation | 72 | (autoload 'kill-compilation |
| 90 | "compile" | 73 | "compile" |
| 91 | "Kill the process made by the \\[compile] command." | 74 | "Kill the process made by the \\[compile] command." |
| 92 | t nil) | 75 | t nil) |
| 93 | 76 | ||
| 94 | (autoload 'makeinfo-recenter-compilation-buffer | 77 | (require 'texinfo-loaddefs) |
| 95 | "makeinfo" | ||
| 96 | "Redisplay `*compilation*' buffer so most recent output can be seen. | ||
| 97 | The last line of the buffer is displayed on | ||
| 98 | line LINE of the window, or centered if LINE is nil." | ||
| 99 | t nil) | ||
| 100 | |||
| 101 | (autoload 'texinfo-update-node | ||
| 102 | "texnfo-upd" | ||
| 103 | "Without any prefix argument, update the node in which point is located. | ||
| 104 | Non-nil argument (prefix, if interactive) means update the nodes in the | ||
| 105 | marked region. | ||
| 106 | |||
| 107 | The functions for creating or updating nodes and menus, and their | ||
| 108 | keybindings, are: | ||
| 109 | |||
| 110 | `texinfo-update-node' (&optional region-p) \\[texinfo-update-node] | ||
| 111 | `texinfo-every-node-update' () \\[texinfo-every-node-update] | ||
| 112 | `texinfo-sequential-node-update' (&optional region-p) | ||
| 113 | |||
| 114 | `texinfo-make-menu' (&optional region-p) \\[texinfo-make-menu] | ||
| 115 | `texinfo-all-menus-update' () \\[texinfo-all-menus-update] | ||
| 116 | `texinfo-master-menu' () | ||
| 117 | |||
| 118 | `texinfo-indent-menu-description' (column &optional region-p) | ||
| 119 | |||
| 120 | The `texinfo-column-for-description' variable specifies the column to | ||
| 121 | which menu descriptions are indented. Its default value is 32." | ||
| 122 | t nil) | ||
| 123 | |||
| 124 | (autoload 'texinfo-every-node-update | ||
| 125 | "texnfo-upd" | ||
| 126 | "Update every node in a Texinfo file." | ||
| 127 | t nil) | ||
| 128 | |||
| 129 | (autoload 'texinfo-sequential-node-update | ||
| 130 | "texnfo-upd" | ||
| 131 | "Update one node (or many) in a Texinfo file with sequential pointers. | ||
| 132 | |||
| 133 | This function causes the `Next' or `Previous' pointer to point to the | ||
| 134 | immediately preceding or following node, even if it is at a higher or | ||
| 135 | lower hierarchical level in the document. Continually pressing `n' or | ||
| 136 | `p' takes you straight through the file. | ||
| 137 | |||
| 138 | Without any prefix argument, update the node in which point is located. | ||
| 139 | Non-nil argument (prefix, if interactive) means update the nodes in the | ||
| 140 | marked region. | ||
| 141 | |||
| 142 | This command makes it awkward to navigate among sections and | ||
| 143 | subsections; it should be used only for those documents that are meant | ||
| 144 | to be read like a novel rather than a reference, and for which the | ||
| 145 | Info `g*' command is inadequate." | ||
| 146 | t nil) | ||
| 147 | |||
| 148 | (autoload 'texinfo-make-menu | ||
| 149 | "texnfo-upd" | ||
| 150 | "Without any prefix argument, make or update a menu. | ||
| 151 | Make the menu for the section enclosing the node found following point. | ||
| 152 | |||
| 153 | Non-nil argument (prefix, if interactive) means make or update menus | ||
| 154 | for nodes within or part of the marked region. | ||
| 155 | |||
| 156 | Whenever a menu exists, and is being updated, the descriptions that | ||
| 157 | are associated with node names in the pre-existing menu are | ||
| 158 | incorporated into the new menu. Otherwise, the nodes' section titles | ||
| 159 | are inserted as descriptions." | ||
| 160 | t nil) | ||
| 161 | |||
| 162 | (autoload 'texinfo-all-menus-update | ||
| 163 | "texnfo-upd" | ||
| 164 | "Update every regular menu in a Texinfo file. | ||
| 165 | Remove pre-existing master menu, if there is one. | ||
| 166 | |||
| 167 | If called with a non-nil argument, this function first updates all the | ||
| 168 | nodes in the buffer before updating the menus." | ||
| 169 | t nil) | ||
| 170 | |||
| 171 | (autoload 'texinfo-master-menu | ||
| 172 | "texnfo-upd" | ||
| 173 | "Make a master menu for a whole Texinfo file. | ||
| 174 | Non-nil argument (prefix, if interactive) means first update all | ||
| 175 | existing nodes and menus. Remove pre-existing master menu, if there is one. | ||
| 176 | |||
| 177 | This function creates a master menu that follows the top node. The | ||
| 178 | master menu includes every entry from all the other menus. It | ||
| 179 | replaces any existing ordinary menu that follows the top node. | ||
| 180 | |||
| 181 | If called with a non-nil argument, this function first updates all the | ||
| 182 | menus in the buffer (incorporating descriptions from pre-existing | ||
| 183 | menus) before it constructs the master menu. | ||
| 184 | |||
| 185 | The function removes the detailed part of an already existing master | ||
| 186 | menu. This action depends on the pre-existing master menu using the | ||
| 187 | standard `texinfo-master-menu-header'. | ||
| 188 | |||
| 189 | The master menu has the following format, which is adapted from the | ||
| 190 | recommendation in the Texinfo Manual: | ||
| 191 | |||
| 192 | * The first part contains the major nodes in the Texinfo file: the | ||
| 193 | nodes for the chapters, chapter-like sections, and the major | ||
| 194 | appendices. This includes the indices, so long as they are in | ||
| 195 | chapter-like sections, such as unnumbered sections. | ||
| 196 | |||
| 197 | * The second and subsequent parts contain a listing of the other, | ||
| 198 | lower level menus, in order. This way, an inquirer can go | ||
| 199 | directly to a particular node if he or she is searching for | ||
| 200 | specific information. | ||
| 201 | |||
| 202 | Each of the menus in the detailed node listing is introduced by the | ||
| 203 | title of the section containing the menu." | ||
| 204 | t nil) | ||
| 205 | |||
| 206 | (autoload 'texinfo-indent-menu-description | ||
| 207 | "texnfo-upd" | ||
| 208 | "Indent every description in menu following point to COLUMN. | ||
| 209 | Non-nil argument (prefix, if interactive) means indent every | ||
| 210 | description in every menu in the region. Does not indent second and | ||
| 211 | subsequent lines of a multi-line description." | ||
| 212 | t nil) | ||
| 213 | |||
| 214 | (autoload 'texinfo-insert-node-lines | ||
| 215 | "texnfo-upd" | ||
| 216 | "Insert missing `@node' lines in region of Texinfo file. | ||
| 217 | Non-nil argument (prefix, if interactive) means also to insert the | ||
| 218 | section titles as node names; and also to insert the section titles as | ||
| 219 | node names in pre-existing @node lines that lack names." | ||
| 220 | t nil) | ||
| 221 | |||
| 222 | (autoload 'texinfo-start-menu-description | ||
| 223 | "texnfo-upd" | ||
| 224 | "In this menu entry, insert the node's section title as a description. | ||
| 225 | Position point at beginning of description ready for editing. | ||
| 226 | Do not insert a title if the line contains an existing description. | ||
| 227 | |||
| 228 | You will need to edit the inserted text since a useful description | ||
| 229 | complements the node name rather than repeats it as a title does." | ||
| 230 | t nil) | ||
| 231 | |||
| 232 | (autoload 'texinfo-multiple-files-update | ||
| 233 | "texnfo-upd" | ||
| 234 | "Update first node pointers in each file included in OUTER-FILE; | ||
| 235 | create or update main menu in the outer file that refers to such nodes. | ||
| 236 | This does not create or update menus or pointers within the included files. | ||
| 237 | |||
| 238 | With optional MAKE-MASTER-MENU argument (prefix arg, if interactive), | ||
| 239 | insert a master menu in OUTER-FILE. This does not create or update | ||
| 240 | menus or pointers within the included files. | ||
| 241 | |||
| 242 | With optional UPDATE-EVERYTHING argument (numeric prefix arg, if | ||
| 243 | interactive), update all the menus and all the `Next', `Previous', and | ||
| 244 | `Up' pointers of all the files included in OUTER-FILE before inserting | ||
| 245 | a master menu in OUTER-FILE. | ||
| 246 | |||
| 247 | The command also updates the `Top' level node pointers of OUTER-FILE. | ||
| 248 | |||
| 249 | Notes: | ||
| 250 | |||
| 251 | * this command does NOT save any files--you must save the | ||
| 252 | outer file and any modified, included files. | ||
| 253 | |||
| 254 | * except for the `Top' node, this command does NOT handle any | ||
| 255 | pre-existing nodes in the outer file; hence, indices must be | ||
| 256 | enclosed in an included file. | ||
| 257 | |||
| 258 | Requirements: | ||
| 259 | |||
| 260 | * each of the included files must contain exactly one highest | ||
| 261 | hierarchical level node, | ||
| 262 | * this highest node must be the first node in the included file, | ||
| 263 | * each highest hierarchical level node must be of the same type. | ||
| 264 | |||
| 265 | Thus, normally, each included file contains one, and only one, | ||
| 266 | chapter." | ||
| 267 | t nil) | ||
| 268 | 78 | ||
| 269 | 79 | ||
| 270 | ;;; Code: | 80 | ;;; Code: |
diff --git a/lisp/textmodes/texnfo-upd.el b/lisp/textmodes/texnfo-upd.el index 03004548302..f56f197c502 100644 --- a/lisp/textmodes/texnfo-upd.el +++ b/lisp/textmodes/texnfo-upd.el | |||
| @@ -275,6 +275,7 @@ The keys are strings specifying the general hierarchical level in the | |||
| 275 | document; the values are regular expressions.") | 275 | document; the values are regular expressions.") |
| 276 | 276 | ||
| 277 | 277 | ||
| 278 | ;;;###autoload | ||
| 278 | (defun texinfo-make-menu (&optional beginning end) | 279 | (defun texinfo-make-menu (&optional beginning end) |
| 279 | "Without any prefix argument, make or update a menu. | 280 | "Without any prefix argument, make or update a menu. |
| 280 | Make the menu for the section enclosing the node found following point. | 281 | Make the menu for the section enclosing the node found following point. |
| @@ -351,6 +352,7 @@ at the level specified by LEVEL. Point is left at the end of menu." | |||
| 351 | (texinfo-delete-old-menu beginning first)) | 352 | (texinfo-delete-old-menu beginning first)) |
| 352 | (texinfo-insert-menu new-menu-list node-name))) | 353 | (texinfo-insert-menu new-menu-list node-name))) |
| 353 | 354 | ||
| 355 | ;;;###autoload | ||
| 354 | (defun texinfo-all-menus-update (&optional update-all-nodes-p) | 356 | (defun texinfo-all-menus-update (&optional update-all-nodes-p) |
| 355 | "Update every regular menu in a Texinfo file. | 357 | "Update every regular menu in a Texinfo file. |
| 356 | Update pre-existing master menu, if there is one. | 358 | Update pre-existing master menu, if there is one. |
| @@ -733,6 +735,7 @@ is the menu entry name, and the cdr of P is the node name." | |||
| 733 | 735 | ||
| 734 | ;;; Starting menu descriptions by inserting titles | 736 | ;;; Starting menu descriptions by inserting titles |
| 735 | 737 | ||
| 738 | ;;;###autoload | ||
| 736 | (defun texinfo-start-menu-description () | 739 | (defun texinfo-start-menu-description () |
| 737 | "In this menu entry, insert the node's section title as a description. | 740 | "In this menu entry, insert the node's section title as a description. |
| 738 | Position point at beginning of description ready for editing. | 741 | Position point at beginning of description ready for editing. |
| @@ -817,6 +820,7 @@ complements the node name rather than repeats it as a title does." | |||
| 817 | ;; Since the make-menu functions indent descriptions, these functions | 820 | ;; Since the make-menu functions indent descriptions, these functions |
| 818 | ;; are useful primarily for indenting a single menu specially. | 821 | ;; are useful primarily for indenting a single menu specially. |
| 819 | 822 | ||
| 823 | ;;;###autoload | ||
| 820 | (defun texinfo-indent-menu-description (column &optional region-p) | 824 | (defun texinfo-indent-menu-description (column &optional region-p) |
| 821 | "Indent every description in menu following point to COLUMN. | 825 | "Indent every description in menu following point to COLUMN. |
| 822 | Non-nil argument (prefix, if interactive) means indent every | 826 | Non-nil argument (prefix, if interactive) means indent every |
| @@ -872,6 +876,7 @@ second and subsequent lines of a multi-line description." | |||
| 872 | 876 | ||
| 873 | ;;; Making the master menu | 877 | ;;; Making the master menu |
| 874 | 878 | ||
| 879 | ;;;###autoload | ||
| 875 | (defun texinfo-master-menu (update-all-nodes-menus-p) | 880 | (defun texinfo-master-menu (update-all-nodes-menus-p) |
| 876 | "Make a master menu for a whole Texinfo file. | 881 | "Make a master menu for a whole Texinfo file. |
| 877 | Remove pre-existing master menu, if there is one. | 882 | Remove pre-existing master menu, if there is one. |
| @@ -1266,6 +1271,7 @@ end of that region; it limits the search." | |||
| 1266 | 1271 | ||
| 1267 | ;;; Updating a node | 1272 | ;;; Updating a node |
| 1268 | 1273 | ||
| 1274 | ;;;###autoload | ||
| 1269 | (defun texinfo-update-node (&optional beginning end) | 1275 | (defun texinfo-update-node (&optional beginning end) |
| 1270 | "Without any prefix argument, update the node in which point is located. | 1276 | "Without any prefix argument, update the node in which point is located. |
| 1271 | Interactively, a prefix argument means to operate on the region. | 1277 | Interactively, a prefix argument means to operate on the region. |
| @@ -1313,6 +1319,7 @@ which menu descriptions are indented. Its default value is 32." | |||
| 1313 | (goto-char (point-max)) | 1319 | (goto-char (point-max)) |
| 1314 | (message "Done...nodes updated in region. You may save the buffer.")))))) | 1320 | (message "Done...nodes updated in region. You may save the buffer.")))))) |
| 1315 | 1321 | ||
| 1322 | ;;;###autoload | ||
| 1316 | (defun texinfo-every-node-update () | 1323 | (defun texinfo-every-node-update () |
| 1317 | "Update every node in a Texinfo file. | 1324 | "Update every node in a Texinfo file. |
| 1318 | 1325 | ||
| @@ -1553,6 +1560,7 @@ towards which the pointer is directed, one of `next', `previous', or `up'." | |||
| 1553 | ;; (The subsection to which `Next' points will most likely be the first | 1560 | ;; (The subsection to which `Next' points will most likely be the first |
| 1554 | ;; item on the section's menu.) | 1561 | ;; item on the section's menu.) |
| 1555 | 1562 | ||
| 1563 | ;;;###autoload | ||
| 1556 | (defun texinfo-sequential-node-update (&optional region-p) | 1564 | (defun texinfo-sequential-node-update (&optional region-p) |
| 1557 | "Update one node (or many) in a Texinfo file with sequential pointers. | 1565 | "Update one node (or many) in a Texinfo file with sequential pointers. |
| 1558 | 1566 | ||
| @@ -1676,6 +1684,7 @@ or `Up' pointer." | |||
| 1676 | ;; before the `@chapter', `@section', and such like lines of a region | 1684 | ;; before the `@chapter', `@section', and such like lines of a region |
| 1677 | ;; in a Texinfo file. | 1685 | ;; in a Texinfo file. |
| 1678 | 1686 | ||
| 1687 | ;;;###autoload | ||
| 1679 | (defun texinfo-insert-node-lines (beginning end &optional title-p) | 1688 | (defun texinfo-insert-node-lines (beginning end &optional title-p) |
| 1680 | "Insert missing `@node' lines in region of Texinfo file. | 1689 | "Insert missing `@node' lines in region of Texinfo file. |
| 1681 | Non-nil argument (prefix, if interactive) means also to insert the | 1690 | Non-nil argument (prefix, if interactive) means also to insert the |
| @@ -1989,6 +1998,7 @@ be the files included within it. A main menu must already exist." | |||
| 1989 | 1998 | ||
| 1990 | ;;; The multiple-file update function | 1999 | ;;; The multiple-file update function |
| 1991 | 2000 | ||
| 2001 | ;;;###autoload | ||
| 1992 | (defun texinfo-multiple-files-update | 2002 | (defun texinfo-multiple-files-update |
| 1993 | (outer-file &optional make-master-menu update-everything) | 2003 | (outer-file &optional make-master-menu update-everything) |
| 1994 | "Update first node pointers in each file included in OUTER-FILE; | 2004 | "Update first node pointers in each file included in OUTER-FILE; |
| @@ -2114,4 +2124,8 @@ chapter." | |||
| 2114 | 2124 | ||
| 2115 | (provide 'texnfo-upd) | 2125 | (provide 'texnfo-upd) |
| 2116 | 2126 | ||
| 2127 | ;; Local Variables: | ||
| 2128 | ;; generated-autoload-file: "texinfo-loaddefs.el" | ||
| 2129 | ;; End: | ||
| 2130 | |||
| 2117 | ;;; texnfo-upd.el ends here | 2131 | ;;; texnfo-upd.el ends here |