*** empty log message ***
[bpt/emacs.git] / lisp / textmodes / tex-mode.el
CommitLineData
d501f516
ER
1;;; tex-mode.el --- TeX, LaTeX, and SliTeX mode commands.
2
c3ce7bf4 3;; Copyright (C) 1985, 86, 89, 92, 94, 95, 96, 97, 98, 1999
d61140e8 4;; Free Software Foundation, Inc.
eea8d4ef 5
70f20973 6;; Maintainer: FSF
d7b4d18f 7;; Keywords: tex
e5167999 8
528415e7 9;; Contributions over the years by William F. Schelter, Dick King,
70f20973 10;; Stephen Gildea, Michael Prange, Jacob Gore, and Edward M. Reingold.
528415e7 11
869bff31 12;; This file is part of GNU Emacs.
13
14;; GNU Emacs is free software; you can redistribute it and/or modify
15;; it under the terms of the GNU General Public License as published by
e5167999 16;; the Free Software Foundation; either version 2, or (at your option)
869bff31 17;; any later version.
18
19;; GNU Emacs is distributed in the hope that it will be useful,
20;; but WITHOUT ANY WARRANTY; without even the implied warranty of
21;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22;; GNU General Public License for more details.
23
24;; You should have received a copy of the GNU General Public License
6da9bbd6
RS
25;; along with GNU Emacs; see the file COPYING. If not, write to the
26;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
27;; Boston, MA 02111-1307, USA.
869bff31 28
e5167999
ER
29;;; Code:
30
bed1b0c8
RS
31;; Pacify the byte-compiler
32(eval-when-compile
33 (require 'compare-w)
ea590e1c 34 (require 'cl)
bed1b0c8
RS
35 (require 'skeleton))
36
a0e9c22a 37(require 'shell)
2f3067de 38(require 'compile)
528415e7 39
d61140e8
RS
40(defgroup tex-file nil
41 "TeX files and directories"
42 :prefix "tex-"
43 :group 'tex)
44
45(defgroup tex-run nil
46 "Running external commands from TeX mode"
47 :prefix "tex-"
48 :group 'tex)
49
50(defgroup tex-view nil
51 "Viewing and printing TeX files"
52 :prefix "tex-"
53 :group 'tex)
54
7e1dae73 55;;;###autoload
d61140e8
RS
56(defcustom tex-shell-file-name nil
57 "*If non-nil, the shell file name to run in the subshell used to run TeX."
58 :type '(choice (const :tag "None" nil)
59 string)
60 :group 'tex-run)
528415e7 61
7e1dae73 62;;;###autoload
d61140e8 63(defcustom tex-directory "."
f73741fc 64 "*Directory in which temporary files are written.
81c735c0 65You can make this `/tmp' if your TEXINPUTS has no relative directories in it
528415e7 66and you don't try to apply \\[tex-region] or \\[tex-buffer] when there are
d61140e8
RS
67`\\input' commands with relative directories."
68 :type 'directory
69 :group 'tex-file)
869bff31 70
725b7428 71;;;###autoload
d61140e8 72(defcustom tex-first-line-header-regexp nil
725b7428
RS
73 "Regexp for matching a first line which `tex-region' should include.
74If this is non-nil, it should be a regular expression string;
75if it matches the first line of the file,
d61140e8
RS
76`tex-region' always includes the first line in the TeX run."
77 :type '(choice (const :tag "None" nil)
78 regexp)
79 :group 'tex-file)
725b7428 80
f73741fc 81;;;###autoload
d61140e8 82(defcustom tex-main-file nil
f73741fc 83 "*The main TeX source file which includes this buffer's file.
be4a962d
RS
84The command `tex-file' runs TeX on the file specified by `tex-main-file'
85if the variable is non-nil."
d61140e8
RS
86 :type '(choice (const :tag "None" nil)
87 file)
88 :group 'tex-file)
f73741fc 89
7e1dae73 90;;;###autoload
d61140e8
RS
91(defcustom tex-offer-save t
92 "*If non-nil, ask about saving modified buffers before \\[tex-file] is run."
93 :type 'boolean
94 :group 'tex-file)
869bff31 95
7e1dae73 96;;;###autoload
d61140e8 97(defcustom tex-run-command "tex"
869bff31 98 "*Command used to run TeX subjob.
c3ce7bf4
RS
99TeX Mode sets `tex-command' to this string.
100See the documentation of that variable."
d61140e8
RS
101 :type 'string
102 :group 'tex-run)
869bff31 103
7e1dae73 104;;;###autoload
d61140e8 105(defcustom latex-run-command "latex"
869bff31 106 "*Command used to run LaTeX subjob.
c3ce7bf4
RS
107LaTeX Mode sets `tex-command' to this string.
108See the documentation of that variable."
d61140e8
RS
109 :type 'string
110 :group 'tex-run)
528415e7 111
bed1b0c8
RS
112;;;###autoload
113(defcustom slitex-run-command "slitex"
114 "*Command used to run SliTeX subjob.
c3ce7bf4
RS
115SliTeX Mode sets `tex-command' to this string.
116See the documentation of that variable."
bed1b0c8
RS
117 :type 'string
118 :group 'tex-run)
119
c3ce7bf4
RS
120;;;###autoload
121(defcustom tex-start-options-string "\\nonstopmode\\input"
bed1b0c8 122 "*TeX options to use when running TeX.
c3ce7bf4
RS
123These precede the input file name. If nil, TeX runs without option.
124See the documentation of `tex-command'."
125 :type '(radio (const :tag "Interactive \(nil\)" nil)
126 (const :tag "Nonstop \(\"\\nonstopmode\\input\"\)"
127 "\\nonstopmode\\input")
128 (string :tag "String at your choice"))
bed1b0c8
RS
129 :group 'tex-run
130 :version "20.4")
131
528415e7 132(defvar standard-latex-block-names
bed1b0c8
RS
133 '("abstract" "array" "center" "description"
134 "displaymath" "document" "enumerate" "eqnarray"
135 "eqnarray*" "equation" "figure" "figure*"
136 "flushleft" "flushright" "itemize" "letter"
137 "list" "minipage" "picture" "quotation"
138 "quote" "slide" "sloppypar" "tabbing"
139 "table" "table*" "tabular" "tabular*"
140 "thebibliography" "theindex*" "titlepage" "trivlist"
141 "verbatim" "verbatim*" "verse")
528415e7
RS
142 "Standard LaTeX block names.")
143
7e1dae73 144;;;###autoload
d61140e8 145(defcustom latex-block-names nil
528415e7 146 "*User defined LaTeX block names.
d61140e8
RS
147Combined with `standard-latex-block-names' for minibuffer completion."
148 :type '(repeat string)
149 :group 'tex-run)
869bff31 150
7e1dae73 151;;;###autoload
d61140e8 152(defcustom tex-bibtex-command "bibtex"
528415e7 153 "*Command used by `tex-bibtex-file' to gather bibliographic data.
81c735c0 154If this string contains an asterisk (`*'), that is replaced by the file name;
d61140e8
RS
155otherwise, the file name, preceded by blank, is added at the end."
156 :type 'string
157 :group 'tex-run)
869bff31 158
7e1dae73 159;;;###autoload
d61140e8 160(defcustom tex-dvi-print-command "lpr -d"
528415e7 161 "*Command used by \\[tex-print] to print a .dvi file.
81c735c0 162If this string contains an asterisk (`*'), that is replaced by the file name;
d61140e8
RS
163otherwise, the file name, preceded by blank, is added at the end."
164 :type 'string
165 :group 'tex-view)
528415e7 166
7e1dae73 167;;;###autoload
d61140e8 168(defcustom tex-alt-dvi-print-command "lpr -d"
528415e7 169 "*Command used by \\[tex-print] with a prefix arg to print a .dvi file.
81c735c0
RS
170If this string contains an asterisk (`*'), that is replaced by the file name;
171otherwise, the file name, preceded by blank, is added at the end.
528415e7 172
81c735c0
RS
173If two printers are not enough of a choice, you can set the variable
174`tex-alt-dvi-print-command' to an expression that asks what you want;
528415e7
RS
175for example,
176
177 (setq tex-alt-dvi-print-command
178 '(format \"lpr -P%s\" (read-string \"Use printer: \")))
179
180would tell \\[tex-print] with a prefix argument to ask you which printer to
d61140e8
RS
181use."
182 :type '(choice (string :tag "Command")
183 (sexp :tag "Expression"))
184 :group 'tex-view)
869bff31 185
7e1dae73 186;;;###autoload
d61140e8 187(defcustom tex-dvi-view-command nil
81c735c0
RS
188 "*Command used by \\[tex-view] to display a `.dvi' file.
189If this string contains an asterisk (`*'), that is replaced by the file name;
190otherwise, the file name, preceded by blank, is added at the end.
528415e7
RS
191
192This can be set conditionally so that the previewer used is suitable for the
193window system being used. For example,
194
195 (setq tex-dvi-view-command
196 (if (eq window-system 'x) \"xdvi\" \"dvi2tty * | cat -s\"))
197
81c735c0 198would tell \\[tex-view] to use xdvi under X windows and to use dvi2tty
d61140e8
RS
199otherwise."
200 :type '(choice (const nil) string)
201 :group 'tex-view)
869bff31 202
7e1dae73 203;;;###autoload
d61140e8 204(defcustom tex-show-queue-command "lpq"
528415e7 205 "*Command used by \\[tex-show-print-queue] to show the print queue.
d61140e8
RS
206Should show the queue(s) that \\[tex-print] puts jobs on."
207 :type 'string
208 :group 'tex-view)
869bff31 209
7e1dae73 210;;;###autoload
9920303f 211(defcustom tex-default-mode 'latex-mode
869bff31 212 "*Mode to enter for a new file that might be either TeX or LaTeX.
213This variable is used when it can't be determined whether the file
214is plain TeX or LaTeX or what because the file contains no commands.
d61140e8
RS
215Normally set to either `plain-tex-mode' or `latex-mode'."
216 :type 'function
217 :group 'tex)
869bff31 218
7e1dae73 219;;;###autoload
d61140e8
RS
220(defcustom tex-open-quote "``"
221 "*String inserted by typing \\[tex-insert-quote] to open a quotation."
222 :type 'string
223 :group 'tex)
869bff31 224
7e1dae73 225;;;###autoload
d61140e8
RS
226(defcustom tex-close-quote "''"
227 "*String inserted by typing \\[tex-insert-quote] to close a quotation."
228 :type 'string
229 :group 'tex)
869bff31 230
528415e7
RS
231(defvar tex-last-temp-file nil
232 "Latest temporary file generated by \\[tex-region] and \\[tex-buffer].
233Deleted when the \\[tex-region] or \\[tex-buffer] is next run, or when the
81c735c0 234tex shell terminates.")
528415e7 235
869bff31 236(defvar tex-command nil
c3ce7bf4
RS
237 "*Command to run TeX.
238If this string contains an asterisk \(`*'\), that is replaced by the file name\;
239otherwise the \(shell-quoted\) value of `tex-start-options-string' and
240the file name are added at the end, with blanks as separators.
241
242In TeX, LaTeX, and SliTeX Mode this variable becomes buffer local.
243In these modes, use \\[set-variable] if you want to change it for the
244current buffer.")
869bff31 245
246(defvar tex-trailer nil
247 "String appended after the end of a region sent to TeX by \\[tex-region].")
248
249(defvar tex-start-of-header nil
898b9ac1 250 "Regular expression used by \\[tex-region] to find start of file's header.")
869bff31 251
252(defvar tex-end-of-header nil
898b9ac1 253 "Regular expression used by \\[tex-region] to find end of file's header.")
869bff31 254
255(defvar tex-shell-cd-command "cd"
256 "Command to give to shell running TeX to change directory.
81c735c0 257The value of `tex-directory' is appended to this, separated by a space.")
869bff31 258
259(defvar tex-zap-file nil
260 "Temporary file name used for text being sent as input to TeX.
261Should be a simple file name with no extension or directory specification.")
262
263(defvar tex-last-buffer-texed nil
264 "Buffer which was last TeXed.")
265
266(defvar tex-print-file nil
267 "File name that \\[tex-print] prints.
268Set by \\[tex-region], \\[tex-buffer], and \\[tex-file].")
269
ea590e1c
SM
270(easy-mmode-defsyntax tex-mode-syntax-table
271 '((?% . "<")
272 (?\n . ">")
273 (?\f . ">")
274 (?\C-@ . "w")
275 (?' . "w")
276 (?@ . "_")
277 (?* . "_")
278 (?\t . " ")
279 (?~ . " ")
280 (?$ . "$$")
281 (?\\ . "/")
282 (?\" . ".")
283 (?& . ".")
284 (?_ . "."))
869bff31 285 "Syntax table used while in TeX mode.")
53c4fe47
SM
286\f
287;;;;
288;;;; Imenu support
289;;;;
869bff31 290
d6709b80 291(defcustom latex-imenu-indent-string ". "
a53c647b
RS
292 "*String to add repeated in front of nested sectional units for Imenu.
293An alternative value is \" . \", if you use a font with a narrow period."
294 :type 'string
295 :group 'tex)
296
d6709b80
SM
297(defvar latex-section-alist
298 '(("part" . 0) ("chapter" . 1)
299 ("section" . 2) ("subsection" . 3)
300 ("subsubsection" . 4)
301 ("paragraph" . 5) ("subparagraph" . 6)))
302
53c4fe47
SM
303(defvar latex-metasection-list
304 '("documentstyle" "documentclass"
305 "begin{document}" "end{document}"
306 "appendix" "frontmatter" "mainmatter" "backmatter"))
307
a5e2ae01 308(defun latex-imenu-create-index ()
53c4fe47
SM
309 "Generate an alist for imenu from a LaTeX buffer."
310 (let ((section-regexp
311 (concat "\\\\" (regexp-opt (mapcar 'car latex-section-alist) t)
312 "\\*?[ \t]*{"))
313 (metasection-regexp
314 (concat "\\\\" (regexp-opt latex-metasection-list t)))
315 i0 menu case-fold-search)
a53c647b
RS
316 (save-excursion
317 ;; Find the top-most level in this file but don't allow it to be
318 ;; any deeper than "section" (which is top-level in an article).
319 (goto-char (point-min))
320 (if (search-forward-regexp "\\\\part\\*?[ \t]*{" nil t)
321 (setq i0 0)
322 (if (search-forward-regexp "\\\\chapter\\*?[ \t]*{" nil t)
323 (setq i0 1)
324 (setq i0 2)))
325
326 ;; Look for chapters and sections.
327 (goto-char (point-min))
53c4fe47 328 (while (search-forward-regexp section-regexp nil t)
a53c647b
RS
329 (let ((start (match-beginning 0))
330 (here (point))
331 (i (cdr (assoc (buffer-substring-no-properties
332 (match-beginning 1)
333 (match-end 1))
d6709b80 334 latex-section-alist))))
a53c647b
RS
335 (backward-char 1)
336 (condition-case err
337 (progn
338 ;; Using sexps allows some use of matching {...} inside
339 ;; titles.
340 (forward-sexp 1)
d6709b80
SM
341 (push (cons (concat (apply 'concat
342 (make-list
343 (max 0 (- i i0))
344 latex-imenu-indent-string))
345 (buffer-substring-no-properties
346 here (1- (point))))
347 start)
348 menu))
a53c647b
RS
349 (error nil))))
350
351 ;; Look for included material.
352 (goto-char (point-min))
353 (while (search-forward-regexp
354 "\\\\\\(include\\|input\\|verbatiminput\\|bibliography\\)\
53c4fe47 355\[ \t]*{\\([^}\n]+\\)}"
a53c647b 356 nil t)
53c4fe47
SM
357 (push (cons (concat "<<" (buffer-substring-no-properties
358 (match-beginning 2)
359 (match-end 2))
360 (if (= (char-after (match-beginning 1)) ?b)
361 ".bbl"
362 ".tex"))
363 (match-beginning 0))
364 menu))
a53c647b
RS
365
366 ;; Look for \frontmatter, \mainmatter, \backmatter, and \appendix.
367 (goto-char (point-min))
53c4fe47
SM
368 (while (search-forward-regexp metasection-regexp nil t)
369 (push (cons "--" (match-beginning 0)) menu))
a53c647b
RS
370
371 ;; Sort in increasing buffer position order.
372 (sort menu (function (lambda (a b) (< (cdr a) (cdr b))))))))
53c4fe47
SM
373\f
374;;;;
375;;;; Outline support
376;;;;
377
378(defvar latex-outline-regexp
379 (concat "\\\\"
380 (regexp-opt (append latex-metasection-list
381 (mapcar 'car latex-section-alist)) t)))
382
383(defun latex-outline-level ()
384 (if (looking-at latex-outline-regexp)
385 (1+ (or (cdr (assoc (match-string 1) latex-section-alist)) -1))
386 1000))
387\f
388;;;;
389;;;; Font-Lock support
390;;;;
391
392;(defvar tex-font-lock-keywords
393; ;; Regexps updated with help from Ulrik Dickow <dickow@nbi.dk>.
394; '(("\\\\\\(begin\\|end\\|newcommand\\){\\([a-zA-Z0-9\\*]+\\)}"
395; 2 font-lock-function-name-face)
396; ("\\\\\\(cite\\|label\\|pageref\\|ref\\){\\([^} \t\n]+\\)}"
397; 2 font-lock-constant-face)
398; ;; It seems a bit dubious to use `bold' and `italic' faces since we might
399; ;; not be able to display those fonts.
400; ("{\\\\bf\\([^}]+\\)}" 1 'bold keep)
401; ("{\\\\\\(em\\|it\\|sl\\)\\([^}]+\\)}" 2 'italic keep)
402; ("\\\\\\([a-zA-Z@]+\\|.\\)" . font-lock-keyword-face)
403; ("^[ \t\n]*\\\\def[\\\\@]\\(\\w+\\)" 1 font-lock-function-name-face keep))
404; ;; Rewritten and extended for LaTeX2e by Ulrik Dickow <dickow@nbi.dk>.
405; '(("\\\\\\(begin\\|end\\|newcommand\\){\\([a-zA-Z0-9\\*]+\\)}"
406; 2 font-lock-function-name-face)
407; ("\\\\\\(cite\\|label\\|pageref\\|ref\\){\\([^} \t\n]+\\)}"
408; 2 font-lock-constant-face)
409; ("^[ \t]*\\\\def\\\\\\(\\(\\w\\|@\\)+\\)" 1 font-lock-function-name-face)
410; "\\\\\\([a-zA-Z@]+\\|.\\)"
411; ;; It seems a bit dubious to use `bold' and `italic' faces since we might
412; ;; not be able to display those fonts.
413; ;; LaTeX2e: \emph{This is emphasized}.
414; ("\\\\emph{\\([^}]+\\)}" 1 'italic keep)
415; ;; LaTeX2e: \textbf{This is bold}, \textit{...}, \textsl{...}
416; ("\\\\text\\(\\(bf\\)\\|it\\|sl\\){\\([^}]+\\)}"
417; 3 (if (match-beginning 2) 'bold 'italic) keep)
418; ;; Old-style bf/em/it/sl. Stop at `\\' and un-escaped `&', for tables.
419; ("\\\\\\(\\(bf\\)\\|em\\|it\\|sl\\)\\>\\(\\([^}&\\]\\|\\\\[^\\]\\)+\\)"
420; 3 (if (match-beginning 2) 'bold 'italic) keep))
421
422;; Rewritten with the help of Alexandra Bac <abac@welcome.disi.unige.it>.
423(defconst tex-font-lock-keywords-1
424 (eval-when-compile
425 (let* (;; Names of commands whose arg should be fontified as heading, etc.
426 (headings (regexp-opt
427 '("title" "begin" "end" "chapter" "part"
428 "section" "subsection" "subsubsection"
429 "paragraph" "subparagraph" "subsubparagraph"
430 "newcommand" "renewcommand" "newenvironment"
431 "newtheorem")
432 t))
433 (variables (regexp-opt
434 '("newcounter" "newcounter*" "setcounter" "addtocounter"
435 "setlength" "addtolength" "settowidth")
436 t))
437 (includes (regexp-opt
438 '("input" "include" "includeonly" "bibliography"
439 "epsfig" "psfig" "epsf" "nofiles" "usepackage"
440 "includegraphics" "includegraphics*")
441 t))
442 ;; Miscellany.
443 (slash "\\\\")
444 (opt "\\(\\[[^]]*\\]\\)?")
445 (arg "{\\(\\(?:[^{}]+\\(?:{[^}]*}\\)?\\)+\\)"))
446 (list
447 ;; Heading args.
448 (list (concat slash headings "\\*?" opt arg)
449 3 'font-lock-function-name-face 'prepend)
450 ;; Variable args.
451 (list (concat slash variables arg) 2 'font-lock-variable-name-face)
452 ;; Include args.
453 (list (concat slash includes opt arg) 3 'font-lock-builtin-face)
454 ;; Definitions. I think.
455 '("^[ \t]*\\\\def\\\\\\(\\(\\w\\|@\\)+\\)"
456 1 font-lock-function-name-face)
457 )))
458 "Subdued expressions to highlight in TeX modes.")
459
460(defconst tex-font-lock-keywords-2
461 (append tex-font-lock-keywords-1
462 (eval-when-compile
463 (let* (;;
464 ;; Names of commands whose arg should be fontified with fonts.
465 (bold (regexp-opt '("bf" "textbf" "textsc" "textup"
466 "boldsymbol" "pmb") t))
467 (italic (regexp-opt '("it" "textit" "textsl" "emph") t))
468 (type (regexp-opt '("texttt" "textmd" "textrm" "textsf") t))
469 ;;
470 ;; Names of commands whose arg should be fontified as a citation.
471 (citations (regexp-opt
472 '("label" "ref" "pageref" "vref" "eqref"
473 "cite" "nocite" "caption" "index" "glossary"
474 "footnote" "footnotemark" "footnotetext")
475 t))
476 ;;
477 ;; Names of commands that should be fontified.
478 (specials (regexp-opt
479 '("\\"
480 "linebreak" "nolinebreak" "pagebreak" "nopagebreak"
481 "newline" "newpage" "clearpage" "cleardoublepage"
482 "displaybreak" "allowdisplaybreaks" "enlargethispage")
483 t))
484 (general "\\([a-zA-Z@]+\\**\\|[^ \t\n]\\)")
485 ;;
486 ;; Miscellany.
487 (slash "\\\\")
488 (opt "\\(\\[[^]]*\\]\\)?")
489 (arg "{\\(\\(?:[^{}]+\\(?:{[^}]*}\\)?\\)+\\)"))
490 (list
491 ;;
492 ;; Citation args.
493 (list (concat slash citations opt arg) 3 'font-lock-constant-face)
494 ;;
495 ;; Command names, special and general.
496 (cons (concat slash specials) 'font-lock-warning-face)
497 (concat slash general)
498 ;;
499 ;; Font environments. It seems a bit dubious to use `bold' etc. faces
500 ;; since we might not be able to display those fonts.
501 (list (concat slash bold arg) 2 '(quote bold) 'append)
502 (list (concat slash italic arg) 2 '(quote italic) 'append)
503 (list (concat slash type arg) 2 '(quote bold-italic) 'append)
504 ;;
505 ;; Old-style bf/em/it/sl. Stop at `\\' and un-escaped `&', for tables.
506 (list (concat "\\\\\\(\\(bf\\)\\|em\\|it\\|sl\\)\\>"
507 "\\(\\([^}&\\]\\|\\\\[^\\]\\)+\\)")
508 3 '(if (match-beginning 2) 'bold 'italic) 'append)
509 ))))
510 "Gaudy expressions to highlight in TeX modes.")
511
512(defvar tex-font-lock-keywords tex-font-lock-keywords-1
513 "Default expressions to highlight in TeX modes.")
0fb4f245 514
53c4fe47 515\f
869bff31 516(defun tex-define-common-keys (keymap)
81c735c0 517 "Define the keys that we want defined both in TeX mode and in the TeX shell."
869bff31 518 (define-key keymap "\C-c\C-k" 'tex-kill-job)
519 (define-key keymap "\C-c\C-l" 'tex-recenter-output-buffer)
520 (define-key keymap "\C-c\C-q" 'tex-show-print-queue)
521 (define-key keymap "\C-c\C-p" 'tex-print)
522 (define-key keymap "\C-c\C-v" 'tex-view)
62a24cb5
RS
523
524 (define-key keymap [menu-bar tex] (cons "TeX" (make-sparse-keymap "TeX")))
525
526 (define-key keymap [menu-bar tex tex-kill-job] '("Tex Kill" . tex-kill-job))
cf6d6e8a
RS
527 (define-key keymap [menu-bar tex tex-recenter-output-buffer]
528 '("Tex Recenter" . tex-recenter-output-buffer))
62a24cb5
RS
529 (define-key keymap [menu-bar tex tex-show-print-queue]
530 '("Show Print Queue" . tex-show-print-queue))
cf6d6e8a
RS
531 (define-key keymap [menu-bar tex tex-alt-print]
532 '("Tex Print (alt printer)" . tex-alt-print))
62a24cb5 533 (define-key keymap [menu-bar tex tex-print] '("Tex Print" . tex-print))
cf6d6e8a 534 (define-key keymap [menu-bar tex tex-view] '("Tex View" . tex-view))
869bff31 535 )
536
537(defvar tex-mode-map nil "Keymap for TeX mode.")
538
bed1b0c8 539(if tex-mode-map
869bff31 540 nil
541 (setq tex-mode-map (make-sparse-keymap))
542 (tex-define-common-keys tex-mode-map)
543 (define-key tex-mode-map "\"" 'tex-insert-quote)
544 (define-key tex-mode-map "\n" 'tex-terminate-paragraph)
ea590e1c 545 (define-key tex-mode-map "\M-\r" 'latex-insert-item)
869bff31 546 (define-key tex-mode-map "\C-c}" 'up-list)
547 (define-key tex-mode-map "\C-c{" 'tex-insert-braces)
548 (define-key tex-mode-map "\C-c\C-r" 'tex-region)
549 (define-key tex-mode-map "\C-c\C-b" 'tex-buffer)
550 (define-key tex-mode-map "\C-c\C-f" 'tex-file)
551 (define-key tex-mode-map "\C-c\C-i" 'tex-bibtex-file)
552 (define-key tex-mode-map "\C-c\C-o" 'tex-latex-block)
cf6d6e8a 553 (define-key tex-mode-map "\C-c\C-e" 'tex-close-latex-block)
6a900cf1 554 (define-key tex-mode-map "\C-c\C-u" 'tex-goto-last-unclosed-latex-block)
f05bd645
RS
555 (define-key tex-mode-map "\C-c\C-m" 'tex-feed-input)
556 (define-key tex-mode-map [(control return)] 'tex-feed-input)
002b0d00
RS
557 (define-key tex-mode-map [menu-bar tex tex-bibtex-file]
558 '("BibTeX File" . tex-bibtex-file))
cf6d6e8a
RS
559 (define-key tex-mode-map [menu-bar tex tex-validate-region]
560 '("Validate Region" . tex-validate-region))
e6b0b773
MR
561 (define-key tex-mode-map [menu-bar tex tex-validate-buffer]
562 '("Validate Buffer" . tex-validate-buffer))
cf6d6e8a 563 (define-key tex-mode-map [menu-bar tex tex-region]
002b0d00 564 '("TeX Region" . tex-region))
cf6d6e8a 565 (define-key tex-mode-map [menu-bar tex tex-buffer]
002b0d00
RS
566 '("TeX Buffer" . tex-buffer))
567 (define-key tex-mode-map [menu-bar tex tex-file] '("TeX File" . tex-file)))
cf6d6e8a
RS
568
569(put 'tex-region 'menu-enable 'mark-active)
570(put 'tex-validate-region 'menu-enable 'mark-active)
571(put 'tex-print 'menu-enable '(stringp tex-print-file))
572(put 'tex-alt-print 'menu-enable '(stringp tex-print-file))
573(put 'tex-view 'menu-enable '(stringp tex-print-file))
574(put 'tex-recenter-output-buffer 'menu-enable '(get-buffer "*tex-shell*"))
575(put 'tex-kill-job 'menu-enable '(tex-shell-running))
576
d6709b80
SM
577(defvar tex-shell-map
578 (let ((m (make-sparse-keymap)))
579 (set-keymap-parent m shell-mode-map)
580 (tex-define-common-keys m)
581 m)
81c735c0 582 "Keymap for the TeX shell.
dca5ea48 583Inherits `shell-mode-map' with a few additions.")
869bff31 584
6da9bbd6
RS
585(defvar tex-face-alist
586 '((bold . "{\\bf ")
587 (italic . "{\\it ")
588 (bold-italic . "{\\bi ") ; hypothetical
589 (underline . "\\underline{")
590 (default . "{\\rm "))
591 "Alist of face and TeX font name for facemenu.")
592
593(defvar tex-latex-face-alist
594 `((italic . "{\\em ")
595 ,@tex-face-alist)
596 "Alist of face and LaTeX font name for facemenu.")
597
869bff31 598;;; This would be a lot simpler if we just used a regexp search,
599;;; but then it would be too slow.
7229064d 600;;;###autoload
869bff31 601(defun tex-mode ()
602 "Major mode for editing files of input for TeX, LaTeX, or SliTeX.
603Tries to determine (by looking at the beginning of the file) whether
81c735c0
RS
604this file is for plain TeX, LaTeX, or SliTeX and calls `plain-tex-mode',
605`latex-mode', or `slitex-mode', respectively. If it cannot be determined,
606such as if there are no commands in the file, the value of `tex-default-mode'
607says which mode to use."
869bff31 608 (interactive)
d6709b80 609 (let ((mode tex-default-mode) slash comment)
869bff31 610 (save-excursion
611 (goto-char (point-min))
612 (while (and (setq slash (search-forward "\\" nil t))
613 (setq comment (let ((search-end (point)))
614 (save-excursion
615 (beginning-of-line)
616 (search-forward "%" search-end t))))))
617 (if (and slash (not comment))
c0bcb239 618 (setq mode (if (looking-at "documentstyle\\|documentclass\\|begin\\b\\|NeedsTeXFormat{LaTeX")
0edb9815
RS
619 (if (looking-at
620 "document\\(style\\|class\\)\\(\\[.*\\]\\)?{slides}")
869bff31 621 'slitex-mode
622 'latex-mode)
623 'plain-tex-mode))))
d6709b80 624 (funcall mode)))
e4c8c838 625
6503cec3 626;;;###autoload
31e1d920 627(defalias 'TeX-mode 'tex-mode)
6503cec3 628;;;###autoload
c3ce7bf4
RS
629(defalias 'plain-TeX-mode 'plain-tex-mode)
630;;;###autoload
31e1d920 631(defalias 'LaTeX-mode 'latex-mode)
869bff31 632
7229064d 633;;;###autoload
d6709b80 634(define-derived-mode plain-tex-mode text-mode "TeX"
869bff31 635 "Major mode for editing files of input for plain TeX.
636Makes $ and } display the characters they match.
637Makes \" insert `` when it seems to be the beginning of a quotation,
638and '' when it appears to be the end; it inserts \" only after a \\.
639
640Use \\[tex-region] to run TeX on the current region, plus a \"header\"
641copied from the top of the file (containing macro definitions, etc.),
642running TeX under a special subshell. \\[tex-buffer] does the whole buffer.
643\\[tex-file] saves the buffer and then processes the file.
644\\[tex-print] prints the .dvi file made by any of these.
645\\[tex-view] previews the .dvi file made by any of these.
646\\[tex-bibtex-file] runs bibtex on the file of the current buffer.
647
e6b0b773 648Use \\[tex-validate-buffer] to check buffer for paragraphs containing
869bff31 649mismatched $'s or braces.
650
651Special commands:
652\\{tex-mode-map}
653
654Mode variables:
655tex-run-command
656 Command string used by \\[tex-region] or \\[tex-buffer].
657tex-directory
658 Directory in which to create temporary files for TeX jobs
659 run by \\[tex-region] or \\[tex-buffer].
660tex-dvi-print-command
661 Command string used by \\[tex-print] to print a .dvi file.
528415e7
RS
662tex-alt-dvi-print-command
663 Alternative command string used by \\[tex-print] (when given a prefix
664 argument) to print a .dvi file.
869bff31 665tex-dvi-view-command
666 Command string used by \\[tex-view] to preview a .dvi file.
667tex-show-queue-command
668 Command string used by \\[tex-show-print-queue] to show the print
669 queue that \\[tex-print] put your job on.
670
81c735c0
RS
671Entering Plain-tex mode runs the hook `text-mode-hook', then the hook
672`tex-mode-hook', and finally the hook `plain-tex-mode-hook'. When the
673special subshell is initiated, the hook `tex-shell-hook' is run."
869bff31 674 (tex-common-initialization)
869bff31 675 (setq tex-command tex-run-command)
898b9ac1
RS
676 (setq tex-start-of-header "%\\*\\*start of header")
677 (setq tex-end-of-header "%\\*\\*end of header")
869bff31 678 (setq tex-trailer "\\bye\n")
d6709b80 679 (run-hooks 'tex-mode-hook))
869bff31 680
7229064d 681;;;###autoload
d6709b80 682(define-derived-mode latex-mode text-mode "LaTeX"
869bff31 683 "Major mode for editing files of input for LaTeX.
684Makes $ and } display the characters they match.
685Makes \" insert `` when it seems to be the beginning of a quotation,
686and '' when it appears to be the end; it inserts \" only after a \\.
687
688Use \\[tex-region] to run LaTeX on the current region, plus the preamble
689copied from the top of the file (containing \\documentstyle, etc.),
690running LaTeX under a special subshell. \\[tex-buffer] does the whole buffer.
691\\[tex-file] saves the buffer and then processes the file.
692\\[tex-print] prints the .dvi file made by any of these.
693\\[tex-view] previews the .dvi file made by any of these.
694\\[tex-bibtex-file] runs bibtex on the file of the current buffer.
695
e6b0b773 696Use \\[tex-validate-buffer] to check buffer for paragraphs containing
869bff31 697mismatched $'s or braces.
698
699Special commands:
700\\{tex-mode-map}
701
702Mode variables:
703latex-run-command
704 Command string used by \\[tex-region] or \\[tex-buffer].
705tex-directory
706 Directory in which to create temporary files for LaTeX jobs
707 run by \\[tex-region] or \\[tex-buffer].
708tex-dvi-print-command
709 Command string used by \\[tex-print] to print a .dvi file.
528415e7
RS
710tex-alt-dvi-print-command
711 Alternative command string used by \\[tex-print] (when given a prefix
712 argument) to print a .dvi file.
869bff31 713tex-dvi-view-command
714 Command string used by \\[tex-view] to preview a .dvi file.
715tex-show-queue-command
716 Command string used by \\[tex-show-print-queue] to show the print
717 queue that \\[tex-print] put your job on.
718
bed1b0c8 719Entering Latex mode runs the hook `text-mode-hook', then
81c735c0
RS
720`tex-mode-hook', and finally `latex-mode-hook'. When the special
721subshell is initiated, `tex-shell-hook' is run."
869bff31 722 (tex-common-initialization)
869bff31 723 (setq tex-command latex-run-command)
898b9ac1
RS
724 (setq tex-start-of-header "\\\\documentstyle\\|\\\\documentclass")
725 (setq tex-end-of-header "\\\\begin{document}")
869bff31 726 (setq tex-trailer "\\end{document}\n")
ab2c9f54
RS
727 ;; A line containing just $$ is treated as a paragraph separator.
728 ;; A line starting with $$ starts a paragraph,
729 ;; but does not separate paragraphs if it has more stuff on it.
d6709b80
SM
730 (setq paragraph-start
731 (concat "[ \t]*$\\|[\f%]\\|[ \t]*\\$\\$\\|"
732 "\\\\[][]\\|"
733 "\\\\" (regexp-opt (append
734 (mapcar 'car latex-section-alist)
735 '("begin" "label" "end"
736 "item" "bibitem" "newline" "noindent"
737 "newpage" "footnote" "marginpar"
738 "parbox" "caption")) t)
739 "\\>\\|\\\\[a-z]*" (regexp-opt '("space" "skip" "page") t)
740 "\\>"))
741 (setq paragraph-separate
742 (concat "[ \t]*$\\|[\f%]\\|[ \t]*\\$\\$[ \t]*$\\|"
743 "\\\\[][]\\|"
744 "\\\\" (regexp-opt (append
745 (mapcar 'car latex-section-alist)
746 '("begin" "label" "end" )) t)
747 "\\>\\|\\\\\\(" (regexp-opt '("item" "bibitem" "newline"
748 "noindent" "newpage" "footnote"
749 "marginpar" "parbox" "caption"))
750 "\\|[a-z]*\\(space\\|skip\\|page[a-z]*\\)"
751 "\\)[ \t]*\\($\\|%\\)"))
752 (set (make-local-variable 'imenu-create-index-function)
753 'latex-imenu-create-index)
754 (set (make-local-variable 'tex-face-alist) tex-latex-face-alist)
755 (set (make-local-variable 'fill-nobreak-predicate)
756 'latex-fill-nobreak-predicate)
ea590e1c 757 (set (make-local-variable 'indent-line-function) 'latex-indent)
d6709b80
SM
758 (set (make-local-variable 'outline-regexp) latex-outline-regexp)
759 (set (make-local-variable 'outline-level) 'latex-outline-level)
53c4fe47 760 (set (make-local-variable 'forward-sexp-function) 'latex-forward-sexp)
d6709b80 761 (run-hooks 'tex-mode-hook))
869bff31 762
bd2f2323 763;;;###autoload
d6709b80 764(define-derived-mode slitex-mode latex-mode "SliTeX"
869bff31 765 "Major mode for editing files of input for SliTeX.
766Makes $ and } display the characters they match.
767Makes \" insert `` when it seems to be the beginning of a quotation,
768and '' when it appears to be the end; it inserts \" only after a \\.
769
770Use \\[tex-region] to run SliTeX on the current region, plus the preamble
771copied from the top of the file (containing \\documentstyle, etc.),
772running SliTeX under a special subshell. \\[tex-buffer] does the whole buffer.
773\\[tex-file] saves the buffer and then processes the file.
774\\[tex-print] prints the .dvi file made by any of these.
775\\[tex-view] previews the .dvi file made by any of these.
776\\[tex-bibtex-file] runs bibtex on the file of the current buffer.
777
e6b0b773 778Use \\[tex-validate-buffer] to check buffer for paragraphs containing
869bff31 779mismatched $'s or braces.
780
781Special commands:
782\\{tex-mode-map}
783
784Mode variables:
785slitex-run-command
786 Command string used by \\[tex-region] or \\[tex-buffer].
787tex-directory
788 Directory in which to create temporary files for SliTeX jobs
789 run by \\[tex-region] or \\[tex-buffer].
790tex-dvi-print-command
791 Command string used by \\[tex-print] to print a .dvi file.
528415e7
RS
792tex-alt-dvi-print-command
793 Alternative command string used by \\[tex-print] (when given a prefix
794 argument) to print a .dvi file.
869bff31 795tex-dvi-view-command
796 Command string used by \\[tex-view] to preview a .dvi file.
797tex-show-queue-command
798 Command string used by \\[tex-show-print-queue] to show the print
799 queue that \\[tex-print] put your job on.
800
81c735c0
RS
801Entering SliTeX mode runs the hook `text-mode-hook', then the hook
802`tex-mode-hook', then the hook `latex-mode-hook', and finally the hook
803`slitex-mode-hook'. When the special subshell is initiated, the hook
804`tex-shell-hook' is run."
869bff31 805 (setq tex-command slitex-run-command)
d6709b80 806 (setq tex-start-of-header "\\\\documentstyle{slides}\\|\\\\documentclass{slides}"))
869bff31 807
808(defun tex-common-initialization ()
869bff31 809 (use-local-map tex-mode-map)
ea590e1c 810 (set-syntax-table tex-mode-syntax-table)
822eddf4 811 ;; Regexp isearch should accept newline and formfeed as whitespace.
d6709b80 812 (set (make-local-variable 'search-whitespace-regexp) "[ \t\r\n\f]+")
64db2461 813 ;; A line containing just $$ is treated as a paragraph separator.
d6709b80
SM
814 (set (make-local-variable 'paragraph-start)
815 "[ \t]*$\\|[\f\\\\%]\\|[ \t]*\\$\\$")
ab2c9f54
RS
816 ;; A line starting with $$ starts a paragraph,
817 ;; but does not separate paragraphs if it has more stuff on it.
d6709b80
SM
818 (set (make-local-variable 'paragraph-separate)
819 "[ \t]*$\\|[\f\\\\%]\\|[ \t]*\\$\\$[ \t]*$")
820 (set (make-local-variable 'comment-start) "%")
821 (set (make-local-variable 'comment-add) 1)
822 (set (make-local-variable 'comment-start-skip)
823 "\\(\\(^\\|[^\\]\\)\\(\\\\\\\\\\)*\\)\\(%+ *\\)")
d6709b80
SM
824 (set (make-local-variable 'parse-sexp-ignore-comments) t)
825 (set (make-local-variable 'compare-windows-whitespace)
826 'tex-categorize-whitespace)
827 (set (make-local-variable 'facemenu-add-face-function)
828 (lambda (face end)
829 (let ((face-text (cdr (assq face tex-face-alist))))
830 (if face-text
831 face-text
832 (error "Face %s not configured for %s mode" face mode-name)))))
833 (set (make-local-variable 'facemenu-end-add-face) "}")
834 (set (make-local-variable 'facemenu-remove-face-function) t)
835 (set (make-local-variable 'font-lock-defaults)
836 '((tex-font-lock-keywords
837 tex-font-lock-keywords-1 tex-font-lock-keywords-2)
838 nil nil ((?$ . "\"")) nil
839 ;; Who ever uses that anyway ???
840 (font-lock-mark-block-function . mark-paragraph)))
869bff31 841 (make-local-variable 'tex-command)
842 (make-local-variable 'tex-start-of-header)
843 (make-local-variable 'tex-end-of-header)
844 (make-local-variable 'tex-trailer))
845
869bff31 846(defun tex-categorize-whitespace (backward-limit)
847 ;; compare-windows-whitespace is set to this.
848 ;; This is basically a finite-state machine.
849 ;; Returns a symbol telling how TeX would treat
850 ;; the whitespace we are looking at: null, space, or par.
851 (let ((category 'null)
852 (not-finished t))
853 (skip-chars-backward " \t\n\f" backward-limit)
854 (while not-finished
855 (cond ((looking-at "[ \t]+")
856 (goto-char (match-end 0))
2be5fefb 857 (if (eq category 'null)
869bff31 858 (setq category 'space)))
859 ((looking-at "\n")
2be5fefb 860 (cond ((eq category 'newline)
869bff31 861 (setq category 'par)
862 (setq not-finished nil))
863 (t
864 (setq category 'newline) ;a strictly internal state
865 (goto-char (match-end 0)))))
866 ((looking-at "\f+")
867 (setq category 'par)
868 (setq not-finished nil))
869 (t
870 (setq not-finished nil))))
871 (skip-chars-forward " \t\n\f")
2be5fefb 872 (if (eq category 'newline)
869bff31 873 'space ;TeX doesn't distinguish
874 category)))
875
876(defun tex-insert-quote (arg)
877 "Insert the appropriate quote marks for TeX.
08348502
RS
878Inserts the value of `tex-open-quote' (normally ``) or `tex-close-quote'
879\(normally '') depending on the context. With prefix argument, always
869bff31 880inserts \" characters."
528415e7 881 (interactive "*P")
869bff31 882 (if arg
883 (self-insert-command (prefix-numeric-value arg))
884 (insert
885 (cond ((or (bobp)
886 (save-excursion
887 (forward-char -1)
888 (looking-at "\\s(\\|\\s \\|\\s>")))
889 tex-open-quote)
890 ((= (preceding-char) ?\\)
891 ?\")
892 (t
893 tex-close-quote)))))
894
e6b0b773
MR
895(defun tex-validate-buffer ()
896 "Check current buffer for paragraphs containing mismatched braces or $s.
bbd93e41 897Their positions are recorded in the buffer `*Occur*'.
e6b0b773
MR
898To find a particular invalidity from `*Occur*', switch to that buffer
899and type C-c C-c or click with mouse-2
900on the line for the invalidity you want to see."
869bff31 901 (interactive)
bbd93e41
RS
902 (let ((buffer (current-buffer))
903 (prevpos (point-min))
e6b0b773
MR
904 (linenum nil)
905 (num-matches 0))
bbd93e41
RS
906 (with-output-to-temp-buffer "*Occur*"
907 (princ "Mismatches:\n")
908 (save-excursion
909 (set-buffer standard-output)
910 (occur-mode)
911 (setq occur-buffer buffer)
e6b0b773 912 (setq occur-nlines 0))
bbd93e41
RS
913 (save-excursion
914 (goto-char (point-max))
869bff31 915 (while (and (not (input-pending-p)) (not (bobp)))
710a0f53
KH
916 (let ((end (point))
917 prev-end)
bbd93e41 918 ;; Scan the previous paragraph for invalidities.
710a0f53
KH
919 (if (search-backward "\n\n" nil t)
920 (progn
921 (setq prev-end (point))
922 (forward-char 2))
923 (goto-char (setq prev-end (point-min))))
869bff31 924 (or (tex-validate-region (point) end)
710a0f53
KH
925 (let* ((oend end)
926 (end (save-excursion (forward-line 1) (point)))
bbd93e41
RS
927 start tem)
928 (beginning-of-line)
929 (setq start (point))
930 ;; Keep track of line number as we scan,
931 ;; in a cumulative fashion.
932 (if linenum
933 (setq linenum (- linenum (count-lines prevpos (point))))
934 (setq linenum (1+ (count-lines 1 start))))
935 (setq prevpos (point))
bed1b0c8 936 ;; Mention this mismatch in *Occur*.
bbd93e41 937 ;; Since we scan from end of buffer to beginning,
e6b0b773 938 ;; add each mismatch at the beginning of *Occur*.
bbd93e41
RS
939 (save-excursion
940 (setq tem (point-marker))
941 (set-buffer standard-output)
942 (goto-char (point-min))
943 ;; Skip "Mismatches:" header line.
944 (forward-line 1)
e6b0b773 945 (setq num-matches (1+ num-matches))
bbd93e41 946 (insert-buffer-substring buffer start end)
e6b0b773
MR
947 (let (text-beg (text-end (point-marker)))
948 (forward-char (- start end))
949 (setq text-beg (point-marker))
950 (insert (format "%3d: " linenum))
951 (put-text-property (marker-position text-beg)
952 (- (marker-position text-end) 1)
953 'mouse-face 'highlight)
954 (put-text-property (marker-position text-beg)
955 (- (marker-position text-end) 1)
956 'occur tem)))))
710a0f53 957 (goto-char prev-end))))
bbd93e41
RS
958 (save-excursion
959 (set-buffer standard-output)
e6b0b773 960 (if (eq num-matches 0)
bbd93e41
RS
961 (insert "None!\n"))
962 (if (interactive-p)
e6b0b773 963 (message "%d mismatches found" num-matches))))))
869bff31 964
965(defun tex-validate-region (start end)
966 "Check for mismatched braces or $'s in region.
967Returns t if no mismatches. Returns nil and moves point to suspect
968area if a mismatch is found."
969 (interactive "r")
970 (let ((failure-point nil) (max-possible-sexps (- end start)))
971 (save-excursion
972 (condition-case ()
973 (save-restriction
974 (narrow-to-region start end)
2ed2806c 975 ;; First check that the open and close parens balance in numbers.
869bff31 976 (goto-char start)
e6b0b773 977 (while (<= 0 (setq max-possible-sexps (1- max-possible-sexps)))
2ed2806c
KH
978 (forward-sexp 1))
979 ;; Now check that like matches like.
980 (goto-char start)
981 (while (progn (skip-syntax-forward "^(")
982 (not (eobp)))
983 (let ((match (matching-paren (following-char))))
984 (save-excursion
985 (forward-sexp 1)
986 (or (= (preceding-char) match)
987 (error "Mismatched parentheses"))))
988 (forward-char 1)))
869bff31 989 (error
bed1b0c8
RS
990 (skip-syntax-forward " .>")
991 (setq failure-point (point)))))
869bff31 992 (if failure-point
993 (progn
994 (goto-char failure-point)
995 nil)
996 t)))
997
998(defun tex-terminate-paragraph (inhibit-validation)
999 "Insert two newlines, breaking a paragraph for TeX.
81c735c0 1000Check for mismatched braces or $s in paragraph being terminated.
869bff31 1001A prefix arg inhibits the checking."
528415e7 1002 (interactive "*P")
869bff31 1003 (or inhibit-validation
1004 (save-excursion
1005 (tex-validate-region
bed1b0c8
RS
1006 (save-excursion
1007 (search-backward "\n\n" nil 'move)
1008 (point))
1009 (point)))
869bff31 1010 (message "Paragraph being closed appears to contain a mismatch"))
1011 (insert "\n\n"))
1012
1013(defun tex-insert-braces ()
1014 "Make a pair of braces and be poised to type inside of them."
528415e7 1015 (interactive "*")
869bff31 1016 (insert ?\{)
1017 (save-excursion
1018 (insert ?})))
1019
9bd4f69c
RS
1020;; This function is used as the value of fill-nobreak-predicate
1021;; in LaTeX mode. Its job is to prevent line-breaking inside
1022;; of a \verb construct.
1023(defun latex-fill-nobreak-predicate ()
1024 (let ((opoint (point))
1025 inside)
bed1b0c8 1026 (save-excursion
9bd4f69c
RS
1027 (save-restriction
1028 (beginning-of-line)
1029 (narrow-to-region (point) opoint)
1030 (while (re-search-forward "\\\\verb\\(.\\)" nil t)
1031 (unless (re-search-forward (regexp-quote (match-string 1)) nil t)
1032 (setq inside t)))))
1033 inside))
1034
53c4fe47
SM
1035(defvar latex-block-default "enumerate")
1036
869bff31 1037;;; Like tex-insert-braces, but for LaTeX.
cf149bdf
RS
1038(define-skeleton tex-latex-block
1039 "Create a matching pair of lines \\begin[OPT]{NAME} and \\end{NAME} at point.
869bff31 1040Puts point on a blank line between them."
53c4fe47
SM
1041 (let ((choice (completing-read (format "LaTeX block name [%s]: "
1042 latex-block-default)
1043 (mapcar 'list
1044 (append standard-latex-block-names
1045 latex-block-names))
1046 nil nil nil nil latex-block-default)))
1047 (setq latex-block-default choice)
1048 (unless (or (member choice standard-latex-block-names)
1049 (member choice latex-block-names))
1050 ;; Remember new block names for later completion.
1051 (push choice latex-block-names))
1052 choice)
1053 "\\begin{" str ?\}
1054 ?\[ (skeleton-read "[options]: ") & ?\] | -1
1055 \n _ \n
1056 "\\end{" str ?\} >)
1057
ea590e1c
SM
1058(define-skeleton latex-insert-item
1059 "Insert a \item macro."
1060 nil
1061 \n "\\item " >)
1062
53c4fe47
SM
1063\f
1064;;;;
1065;;;; LaTeX syntax navigation
1066;;;;
869bff31 1067
1068(defun tex-last-unended-begin ()
81c735c0 1069 "Leave point at the beginning of the last `\\begin{...}' that is unended."
53c4fe47
SM
1070 (while (and (re-search-backward "\\\\\\(begin\\|end\\)\\s *{")
1071 (looking-at "\\\\end"))
869bff31 1072 (tex-last-unended-begin)))
1073
53c4fe47
SM
1074(defun tex-next-unmatched-end ()
1075 "Leave point at the end of the next `\\end' that is unended."
1076 (while (and (re-search-forward "\\\\\\(begin\\|end\\)\\s *{[^}]+}")
ea590e1c
SM
1077 (save-excursion (goto-char (match-beginning 0))
1078 (looking-at "\\\\begin")))
53c4fe47
SM
1079 (tex-next-unmatched-end)))
1080
6a900cf1
ER
1081(defun tex-goto-last-unclosed-latex-block ()
1082 "Move point to the last unclosed \\begin{...}.
1083Mark is left at original location."
1084 (interactive)
1085 (let ((spot))
1086 (save-excursion
1087 (condition-case nil
1088 (tex-last-unended-begin)
1089 (error (error "Couldn't find unended \\begin")))
1090 (setq spot (point)))
1091 (push-mark)
1092 (goto-char spot)))
1093
53c4fe47
SM
1094(defun latex-backward-sexp-1 ()
1095 "Like (backward-sexp 1) but aware of multi-char elements."
1096 (let ((pos (point))
1097 (forward-sexp-function))
1098 (backward-sexp 1)
1099 (if (looking-at "\\\\begin\\>")
1100 (signal 'scan-error
1101 (list "Containing expression ends prematurely"
1102 (point) (prog1 (point) (goto-char pos))))
1103 (when (eq (char-after) ?{)
1104 (let ((newpos (point)))
1105 (when (ignore-errors (backward-sexp 1) t)
1106 (if (looking-at "\\\\end\\>")
1107 (tex-last-unended-begin)
1108 (goto-char newpos))))))))
1109
1110(defun latex-forward-sexp-1 ()
1111 "Like (forward-sexp 1) but aware of multi-char elements."
1112 (let ((pos (point))
1113 (forward-sexp-function))
1114 (forward-sexp 1)
1115 (let ((newpos (point)))
1116 (skip-syntax-backward "/w")
1117 (cond
1118 ((looking-at "\\\\end\\>")
1119 (signal 'scan-error
1120 (list "Containing expression ends prematurely"
1121 (point)
1122 (prog1
1123 (progn (ignore-errors (forward-sexp 2)) (point))
1124 (goto-char pos)))))
1125 ((looking-at "\\\\begin\\>")
1126 (goto-char (match-end 0))
1127 (tex-next-unmatched-end))
1128 (t (goto-char newpos))))))
1129
1130(defun latex-forward-sexp (&optional arg)
1131 "Like `forward-sexp' but aware of multi-char elements."
1132 (interactive "P")
1133 (unless arg (setq arg 1))
1134 (let ((pos (point)))
1135 (condition-case err
1136 (while (/= arg 0)
1137 (setq arg
1138 (if (> arg 0)
1139 (progn (latex-forward-sexp-1) (1- arg))
1140 (progn (latex-backward-sexp-1) (1+ arg)))))
1141 (scan-error
1142 (goto-char pos)
1143 (signal (car err) (cdr err))))))
1144
ea590e1c
SM
1145(defun latex-syntax-after ()
1146 "Like (char-syntax (char-after)) but aware of multi-char elements."
1147 (if (looking-at "\\\\end\\>") ?\) (char-syntax (char-after))))
1148
1149(defun latex-skip-close-parens ()
1150 "Like (skip-syntax-forward \" )\") but aware of multi-char elements."
1151 (let ((forward-sexp-function nil))
1152 (while (progn (skip-syntax-forward " )")
1153 (looking-at "\\\\end\\>"))
1154 (forward-sexp 2))))
1155
1156(defun latex-down-list ()
1157 "Like (down-list 1) but aware of multi-char elements."
1158 (forward-comment (point-max))
1159 (let ((forward-sexp-function nil))
1160 (if (not (looking-at "\\\\begin\\>"))
1161 (down-list 1)
1162 (forward-sexp 1)
1163 ;; Skip arguments.
1164 (while (looking-at "[ \t]*\\s(") (forward-sexp)))))
1165
869bff31 1166(defun tex-close-latex-block ()
1167 "Creates an \\end{...} to match the last unclosed \\begin{...}."
1168 (interactive "*")
1169 (let ((new-line-needed (bolp))
1170 text indentation)
1171 (save-excursion
528415e7 1172 (condition-case nil
869bff31 1173 (tex-last-unended-begin)
1174 (error (error "Couldn't find unended \\begin")))
1175 (setq indentation (current-column))
1176 (re-search-forward "\\\\begin\\(\\s *{[^}\n]*}\\)")
1177 (setq text (buffer-substring (match-beginning 1) (match-end 1))))
1178 (indent-to indentation)
1179 (insert "\\end" text)
1180 (if new-line-needed (insert ?\n))))
1181\f
1182;;; Invoking TeX in an inferior shell.
1183
1184;;; Why use a shell instead of running TeX directly? Because if TeX
1185;;; gets stuck, the user can switch to the shell window and type at it.
1186
1187;;; The utility functions:
1188
d974af30 1189;;;###autoload
869bff31 1190(defun tex-start-shell ()
d6709b80
SM
1191 (with-current-buffer
1192 (make-comint
1193 "tex-shell"
1194 (or tex-shell-file-name (getenv "ESHELL") (getenv "SHELL") "/bin/sh")
1195 nil)
528415e7
RS
1196 (let ((proc (get-process "tex-shell")))
1197 (set-process-sentinel proc 'tex-shell-sentinel)
1198 (process-kill-without-query proc)
e8c04c88 1199 (setq comint-prompt-regexp shell-prompt-pattern)
528415e7 1200 (use-local-map tex-shell-map)
f05bd645 1201 (compilation-shell-minor-mode t)
09592182
AS
1202 (add-hook 'comint-input-filter-functions 'shell-directory-tracker nil t)
1203 (make-local-variable 'list-buffers-directory)
1204 (make-local-variable 'shell-dirstack)
1205 (make-local-variable 'shell-last-dir)
1206 (make-local-variable 'shell-dirtrackp)
f05bd645 1207 (run-hooks 'tex-shell-hook)
528415e7 1208 (while (zerop (buffer-size))
51b2c841
RS
1209 (sleep-for 1)))))
1210
033306e3
RS
1211(defun tex-feed-input ()
1212 "Send input to the tex shell process.
1213In the tex buffer this can be used to continue an interactive tex run.
bed1b0c8 1214In the tex shell buffer this command behaves like `comint-send-input'."
033306e3
RS
1215 (interactive)
1216 (set-buffer (process-buffer (get-process "tex-shell")))
1217 (comint-send-input)
1218 (tex-recenter-output-buffer nil))
1219
51b2c841
RS
1220(defun tex-display-shell ()
1221 "Make the TeX shell buffer visible in a window."
1222 (display-buffer (process-buffer (get-process "tex-shell")))
1223 (tex-recenter-output-buffer nil))
528415e7
RS
1224
1225(defun tex-shell-sentinel (proc msg)
1226 (cond ((null (buffer-name (process-buffer proc)))
1227 ;; buffer killed
1228 (set-process-buffer proc nil)
1229 (tex-delete-last-temp-files))
1230 ((memq (process-status proc) '(signal exit))
1231 (tex-delete-last-temp-files))))
1232
1233(defun tex-set-buffer-directory (buffer directory)
869bff31 1234 "Set BUFFER's default directory to be DIRECTORY."
1235 (setq directory (file-name-as-directory (expand-file-name directory)))
1236 (if (not (file-directory-p directory))
1237 (error "%s is not a directory" directory)
1238 (save-excursion
1239 (set-buffer buffer)
1240 (setq default-directory directory))))
1241
30803a05
RS
1242(defvar tex-send-command-modified-tick 0)
1243(make-variable-buffer-local 'tex-send-command-modified-tick)
1244
528415e7 1245(defun tex-send-command (command &optional file background)
4cdc1d4b 1246 "Send COMMAND to TeX shell process, substituting optional FILE for *.
8241d7b9
ER
1247Do this in background if optional BACKGROUND is t. If COMMAND has no *,
1248FILE will be appended, preceded by a blank, to COMMAND. If FILE is nil, no
1249substitution will be made in COMMAND. COMMAND can be any expression that
460e1b7d
RS
1250evaluates to a command string.
1251
1252Return the process in which TeX is running."
528415e7
RS
1253 (save-excursion
1254 (let* ((cmd (eval command))
c93931c3 1255 (proc (or (get-process "tex-shell") (error "No TeX subprocess")))
64db2461 1256 (buf (process-buffer proc))
4f45adda 1257 (star (string-match "\\*" cmd))
4cdc1d4b
RS
1258 (string
1259 (concat
1260 (if file
1261 (if star (concat (substring cmd 0 star)
1262 file (substring cmd (1+ star)))
1263 (concat cmd " " file))
1264 cmd)
1265 (if background "&" ""))))
64db2461
RS
1266 ;; Switch to buffer before checking for subproc output in it.
1267 (set-buffer buf)
30803a05
RS
1268 ;; If text is unchanged since previous tex-send-command,
1269 ;; we haven't got any output. So wait for output now.
64db2461 1270 (if (= (buffer-modified-tick buf) tex-send-command-modified-tick)
30803a05 1271 (accept-process-output proc))
4cdc1d4b
RS
1272 (goto-char (process-mark proc))
1273 (insert string)
30803a05 1274 (comint-send-input)
460e1b7d
RS
1275 (setq tex-send-command-modified-tick (buffer-modified-tick buf))
1276 proc)))
528415e7 1277
a15849cb
RS
1278(defun tex-delete-last-temp-files (&optional not-all)
1279 "Delete any junk files from last temp file.
1280If NOT-ALL is non-nil, save the `.dvi' file."
528415e7
RS
1281 (if tex-last-temp-file
1282 (let* ((dir (file-name-directory tex-last-temp-file))
adf6b7f9
KH
1283 (list (and (file-directory-p dir)
1284 (file-name-all-completions
02fd229c
RS
1285 (file-name-sans-extension
1286 (file-name-nondirectory tex-last-temp-file))
1287 dir))))
adf6b7f9 1288 (while list
a15849cb
RS
1289 (if not-all
1290 (and
1291 ;; If arg is non-nil, don't delete the .dvi file.
1292 (not (string-match "\\.dvi$" (car list)))
1293 (delete-file (concat dir (car list))))
1294 (delete-file (concat dir (car list))))
528415e7
RS
1295 (setq list (cdr list))))))
1296
99621a14 1297(add-hook 'kill-emacs-hook 'tex-delete-last-temp-files)
869bff31 1298
460e1b7d
RS
1299(defvar tex-start-tex-marker nil
1300 "Marker pointing after last TeX-running command in the TeX shell buffer.")
1301
d6709b80
SM
1302(defun tex-main-file ()
1303 (let ((file (or tex-main-file
1304 ;; Compatibility with AUCTeX
1305 (and (boundp 'TeX-master) (stringp TeX-master) TeX-master)
1306 (if (buffer-file-name)
1307 (file-relative-name (buffer-file-name))
1308 (error "Buffer is not associated with any file")))))
1309 (if (string-match "\\.tex\\'" file)
1310 (substring file 0 (match-beginning 0))
1311 file)))
1312
1313(defun tex-start-tex (command file &optional dir)
460e1b7d 1314 "Start a TeX run, using COMMAND on FILE."
6633b891 1315 (let* ((star (string-match "\\*" command))
460e1b7d 1316 (compile-command
6633b891
KH
1317 (if star
1318 (concat (substring command 0 star)
1319 (comint-quote-filename file)
1320 (substring command (1+ star)))
1321 (concat command " "
c3ce7bf4
RS
1322 (if (< 0 (length tex-start-options-string))
1323 (concat
1324 (shell-quote-argument tex-start-options-string) " "))
6633b891 1325 (comint-quote-filename file)))))
d6709b80
SM
1326 (when dir
1327 (let (shell-dirtrack-verbose)
1328 (tex-send-command tex-shell-cd-command dir)))
460e1b7d
RS
1329 (with-current-buffer (process-buffer (tex-send-command compile-command))
1330 (save-excursion
1331 (forward-line -1)
1332 (setq tex-start-tex-marker (point-marker)))
1333 (make-local-variable 'compilation-parse-errors-function)
f05bd645 1334 (setq compilation-parse-errors-function 'tex-compilation-parse-errors)
d6709b80
SM
1335 (compilation-forget-errors))
1336 (tex-display-shell)
1337 (setq tex-last-buffer-texed (current-buffer))))
460e1b7d
RS
1338\f
1339(defun tex-compilation-parse-errors (limit-search find-at-least)
f05bd645
RS
1340 "Parse the current buffer as TeX error messages.
1341See the variable `compilation-parse-errors-function' for the interface it uses.
1342
1343This function parses only the last TeX compilation.
1344It works on TeX compilations only. It is necessary for that purpose,
1345since TeX does not put file names and line numbers on the same line as
1346for the error messages."
460e1b7d
RS
1347 (require 'thingatpt)
1348 (setq compilation-error-list nil)
1349 (message "Parsing error messages...")
f05bd645
RS
1350 (let ((default-directory ; Perhaps dir has changed meanwhile.
1351 (file-name-directory (buffer-file-name tex-last-buffer-texed)))
1352 (old-syntax-table (syntax-table))
1353 (tex-error-parse-syntax-table (copy-syntax-table (syntax-table)))
1354 found-desired (num-errors-found 0)
1355 last-filename last-linenum last-position
1356 begin-of-error end-of-error)
1357 (modify-syntax-entry ?\{ "_" tex-error-parse-syntax-table)
1358 (modify-syntax-entry ?\} "_" tex-error-parse-syntax-table)
1359 (modify-syntax-entry ?\[ "_" tex-error-parse-syntax-table)
1360 (modify-syntax-entry ?\] "_" tex-error-parse-syntax-table)
1361 ;; Single quotations may appear in errors
1362 (modify-syntax-entry ?\" "_" tex-error-parse-syntax-table)
1363 ;; Don't parse previous compilations.
ee13a145
RS
1364 (set-marker compilation-parsing-end
1365 (max compilation-parsing-end tex-start-tex-marker))
f05bd645
RS
1366 ;; Don't reparse messages already seen at last parse.
1367 (goto-char compilation-parsing-end)
1368 ;; Parse messages.
1369 (while (and (not (or found-desired (eobp)))
1370 (prog1 (re-search-forward "^! " nil 'move)
1371 (setq begin-of-error (match-beginning 0)
1372 end-of-error (match-end 0)))
1373 (re-search-forward
1374 "^l\\.\\([0-9]+\\) \\(\\.\\.\\.\\)?\\(.*\\)$" nil 'move))
1375 (let* ((this-error (set-marker (make-marker) begin-of-error))
1376 (linenum (string-to-int (match-string 1)))
1377 (error-text (regexp-quote (match-string 3)))
1378 (filename
1379 (save-excursion
ea590e1c
SM
1380 (with-syntax-table tex-error-parse-syntax-table
1381 (backward-up-list 1)
1382 (skip-syntax-forward "(_")
1383 (while (not (file-readable-p (thing-at-point 'filename)))
1384 (skip-syntax-backward "(_")
1385 (backward-up-list 1)
1386 (skip-syntax-forward "(_"))
1387 (thing-at-point 'filename))))
f05bd645
RS
1388 (new-file
1389 (or (null last-filename)
1390 (not (string-equal last-filename filename))))
1391 (error-location
1392 (save-excursion
1393 (if (equal filename (concat tex-zap-file ".tex"))
1394 (set-buffer tex-last-buffer-texed)
1395 (set-buffer (find-file-noselect filename)))
1396 (if new-file
1397 (goto-line linenum)
1398 (goto-char last-position)
1399 (forward-line (- linenum last-linenum)))
1400 ;; first try a forward search for the error text,
1401 ;; then a backward search limited by the last error.
1402 (let ((starting-point (point)))
1403 (or (re-search-forward error-text nil t)
1404 (re-search-backward
1405 error-text
1406 (marker-position last-position) t)
1407 (goto-char starting-point)))
1408 (point-marker))))
1409 (goto-char this-error)
1410 (if (and compilation-error-list
1411 (or (and find-at-least
1412 (>= num-errors-found
1413 find-at-least))
1414 (and limit-search
1415 (>= end-of-error limit-search)))
1416 new-file)
1417 (setq found-desired t)
1418 (setq num-errors-found (1+ num-errors-found)
1419 last-filename filename
1420 last-linenum linenum
1421 last-position error-location
1422 compilation-error-list ; Add the new error
1423 (cons (cons this-error error-location)
1424 compilation-error-list))
1425 (goto-char end-of-error)))))
ee13a145 1426 (set-marker compilation-parsing-end (point))
f05bd645 1427 (setq compilation-error-list (nreverse compilation-error-list))
460e1b7d
RS
1428 (message "Parsing error messages...done"))
1429\f
528415e7 1430;;; The commands:
869bff31 1431
1432(defun tex-region (beg end)
1433 "Run TeX on the current region, via a temporary file.
1434The file's name comes from the variable `tex-zap-file' and the
1435variable `tex-directory' says where to put it.
1436
1437If the buffer has a header, the header is given to TeX before the
1438region itself. The buffer's header is all lines between the strings
1439defined by `tex-start-of-header' and `tex-end-of-header' inclusive.
1440The header must start in the first 100 lines of the buffer.
1441
1442The value of `tex-trailer' is given to TeX as input after the region.
1443
1444The value of `tex-command' specifies the command to use to run TeX."
1445 (interactive "r")
1446 (if (tex-shell-running)
1447 (tex-kill-job)
1448 (tex-start-shell))
1449 (or tex-zap-file
1450 (setq tex-zap-file (tex-generate-zap-file-name)))
6d34c59f
RS
1451 ;; Temp file will be written and TeX will be run in zap-directory.
1452 ;; If the TEXINPUTS file has relative directories or if the region has
1453 ;; \input of files, this must be the same directory as the file for
1454 ;; TeX to access the correct inputs. That's why it's safest if
1455 ;; tex-directory is ".".
1456 (let* ((zap-directory
528415e7 1457 (file-name-as-directory (expand-file-name tex-directory)))
d6709b80
SM
1458 (tex-out-file (expand-file-name (concat tex-zap-file ".tex")
1459 zap-directory)))
0d548e5d
RS
1460 ;; Don't delete temp files if we do the same buffer twice in a row.
1461 (or (eq (current-buffer) tex-last-buffer-texed)
1462 (tex-delete-last-temp-files t))
869bff31 1463 ;; Write the new temp file.
1464 (save-excursion
1465 (save-restriction
1466 (widen)
1467 (goto-char (point-min))
1468 (forward-line 100)
1469 (let ((search-end (point))
6d34c59f
RS
1470 (default-directory zap-directory)
1471 (already-output 0))
869bff31 1472 (goto-char (point-min))
6d34c59f 1473
725b7428
RS
1474 ;; Maybe copy first line, such as `\input texinfo', to temp file.
1475 (and tex-first-line-header-regexp
1476 (looking-at tex-first-line-header-regexp)
bed1b0c8 1477 (write-region (point)
6d34c59f
RS
1478 (progn (forward-line 1)
1479 (setq already-output (point)))
725b7428
RS
1480 tex-out-file nil nil))
1481
6d34c59f
RS
1482 ;; Write out the header, if there is one,
1483 ;; and any of the specified region which extends before it.
1484 ;; But don't repeat anything already written.
898b9ac1 1485 (if (re-search-forward tex-start-of-header search-end t)
6d34c59f 1486 (let (hbeg)
869bff31 1487 (beginning-of-line)
1488 (setq hbeg (point)) ;mark beginning of header
898b9ac1 1489 (if (re-search-forward tex-end-of-header nil t)
6d34c59f
RS
1490 (let (hend)
1491 (forward-line 1)
bed1b0c8 1492 (setq hend (point)) ;mark end of header
6d34c59f
RS
1493 (write-region (max (min hbeg beg) already-output)
1494 hend
1495 tex-out-file
1496 (not (zerop already-output)) nil)
1497 (setq already-output hend)))))
1498
1499 ;; Write out the specified region
1500 ;; (but don't repeat anything already written).
1501 (write-region (max beg already-output) end
1502 tex-out-file
1503 (not (zerop already-output)) nil))
1504 ;; Write the trailer, if any.
1505 ;; Precede it with a newline to make sure it
1506 ;; is not hidden in a comment.
1507 (if tex-trailer
1508 (write-region (concat "\n" tex-trailer) nil
1509 tex-out-file t nil))))
528415e7
RS
1510 ;; Record the file name to be deleted afterward.
1511 (setq tex-last-temp-file tex-out-file)
f05bd645
RS
1512 ;; Use a relative file name here because (1) the proper dir
1513 ;; is already current, and (2) the abs file name is sometimes
1514 ;; too long and can make tex crash.
d6709b80
SM
1515 (tex-start-tex tex-command (concat tex-zap-file ".tex") zap-directory)
1516 (setq tex-print-file tex-out-file)))
869bff31 1517
1518(defun tex-buffer ()
1519 "Run TeX on current buffer. See \\[tex-region] for more information.
528415e7
RS
1520Does not save the buffer, so it's useful for trying experimental versions.
1521See \\[tex-file] for an alternative."
869bff31 1522 (interactive)
1523 (tex-region (point-min) (point-max)))
1524
1525(defun tex-file ()
1526 "Prompt to save all buffers and run TeX (or LaTeX) on current buffer's file.
1527This function is more useful than \\[tex-buffer] when you need the
1528`.aux' file of LaTeX to have the correct name."
1529 (interactive)
d6709b80
SM
1530 (let* ((source-file (tex-main-file))
1531 (file-dir (expand-file-name (file-name-directory source-file))))
7047ec77 1532 (if tex-offer-save
99621a14 1533 (save-some-buffers))
869bff31 1534 (if (tex-shell-running)
1535 (tex-kill-job)
1536 (tex-start-shell))
d6709b80 1537 (tex-start-tex tex-command source-file file-dir)
f05bd645 1538 (setq tex-print-file (expand-file-name source-file))))
869bff31 1539
1540(defun tex-generate-zap-file-name ()
1541 "Generate a unique name suitable for use as a file name."
1542 ;; Include the shell process number and host name
1543 ;; in case there are multiple shells (for same or different user).
f5cdb851
KH
1544 ;; Dec 1998: There is a report that some versions of xdvi
1545 ;; don't work with file names that start with #.
5616ee46 1546 (format "_TZ_%d-%s"
869bff31 1547 (process-id (get-buffer-process "*tex-shell*"))
1548 (tex-strip-dots (system-name))))
1549
1550(defun tex-strip-dots (s)
1551 (setq s (copy-sequence s))
1552 (while (string-match "\\." s)
1553 (aset s (match-beginning 0) ?-))
1554 s)
1555
1556;; This will perhaps be useful for modifying TEXINPUTS.
1557;; Expand each file name, separated by colons, in the string S.
1558(defun tex-expand-files (s)
1559 (let (elts (start 0))
1560 (while (string-match ":" s start)
1561 (setq elts (cons (substring s start (match-beginning 0)) elts))
1562 (setq start (match-end 0)))
1563 (or (= start 0)
1564 (setq elts (cons (substring s start) elts)))
c0df1972
SM
1565 (mapconcat (lambda (elt)
1566 (if (= (length elt) 0) elt (expand-file-name elt)))
5616ee46 1567 (nreverse elts) ":")))
869bff31 1568
1569(defun tex-shell-running ()
1570 (and (get-process "tex-shell")
1571 (eq (process-status (get-process "tex-shell")) 'run)))
1572
1573(defun tex-kill-job ()
1574 "Kill the currently running TeX job."
1575 (interactive)
bed1b0c8
RS
1576 ;; quit-process leads to core dumps of the tex process (except if
1577 ;; coredumpsize has limit 0kb as on many environments). One would
1578 ;; like to use (kill-process proc 'lambda), however that construct
1579 ;; does not work on some systems and kills the shell itself.
528415e7 1580 (quit-process (get-process "tex-shell") t))
869bff31 1581
1582(defun tex-recenter-output-buffer (linenum)
1583 "Redisplay buffer of TeX job output so that most recent output can be seen.
1584The last line of the buffer is displayed on
1585line LINE of the window, or centered if LINE is nil."
1586 (interactive "P")
1587 (let ((tex-shell (get-buffer "*tex-shell*"))
23b64225
RS
1588 (old-buffer (current-buffer))
1589 (window))
869bff31 1590 (if (null tex-shell)
1591 (message "No TeX output buffer")
23b64225
RS
1592 (setq window (display-buffer tex-shell))
1593 (save-selected-window
1594 (select-window window)
1595 (bury-buffer tex-shell)
1596 (goto-char (point-max))
1597 (recenter (if linenum
1598 (prefix-numeric-value linenum)
1599 (/ (window-height) 2)))))))
869bff31 1600
528415e7 1601(defun tex-print (&optional alt)
869bff31 1602 "Print the .dvi file made by \\[tex-region], \\[tex-buffer] or \\[tex-file].
1433a222
CZ
1603Runs the shell command defined by `tex-dvi-print-command'. If prefix argument
1604is provided, use the alternative command, `tex-alt-dvi-print-command'."
528415e7 1605 (interactive "P")
869bff31 1606 (let ((print-file-name-dvi (tex-append tex-print-file ".dvi"))
1607 test-name)
1608 (if (and (not (equal (current-buffer) tex-last-buffer-texed))
45c3304d
RS
1609 (buffer-file-name)
1610 ;; Check that this buffer's printed file is up to date.
869bff31 1611 (file-newer-than-file-p
1612 (setq test-name (tex-append (buffer-file-name) ".dvi"))
45c3304d 1613 (buffer-file-name)))
869bff31 1614 (setq print-file-name-dvi test-name))
528415e7
RS
1615 (if (not (file-exists-p print-file-name-dvi))
1616 (error "No appropriate `.dvi' file could be found")
460e1b7d
RS
1617 (if (tex-shell-running)
1618 (tex-kill-job)
1619 (tex-start-shell))
528415e7 1620 (tex-send-command
bed1b0c8
RS
1621 (if alt tex-alt-dvi-print-command tex-dvi-print-command)
1622 print-file-name-dvi t))))
869bff31 1623
cf6d6e8a
RS
1624(defun tex-alt-print ()
1625 "Print the .dvi file made by \\[tex-region], \\[tex-buffer] or \\[tex-file].
002b0d00 1626Runs the shell command defined by `tex-alt-dvi-print-command'."
cf6d6e8a
RS
1627 (interactive)
1628 (tex-print t))
1629
869bff31 1630(defun tex-view ()
1631 "Preview the last `.dvi' file made by running TeX under Emacs.
1632This means, made using \\[tex-region], \\[tex-buffer] or \\[tex-file].
2b7971c9
RS
1633The variable `tex-dvi-view-command' specifies the shell command for preview.
1634You must set that variable yourself before using this command,
1635because there is no standard value that would generally work."
869bff31 1636 (interactive)
2b7971c9
RS
1637 (or tex-dvi-view-command
1638 (error "You must set `tex-dvi-view-command'"))
869bff31 1639 (let ((tex-dvi-print-command tex-dvi-view-command))
1640 (tex-print)))
1641
1642(defun tex-append (file-name suffix)
1643 "Append to FILENAME the suffix SUFFIX, using same algorithm TeX uses.
cf6d6e8a 1644Pascal-based TeX scans for the first period, C TeX uses the last.
869bff31 1645No period is retained immediately before SUFFIX,
1646so normally SUFFIX starts with one."
1647 (if (stringp file-name)
cf6d6e8a
RS
1648 (let ((file (file-name-nondirectory file-name))
1649 trial-name)
6da9bbd6 1650 ;; Try splitting on last period.
7d0ca249
RS
1651 ;; The first-period split can get fooled when two files
1652 ;; named a.tex and a.b.tex are both tex'd;
1653 ;; the last-period split must be right if it matches at all.
cf6d6e8a
RS
1654 (setq trial-name
1655 (concat (file-name-directory file-name)
1656 (substring file 0
7d0ca249 1657 (string-match "\\.[^.]*$" file))
cf6d6e8a
RS
1658 suffix))
1659 (if (or (file-exists-p trial-name)
1660 (file-exists-p (concat trial-name ".aux"))) ;for BibTeX files
1661 trial-name
7d0ca249 1662 ;; Not found, so split on first period.
cf6d6e8a
RS
1663 (concat (file-name-directory file-name)
1664 (substring file 0
7d0ca249 1665 (string-match "\\." file))
cf6d6e8a 1666 suffix)))
869bff31 1667 " "))
1668
1669(defun tex-show-print-queue ()
1670 "Show the print queue that \\[tex-print] put your job on.
1433a222 1671Runs the shell command defined by `tex-show-queue-command'."
869bff31 1672 (interactive)
1673 (if (tex-shell-running)
1674 (tex-kill-job)
1675 (tex-start-shell))
51b2c841
RS
1676 (tex-send-command tex-show-queue-command)
1677 (tex-display-shell))
869bff31 1678
1679(defun tex-bibtex-file ()
1680 "Run BibTeX on the current buffer's file."
1681 (interactive)
1682 (if (tex-shell-running)
1683 (tex-kill-job)
1684 (tex-start-shell))
e6b0b773
MR
1685 (let (shell-dirtrack-verbose
1686 (tex-out-file
869bff31 1687 (tex-append (file-name-nondirectory (buffer-file-name)) ""))
1688 (file-dir (file-name-directory (buffer-file-name))))
528415e7 1689 (tex-send-command tex-shell-cd-command file-dir)
51b2c841
RS
1690 (tex-send-command tex-bibtex-command tex-out-file))
1691 (tex-display-shell))
ea590e1c
SM
1692\f
1693;;;;
1694;;;; LaTeX indentation
1695;;;;
1696
1697(defvar tex-indent-allhanging t)
1698(defvar tex-indent-arg 4)
1699(defvar tex-indent-basic 2)
1700(defvar tex-indent-item tex-indent-basic)
1701(defvar tex-indent-item-re "\\\\\\(bib\\)?item\\>")
1702
1703(easy-mmode-defsyntax tex-latex-indent-syntax-table
1704 '((?$ . "."))
1705 "Syntax table used while computing indentation."
1706 :copy tex-mode-syntax-table)
1707
1708(defun latex-indent (&optional arg)
1709 (with-syntax-table tex-latex-indent-syntax-table
1710 ;; TODO: Rather than ignore $, we should try to be more clever about it.
1711 (let ((indent
1712 (save-excursion
1713 (beginning-of-line)
1714 (latex-find-indent))))
1715 (if (< indent 0) (setq indent 0))
1716 (if (<= (current-column) (current-indentation))
1717 (indent-line-to indent)
1718 (save-excursion (indent-line-to indent))))))
1719
1720(defun latex-find-indent (&optional virtual)
1721 "Find the proper indentation of text after point.
1722VIRTUAL if non-nil indicates that we're only trying to find the indentation
1723 in order to determine the indentation of something else.
1724There might be text before point."
1725 (save-excursion
1726 (skip-chars-forward " \t")
1727 (or
1728 ;; Trust the current indentation, if such info is applicable.
1729 (and virtual (>= (current-indentation) (current-column))
1730 (current-indentation))
1731 ;; Put leading close-paren where the matching open brace would be.
1732 (and (eq (latex-syntax-after) ?\))
1733 (ignore-errors
1734 (save-excursion
1735 (latex-skip-close-parens)
1736 (latex-backward-sexp-1)
1737 (latex-find-indent 'virtual))))
1738 ;; Default (maybe an argument)
1739 (let ((pos (point))
1740 (char (char-after))
1741 ;; Outdent \item if necessary.
1742 (indent (if (looking-at tex-indent-item-re) (- tex-indent-item) 0))
1743 up-list-pos)
1744 ;; Find the previous point which determines our current indentation.
1745 (condition-case err
1746 (progn
1747 (latex-backward-sexp-1)
1748 (while (> (current-column) (current-indentation))
1749 (latex-backward-sexp-1)))
1750 (scan-error
1751 (setq up-list-pos (nth 2 err))))
1752 (if (integerp up-list-pos)
1753 ;; Have to indent relative to the open-paren.
1754 (progn
1755 (goto-char up-list-pos)
1756 (if (and (not tex-indent-allhanging)
1757 (> pos (progn (latex-down-list)
1758 (forward-comment (point-max))
1759 (point))))
1760 ;; Align with the first element after the open-paren.
1761 (current-column)
1762 ;; We're the first element after a hanging brace.
1763 (goto-char up-list-pos)
1764 (+ indent tex-indent-basic (latex-find-indent 'virtual))))
1765 ;; We're now at the beginning of a line.
1766 (if (not (and (not virtual) (eq (char-after) ?\\)))
1767 ;; Nothing particular here: just keep the same indentation.
1768 (+ indent (current-column))
1769 ;; We're now looking at a macro call.
1770 (if (looking-at tex-indent-item-re)
1771 ;; Indenting relative to an item, have to re-add the outdenting.
1772 (+ indent (current-column) tex-indent-item)
1773 (let ((col (current-column)))
1774 (if (not (eq (char-syntax char) ?\())
1775 ;; If the first char was not an open-paren, there's
1776 ;; a risk that this is really not an argument to the
1777 ;; macro at all.
1778 (+ indent col)
1779 (forward-sexp 1)
1780 (if (< (line-end-position)
1781 (save-excursion (forward-comment (point-max))
1782 (point)))
1783 ;; we're indenting the first argument.
1784 (min (current-column) (+ tex-indent-arg col))
1785 (skip-syntax-forward " ")
1786 (current-column)))))))))))
528415e7
RS
1787
1788(run-hooks 'tex-mode-load-hook)
869bff31 1789
49116ac0
JB
1790(provide 'tex-mode)
1791
d501f516 1792;;; tex-mode.el ends here