;ELC ;;; compiled by rms@mole.gnu.ai.mit.edu on Sun Jun 18 12:45:31 1995 ;;; from file /home/fsf/rms/e19/lisp/texinfo.el ;;; emacs version 19.28.95.2. ;;; bytecomp version FSF 2.10 ;;; optimization is on. ;;; this file uses opcodes which do not exist in Emacs 18. (if (and (boundp 'emacs-version) (or (and (boundp 'epoch::version) epoch::version) (string-lessp emacs-version "19.28.90"))) (error "`texinfo.el' was compiled for Emacs 19.29 or later")) #@248 Make Info file from region of current Texinfo file, and switch to it. This command does not offer the `next-error' feature since it would apply to a temporary file, not the original; use the `makeinfo-buffer' command to gain use of `next-error'. (autoload (quote makeinfo-region) "makeinfo" '(#$ . 476) t nil) #@118 Make Info file from current buffer. Use the \[next-error] command to move to the next error (if there are errors). (autoload (quote makeinfo-buffer) "makeinfo" '(#$ . 794) t nil) #@50 Kill the process made by the \[compile] command. (autoload (quote kill-compilation) "compile" '(#$ . 981) t nil) #@166 Redisplay `*compilation*' buffer so most recent output can be seen. The last line of the buffer is displayed on line LINE of the window, or centered if LINE is nil. (autoload (quote makeinfo-recenter-compilation-buffer) "makeinfo" '(#$ . 1101) t nil) #@471 Without any prefix argument, make or update a menu. Make the menu for the section enclosing the node found following point. Non-nil argument (prefix, if interactive) means make or update menus for nodes within or part of the marked region. Whenever a menu exists, and is being updated, the descriptions that are associated with node names in the pre-existing menu are incorporated into the new menu. Otherwise, the nodes' section titles are inserted as descriptions. (autoload (quote texinfo-make-menu) "texnfo-upd" '(#$ . 1359) t nil) #@215 Update every regular menu in a Texinfo file. Remove pre-existing master menu, if there is one. If called with a non-nil argument, this function first updates all the nodes in the buffer before updating the menus. (autoload (quote texinfo-all-menus-update) "texnfo-upd" '(#$ . 1905) t nil) #@1450 Make a master menu for a whole Texinfo file. Non-nil argument (prefix, if interactive) means first update all existing nodes and menus. Remove pre-existing master menu, if there is one. This function creates a master menu that follows the top node. The master menu includes every entry from all the other menus. It replaces any existing ordinary menu that follows the top node. If called with a non-nil argument, this function first updates all the menus in the buffer (incorporating descriptions from pre-existing menus) before it constructs the master menu. The function removes the detailed part of an already existing master menu. This action depends on the pre-exisitng master menu using the standard `texinfo-master-menu-header'. The master menu has the following format, which is adapted from the recommendation in the Texinfo Manual: * The first part contains the major nodes in the Texinfo file: the nodes for the chapters, chapter-like sections, and the major appendices. This includes the indices, so long as they are in chapter-like sections, such as unnumbered sections. * The second and subsequent parts contain a listing of the other, lower level menus, in order. This way, an inquirer can go directly to a particular node if he or she is searching for specific information. Each of the menus in the detailed node listing is introduced by the title of the section containing the menu. (autoload (quote texinfo-master-menu) "texnfo-upd" '(#$ . 2203) t nil) #@239 Indent every description in menu following point to COLUMN. Non-nil argument (prefix, if interactive) means indent every description in every menu in the region. Does not indent second and subsequent lines of a multi-line description. (autoload (quote texinfo-indent-menu-description) "texnfo-upd" '(#$ . 3730) t nil) #@251 Insert missing `@node' lines in region of Texinfo file. Non-nil argument (prefix, if interactive) means also to insert the section titles as node names; and also to insert the section titles as node names in pre-existing @node lines that lack names. (autoload (quote texinfo-insert-node-lines) "texnfo-upd" '(#$ . 4058) t nil) #@336 In this menu entry, insert the node's section title as a description. Position point at beginning of description ready for editing. Do not insert a title if the line contains an existing description. You will need to edit the inserted text since a useful description complements the node name rather than repeats it as a title does. (autoload (quote texinfo-start-menu-description) "texnfo-upd" '(#$ . 4392) t nil) #@1306 Update first node pointers in each file included in OUTER-FILE; create or update main menu in the outer file that refers to such nodes. This does not create or update menus or pointers within the included files. With optional MAKE-MASTER-MENU argument (prefix arg, if interactive), insert a master menu in OUTER-FILE. This does not create or update menus or pointers within the included files. With optional UPDATE-EVERYTHING argument (numeric prefix arg, if interactive), update all the menus and all the `Next', `Previous', and `Up' pointers of all the files included in OUTER-FILE before inserting a master menu in OUTER-FILE. The command also updates the `Top' level node pointers of OUTER-FILE. Notes: * this command does NOT save any files--you must save the outer file and any modified, included files. * except for the `Top' node, this command does NOT handle any pre-existing nodes in the outer file; hence, indices must be enclosed in an included file. Requirements: * each of the included files must contain exactly one highest hierarchical level node, * this highest node must be the first node in the included file, * each highest hierarchical level node must be of the same type. Thus, normally, each included file contains one, and only one, chapter. (autoload (quote texinfo-multiple-files-update) "texnfo-upd" '(#$ . 4817) t nil) (byte-code "ÀÁ!„ÂÁ B „IÄ ÅÆÇ #ˆÅÈÇ #ˆÅÉÊ #ˆÅËÊ #ˆÅÌÍ #ˆÅÎÏ #ˆÅÐÑ #ˆÅÒÓ #ˆÅÔÕ #ˆÂ‡" [boundp texinfo-mode-syntax-table nil current-load-list make-syntax-table modify-syntax-entry 34 " " 92 64 "\\" 17 91 "(]" 93 ")[" 123 "(}" 125 "){" 39 "w"] 4) #@54 Additional expressions to highlight in TeXinfo mode. (defvar texinfo-font-lock-keywords (list (quote ("^\\(@c\\|@comment\\)[ ].*" . font-lock-comment-face)) "@\\(@\\|[^} \n{]+\\)" (quote ("^\\(*.*\\)[ ]*$" 1 font-lock-function-name-face t)) (quote ("@\\(emph\\|strong\\|b\\|i\\){\\([^}]+\\)" 2 font-lock-comment-face t)) (quote ("@\\(file\\|kbd\\|key\\){\\([^}]+\\)" 2 font-lock-string-face t)) (quote ("@\\(samp\\|code\\|var\\){\\([^}]+\\)" 2 font-lock-function-name-face t)) (quote ("@\\(xref\\|pxref\\){\\([^}]+\\)" 2 font-lock-keyword-face t)) (quote ("@end *\\([a-zA-Z0-9]+\\)[ ]*$" 1 font-lock-function-name-face t)) (quote ("@item \\(.*\\)$" 1 font-lock-function-name-face t)) (quote ("\\$\\([^$]*\\)\\$" 1 font-lock-string-face t))) (#$ . 6458)) (byte-code "ÀÁ!„ÂÁ B‡" [boundp texinfo-mode-map nil current-load-list] 2) #@68 Define the keys both in Texinfo mode and in the texinfo-tex-shell. (defalias 'texinfo-define-common-keys #[(keymap) "À ÂÃ#ˆÀ ÄÅ#ˆÀ ÆÇ#ˆÀ ÈÉ#ˆÀ ÊË#ˆÀ ÌÍ#ˆÀ ÎÏ#ˆÀ ÐÑ#ˆÀ ÒÓ#‡" [define-key keymap " " tex-kill-job "" texinfo-quit-job "\f" tex-recenter-output-buffer "" texinfo-delete-from-print-queue "" tex-show-print-queue "" texinfo-tex-print " " texinfo-texindex "" texinfo-tex-region "" texinfo-tex-buffer] 4 (#$ . 7301)]) (byte-code "„­Á Â!ˆÃÄÅ#ˆÃÆÇ#ˆÃÈÉ#ˆÃÊË#ˆÃÌÍ#ˆÃÎÏ#ˆÃÐÑ#ˆÃÒÓ#ˆÃÔÕ#ˆÃÖ×#ˆÃØÙ#ˆÃÚÛ#ˆÃÜÝ#ˆÃÞß#ˆÃàá#ˆÃâã#ˆÃäå#ˆÃæç#ˆÃèé#ˆÃêë#ˆÃìí#ˆÃîï#ˆÃðñ#ˆÃòó#ˆÃôõ#ˆÃö÷#ˆÃøù#ˆÁ‡" [texinfo-mode-map make-sparse-keymap texinfo-define-common-keys define-key " " kill-compilation " \f" makeinfo-recenter-compilation-buffer " " makeinfo-region " " makeinfo-buffer "" texinfo-format-region "" texinfo-format-buffer "m" texinfo-master-menu " " texinfo-make-menu "" texinfo-update-node "" texinfo-every-node-update "" texinfo-all-menus-update "" texinfo-show-structure "}" up-list "{" texinfo-insert-braces "" texinfo-start-menu-description "v" texinfo-insert-@var "t" texinfo-insert-@table "s" texinfo-insert-@samp "o" texinfo-insert-@noindent "n" texinfo-insert-@node "k" texinfo-insert-@kbd "i" texinfo-insert-@item "f" texinfo-insert-@file "x" texinfo-insert-@example "e" texinfo-insert-@end "d" texinfo-insert-@dfn "c" texinfo-insert-@code] 4) #@128 Regular expression matching Texinfo chapter-level headings. This does not match `@node' and does not match the `@top' command. (defvar texinfo-chapter-level-regexp "chapter\\|unnumbered \\|appendix \\|majorheading\\|chapheading" (#$ . 8762)) #@2760 Major mode for editing Texinfo files. It has these extra commands: \{texinfo-mode-map} These are files that are used as input for TeX to make printed manuals and also to be turned into Info files with \[makeinfo-buffer] or the `makeinfo' program. These files must be written in a very restricted and modified version of TeX input format. Editing commands are like text-mode except that the syntax table is set up so expression commands skip Texinfo bracket groups. To see what the Info version of a region of the Texinfo file will look like, use \[makeinfo-region], which runs `makeinfo' on the current region. You can show the structure of a Texinfo file with \[texinfo-show-structure]. This command shows the structure of a Texinfo file by listing the lines with the @-sign commands for @chapter, @section, and the like. These lines are displayed in another window called the *Occur* window. In that window, you can position the cursor over one of the lines and use \[occur-mode-goto-occurrence], to jump to the corresponding spot in the Texinfo file. In addition, Texinfo mode provides commands that insert various frequently used @-sign commands into the buffer. You can use these commands to save keystrokes. And you can insert balanced braces with \[texinfo-insert-braces] and later use the command \[up-list] to move forward past the closing brace. Also, Texinfo mode provides functions for automatically creating or updating menus and node pointers. These functions * insert the `Next', `Previous' and `Up' pointers of a node, * insert or update the menu for a section, and * create a master menu for a Texinfo source file. Here are the functions: texinfo-update-node \[texinfo-update-node] texinfo-every-node-update \[texinfo-every-node-update] texinfo-sequential-node-update texinfo-make-menu \[texinfo-make-menu] texinfo-all-menus-update \[texinfo-all-menus-update] texinfo-master-menu texinfo-indent-menu-description (column &optional region-p) The `texinfo-column-for-description' variable specifies the column to which menu descriptions are indented. Passed an argument (a prefix argument, if interactive), the `texinfo-update-node' and `texinfo-make-menu' functions do their jobs in the region. To use the updating commands, you must structure your Texinfo file hierarchically, such that each `@node' line, with the exception of the Top node, is accompanied by some kind of section line, such as an `@chapter' or `@section' line. If the file has a `top' node, it must be called `top' or `Top' and be the first node in the file. Entering Texinfo mode calls the value of text-mode-hook, and then the value of texinfo-mode-hook. (defalias 'texinfo-mode #[nil "À ˆÁÃÅ!ˆÇ!ˆÉÊ!ˆË\fÍQ\nÉÎ!ˆÏÉÐ!ˆÑÉÒ!ˆÓPÉÔ!ˆÓPÉÕ!ˆÖÉ×!ˆØÉÙ!ˆÚÉÛ!ˆÏÉÜ!ˆÝÉÞ!ˆßÉà!ˆá âãä\"‡" [text-mode "Texinfo" mode-name texinfo-mode major-mode use-local-map texinfo-mode-map set-syntax-table texinfo-mode-syntax-table make-local-variable page-delimiter "^@node [ ]*[Tt]op\\|^@\\(" texinfo-chapter-level-regexp "\\)" require-final-newline t indent-tabs-mode nil paragraph-separate "\\|@[a-zA-Z]*[ \n]\\|" paragraph-start fill-column 72 comment-start "@c " comment-start-skip "@c +" words-include-escapes font-lock-defaults (texinfo-font-lock-keywords) tex-start-of-header "%**start" tex-end-of-header "%**end" run-hooks text-mode-hook texinfo-mode-hook] 3 (#$ . 9012) nil]) #@122 Regexp for environment-like Texinfo list commands. Subexpression 1 is what goes into the corresponding `@end' statement. (defconst texinfo-environment-regexp "^@\\(f?table\\|enumerate\\|itemize\\|ifhtml\\|ifinfo\\|iftex\\|ifset\\|ifclear\\|example\\|quotation\\|lisp\\|smallexample\\|smalllisp\\|display\\|format\\|flushleft\\|flushright\\|ignore\\|group\\|tex\\|html\\|cartouche\\|menu\\|titlepage\\|end\\|def[a-z]*[a-wyz]\\>\\)" (#$ . 12516)) #@73 Insert the matching `@end' for the last Texinfo command that needs one. (defalias 'texinfo-insert-@end #[nil "ÀÁŠ ÄVƒ(ÅÁÇ#ƒ(ÈÉ!ƒ! T‰‚% S‰„È!ˆ ÄUƒ9À”À•{)Êcˆ\n…E\n˱*‡" [1 nil string depth 0 re-search-backward texinfo-environment-regexp t looking-at "@end" "@end " "\n"] 4 (#$ . 12967) nil]) (defalias 'texinfo-insert-@-with-arg #[(string &optional arg) "ƒ4Á!‰ÂWƒ\"ÃÄxˆŠÅ!ˆÆȱˆ)Éc‡ÃÄwˆÆȱˆÅ!ˆÉc‡ÆʱˆË ‡" [arg prefix-numeric-value 0 " \n \f" nil forward-sexp "@" string "{" "}" "{}" backward-char] 4]) #@111 Make a pair of braces and be poised to type inside of them. Use \[up-list] to move forward out of the braces. (defalias 'texinfo-insert-braces #[nil "ÀcˆÁ ‡" ["{}" backward-char] 1 (#$ . 13508) nil]) #@186 Insert a `@code{...}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@code #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "code" arg] 3 (#$ . 13715) "P"]) #@185 Insert a `@dfn{...}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@dfn #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "dfn" arg] 3 (#$ . 14027) "P"]) #@51 Insert the string `@example' in a Texinfo buffer. (defalias 'texinfo-insert-@example #[nil "Àc‡" ["@example\n"] 1 (#$ . 14335) nil]) #@186 Insert a `@file{...}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@file #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "file" arg] 3 (#$ . 14475) "P"]) #@48 Insert the string `@item' in a Texinfo buffer. (defalias 'texinfo-insert-@item #[nil "ÀcˆÁ ‡" ["@item" newline] 1 (#$ . 14786) nil]) #@185 Insert a `@kbd{...}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@kbd #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "kbd" arg] 3 (#$ . 14926) "P"]) #@142 Insert the string `@node' in a Texinfo buffer. This also inserts on the following line a comment indicating the order of arguments to @node. (defalias 'texinfo-insert-@node #[nil "ÀcˆÁyˆÂu‡" ["@node \n@comment node-name, next, previous, up" -1 6] 1 (#$ . 15235) nil]) #@52 Insert the string `@noindent' in a Texinfo buffer. (defalias 'texinfo-insert-@noindent #[nil "Àc‡" ["@noindent\n"] 1 (#$ . 15513) nil]) #@186 Insert a `@samp{...}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@samp #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "samp" arg] 3 (#$ . 15656) "P"]) #@49 Insert the string `@table' in a Texinfo buffer. (defalias 'texinfo-insert-@table #[(&optional arg) "Àc‡" ["@table "] 1 (#$ . 15967) "P"]) #@182 Insert a `@var{}' command in a Texinfo buffer. A numeric argument says how many words the braces should surround. The default is not to surround any existing words with the braces. (defalias 'texinfo-insert-@var #[(&optional arg) "ÀÁ\n\"‡" [texinfo-insert-@-with-arg "var" arg] 3 (#$ . 16112) "P"]) #@572 Show the structure of a Texinfo file. List the lines in the file that begin with the @-sign commands for @chapter, @section, and the like. With optional argument (prefix if interactive), list both the lines with @-sign commands for @chapter, @section, and the like, and list @node lines. Lines with structuring commands beginning in them are displayed in another buffer named `*Occur*'. In that buffer, you can move point to one of those lines and then use \\[occur-mode-goto-occurrence], to jump to the corresponding spot in the Texinfo source file. (defalias 'texinfo-show-structure #[(&optional nodes-too) "ÀÁ!ˆŠebˆ\nƒÃÄ P!ˆ‚à !ˆ)ÆÇ!ˆebˆÈÉ!ˆdbˆÊ ÌÍÎÏ#…|ÐÑ!ˆÒÓÕQ!ƒEÊ‚qÒÓÕQ!ƒSׂqÒÓÕQ!ƒaÙ‚qÒÓÕQ!ƒoÛ‚q ‰ jˆÏyˆ‚+)‡" [require texnfo-upd nodes-too occur "\\(^@node\\)\\|" texinfo-section-types-regexp pop-to-buffer "*Occur*" flush-lines "-----" 5 margin re-search-backward "^ *[0-9]*:" nil 0 re-search-forward ":" looking-at "@\\(" texinfo-chapter-level-regexp "\\)" texinfo-section-level-regexp 9 texinfo-subsection-level-regexp 13 texinfo-subsubsection-level-regexp 17] 5 (#$ . 16418) "P"]) #@76 *Command used by `texinfo-tex-buffer' to run TeX and texindex on a buffer. (defvar texinfo-texi2dvi-command "texi2dvi" (#$ . -17558)) #@63 *Command used by `texinfo-tex-region' to run TeX on a region. (defvar texinfo-tex-command "tex" (#$ . -17698)) #@67 *Command used by `texinfo-texindex' to sort unsorted index files. (defvar texinfo-texindex-command "texindex" (#$ . -17815)) #@193 *Command string used to delete a job from the line printer queue. Command is used by \[texinfo-delete-from-print-queue] based on number provided by a previous \[tex-show-print-queue] command. (defvar texinfo-delete-from-print-queue-command "lprm" (#$ . -17947)) #@69 String appended after a region sent to TeX by `texinfo-tex-region'. (defvar texinfo-tex-trailer "@bye" (#$ . 18215)) #@588 Run TeX on the current region. This works by writing a temporary file (`tex-zap-file') in the directory that is the value of `tex-directory', then running TeX on that file. The first line of the buffer is copied to the temporary file; and if the buffer has a header, it is written to the temporary file before the region itself. The buffer's header is all lines between the strings defined by `tex-start-of-header' and `tex-end-of-header' inclusive. The header must start in the first 100 lines. The value of `texinfo-tex-trailer' is appended to the temporary file after the region. (defalias 'texinfo-tex-region #[(beg end) "ÀÁ!ˆÂÃ!ƒÄ ˆ‚Å ˆ„ÇÈ!ÉPÊË!ÌÍ!!ŠŒ~ˆebˆÒyˆ`eeebˆ×`ŠØˆ`)؉%ˆÙyˆ`Wƒe`ÛÝ#ƒŠÞyˆ`ÛØÝ#ƒ‡Þyˆ`‚Še×^ÝØ%ˆ×] ÝØ%ˆ,!\"qˆã ˆäå!ˆ\"ƒÀä\"!ˆæ\"ˆ×edÝØ%ˆ+æÃ\"ˆç(\"ˆç)\"ˆ+êÞ!‡" [require tex-mode get-buffer "*tex-shell*" tex-kill-job tex-start-shell tex-zap-file make-temp-name "#tz" ".tex" get-buffer-create " tex-Output-Buffer" file-name-as-directory expand-file-name tex-directory zap-directory temp-buffer tex-out-file 100 default-directory hend hbeg search-end write-region nil 1 beg search-forward tex-start-of-header t 0 tex-end-of-header end texinfo-tex-trailer local-tex-trailer erase-buffer insert-string "\n" tex-set-buffer-directory tex-send-command tex-shell-cd-command texinfo-tex-command tex-recenter-output-buffer] 6 (#$ . 18339) "r"]) #@72 Run TeX on visited file, once or twice, to make a correct `.dvi' file. (defalias 'texinfo-tex-buffer #[nil "ÀÁ!ˆÂÃ!ƒÄÅÆ!Ç\"ˆ‚È ˆ „#ÊË!ˆ‚,Ì ƒ,ÊÍ!ˆ ÏÑ!\"ˆÏ\"ˆÓÔ!‡" [require tex-mode get-buffer "*tex-shell*" quit-process get-process "tex-shell" t tex-start-shell buffer-file-name error "Buffer not visiting any file!" buffer-modified-p "Buffer has been modified since last saved!" tex-zap-file tex-send-command tex-shell-cd-command file-name-directory texinfo-texi2dvi-command tex-recenter-output-buffer 0] 4 (#$ . 19792) nil]) #@184 Run `texindex' on unsorted index files. The index files are made by \[texinfo-tex-region] or \[texinfo-tex-buffer]. This runs the shell command defined by `texinfo-texindex-command'. (defalias 'texinfo-texindex #[nil "ÀÁ!ˆÂ \fÅP\"ˆÆÇ!‡" [require tex-mode tex-send-command texinfo-texindex-command tex-zap-file ".??" tex-recenter-output-buffer nil] 4 (#$ . 20343) nil]) #@139 Print `.dvi' file made by \[texinfo-tex-region] or \[texinfo-tex-buffer]. This runs the shell command defined by `tex-dvi-print-command'. (defalias 'texinfo-tex-print #[nil "ÀÁ!ˆÂ \fÅP\"ˆÆÇ!‡" [require tex-mode tex-send-command tex-dvi-print-command tex-zap-file ".dvi" tex-recenter-output-buffer nil] 4 (#$ . 20719) nil]) #@58 Quit currently running TeX job, by sending an `x' to it. (defalias 'texinfo-quit-job #[nil "ÀÁ!„\nÂÃ!ˆÄÅ!‡" [get-process "tex-shell" error "No TeX shell running" tex-send-command "x"] 2 (#$ . 21048) nil]) #@158 Delete job from the line printer spooling queue. You are prompted for the job number (use a number shown by a previous \[texinfo-show-print-queue] command). (defalias 'texinfo-delete-from-print-queue #[(job-number) "ÀÁ!ˆÂ ƒà ˆ‚Ä ˆÅ\"ˆÈÉ!‡" [require tex-mode tex-shell-running tex-kill-job tex-start-shell tex-send-command texinfo-delete-from-print-queue-command job-number tex-recenter-output-buffer nil] 3 (#$ . 21261) "nPrinter job number for deletion: "]) (provide (quote texinfo))