1 ;;; reftex-toc.el --- RefTeX's table of contents mode
2 ;; Copyright (c) 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
4 ;; Author: Carsten Dominik <dominik@strw.LeidenUniv.nl>
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software; you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation; either version 2, or (at your option)
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs; see the file COPYING. If not, write to the
21 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22 ;; Boston, MA 02111-1307, USA.
28 (eval-when-compile (require 'cl
))
33 (defvar reftex-toc-map
(make-sparse-keymap)
34 "Keymap used for *toc* buffer.")
36 (defvar reftex-toc-menu
)
38 (defun reftex-toc-mode ()
39 "Major mode for managing Table of Contents for LaTeX files.
40 This buffer was created with RefTeX.
41 Press `?' for a summary of important key bindings.
43 Here are all local bindings.
47 (kill-all-local-variables)
48 (setq major-mode
'reftex-toc-mode
50 (use-local-map reftex-toc-map
)
51 (set (make-local-variable 'revert-buffer-function
) 'reftex-toc-revert
)
52 (set (make-local-variable 'reftex-toc-include-labels-indicator
) "")
53 (set (make-local-variable 'reftex-toc-max-level-indicator
)
54 (if (= reftex-toc-max-level
100)
56 (int-to-string reftex-toc-max-level
)))
57 (setq mode-line-format
58 (list "---- " 'mode-line-buffer-identification
59 " " 'global-mode-string
" (" mode-name
")"
60 " L<" 'reftex-toc-include-labels-indicator
">"
61 " I<" 'reftex-toc-include-index-indicator
">"
62 " T<" 'reftex-toc-max-level-indicator
">"
64 (setq truncate-lines t
)
65 (make-local-hook 'post-command-hook
)
66 (make-local-hook 'pre-command-hook
)
67 (make-local-variable 'reftex-last-follow-point
)
68 (add-hook 'post-command-hook
'reftex-toc-post-command-hook nil t
)
69 (add-hook 'pre-command-hook
'reftex-toc-pre-command-hook nil t
)
70 (easy-menu-add reftex-toc-menu reftex-toc-map
)
71 (run-hooks 'reftex-toc-mode-hook
))
73 (defvar reftex-last-toc-file nil
74 "Stores the file name from which `reftex-toc' was called. For redo command.")
76 (defvar reftex-last-window-height nil
)
77 (defvar reftex-toc-include-labels-indicator nil
)
78 (defvar reftex-toc-include-index-indicator nil
)
79 (defvar reftex-toc-max-level-indicator nil
)
81 (defvar reftex-toc-return-marker
(make-marker)
82 "Marker which makes it possible to return from toc to old position.")
84 (defconst reftex-toc-help
85 " AVAILABLE KEYS IN TOC BUFFER
86 ============================
87 n / p next-line / previous-line
88 SPC Show the corresponding location of the LaTeX document.
89 TAB Goto the location and keep the *toc* window.
90 RET Goto the location and hide the *toc* window (also on mouse-2).
91 C-c > Display Index. With prefix arg, restrict index to current section.
92 q / k Hide/Kill *toc* buffer, return to position of reftex-toc command.
93 l i c F Toggle display of [l]abels, [i]ndex, [c]ontext, [F]ile borders.
94 t Change maximum toc depth (e.g. `3 t' hides levels greater than 3).
95 f / g Toggle follow mode on and off / Refresh *toc* buffer.
96 r / C-u r Reparse the LaTeX document / Reparse entire LaTeX document.
97 . In other window, show position from where `reftex-toc' was called.
98 x Switch to TOC of external document (with LaTeX package `xr').
99 z Jump to a specific section (e.g. '3 z' goes to section 3")
101 (defun reftex-toc (&optional rebuild
)
102 "Show the table of contents for the current document.
103 When called with a raw C-u prefix, rescan the document first."
107 (if (or (not (string= reftex-last-toc-master
(reftex-TeX-master-file)))
109 (reftex-erase-buffer "*toc*"))
111 (setq reftex-last-toc-file
(buffer-file-name))
112 (setq reftex-last-toc-master
(reftex-TeX-master-file))
114 (set-marker reftex-toc-return-marker
(point))
116 ;; If follow mode is active, arrange to delay it one command
117 (if reftex-toc-follow-mode
118 (setq reftex-toc-follow-mode
1))
120 (and reftex-toc-include-index-entries
121 (reftex-ensure-index-support))
122 (or reftex-support-index
123 (setq reftex-toc-include-index-entries nil
))
125 ;; Ensure access to scanning info and rescan buffer if prefix are is '(4)
126 (reftex-access-scan-info current-prefix-arg
)
128 (let* ((this-buf (current-buffer))
129 (docstruct-symbol reftex-docstruct-symbol
)
130 (xr-data (assq 'xr
(symbol-value reftex-docstruct-symbol
)))
131 (xr-alist (cons (cons "" (buffer-file-name)) (nth 1 xr-data
)))
132 (here-I-am (if rebuild
133 (get 'reftex-toc
:reftex-data
)
134 (car (reftex-where-am-I))))
137 (if (get-buffer-window "*toc*")
138 (select-window (get-buffer-window "*toc*"))
139 (when (or (not reftex-toc-keep-other-windows
)
140 (< (window-height) (* 2 window-min-height
)))
141 (delete-other-windows))
142 (setq reftex-last-window-height
(window-height)) ; remember
144 (let ((default-major-mode 'reftex-toc-mode
))
145 (switch-to-buffer "*toc*")))
147 (or (eq major-mode
'reftex-toc-mode
) (reftex-toc-mode))
148 (set (make-local-variable 'reftex-docstruct-symbol
) docstruct-symbol
)
149 (setq reftex-toc-include-labels-indicator
150 (if (eq reftex-toc-include-labels t
)
152 reftex-toc-include-labels
))
153 (setq reftex-toc-include-index-indicator
154 (if (eq reftex-toc-include-index-entries t
)
156 reftex-toc-include-index-entries
))
160 ;; buffer is empty - fill it with the table of contents
161 (message "Building *toc* buffer...")
163 (setq buffer-read-only nil
)
165 "TABLE-OF-CONTENTS on %s
166 SPC=view TAB=goto RET=goto+hide [q]uit [r]escan [l]abels [f]ollow [x]r [?]Help
167 ------------------------------------------------------------------------------
168 " (abbreviate-file-name reftex-last-toc-master
)))
170 (if (reftex-use-fonts)
171 (put-text-property 1 (point) 'face reftex-toc-header-face
))
172 (put-text-property 1 (point) 'intangible t
)
173 (put-text-property 1 2 'xr-alist xr-alist
)
176 (reftex-insert-docstruct
179 reftex-toc-include-labels
180 reftex-toc-include-index-entries
181 reftex-toc-include-file-boundaries
182 reftex-toc-include-context
190 (run-hooks 'reftex-display-copied-context-hook
)
191 (message "Building *toc* buffer...done.")
192 (setq buffer-read-only t
))
194 ;; Only compute the offset
196 (or (reftex-get-offset this-buf here-I-am
197 (if reftex-toc-include-labels
" " nil
)
199 reftex-toc-include-index-entries
200 reftex-toc-include-file-boundaries
)
201 (reftex-last-assoc-before-elt
203 (symbol-value reftex-docstruct-symbol
))))
204 (put 'reftex-toc
:reftex-line
3)
206 (beginning-of-line)))
208 ;; Find the correct starting point
209 (reftex-find-start-point (point) offset
(get 'reftex-toc
:reftex-line
))
210 (setq reftex-last-follow-point
(point))))
212 (defun reftex-toc-pre-command-hook ()
213 ;; used as pre command hook in *toc* buffer
214 (reftex-unhighlight 0)
215 (reftex-unhighlight 1))
217 (defun reftex-toc-post-command-hook ()
218 ;; used in the post-command-hook for the *toc* buffer
219 (when (get-text-property (point) :data
)
220 (put 'reftex-toc
:reftex-data
(get-text-property (point) :data
))
222 (not (get-text-property (point) 'intangible
))
223 (memq reftex-highlight-selection
'(cursor both
))
225 (or (previous-single-property-change (1+ (point)) :data
)
227 (or (next-single-property-change (point) :data
)
229 (if (integerp reftex-toc-follow-mode
)
230 ;; remove delayed action
231 (setq reftex-toc-follow-mode t
)
232 (and reftex-toc-follow-mode
233 (not (equal reftex-last-follow-point
(point)))
234 ;; show context in other window
235 (setq reftex-last-follow-point
(point))
237 (reftex-toc-visit-location nil
(not reftex-revisit-to-follow
))
240 (defun reftex-re-enlarge ()
241 ;; Enlarge windiw to a remembered size
243 (max 0 (- (or reftex-last-window-height
(window-height))
246 (defun reftex-toc-show-help ()
247 "Show a summary of special key bindings."
249 (with-output-to-temp-buffer "*RefTeX Help*"
250 (princ reftex-toc-help
))
251 (reftex-enlarge-to-fit "*RefTeX Help*" t
)
252 ;; If follow mode is active, arrange to delay it one command
253 (if reftex-toc-follow-mode
254 (setq reftex-toc-follow-mode
1)))
256 (defun reftex-toc-next (&optional arg
)
257 "Move to next selectable item."
259 (setq reftex-callback-fwd t
)
260 (or (eobp) (forward-char 1))
261 (goto-char (or (next-single-property-change (point) :data
)
263 (defun reftex-toc-previous (&optional arg
)
264 "Move to previous selectable item."
266 (setq reftex-callback-fwd nil
)
267 (goto-char (or (previous-single-property-change (point) :data
)
269 (defun reftex-toc-next-heading (&optional arg
)
270 "Move to next table of contentes line."
273 (re-search-forward "^ " nil t arg
)
275 (defun reftex-toc-previous-heading (&optional arg
)
276 "Move to previous table of contentes line."
278 (re-search-backward "^ " nil t arg
))
279 (defun reftex-toc-toggle-follow ()
280 "Toggle follow (other window follows with context)."
282 (setq reftex-last-follow-point -
1)
283 (setq reftex-toc-follow-mode
(not reftex-toc-follow-mode
)))
284 (defun reftex-toc-toggle-file-boundary ()
285 "Toggle inclusion of file boundaries in *toc* buffer."
287 (setq reftex-toc-include-file-boundaries
288 (not reftex-toc-include-file-boundaries
))
290 (defun reftex-toc-toggle-labels (arg)
291 "Toggle inclusion of labels in *toc* buffer.
292 With prefix ARG, prompt for a label type and include only labels of
295 (setq reftex-toc-include-labels
296 (if arg
(reftex-query-label-type)
297 (not reftex-toc-include-labels
)))
299 (defun reftex-toc-toggle-index (arg)
300 "Toggle inclusion of index in *toc* buffer.
301 With prefix arg, prompt for an index tag and include only entries of that
304 (setq reftex-toc-include-index-entries
305 (if arg
(reftex-index-select-tag)
306 (not reftex-toc-include-index-entries
)))
308 (defun reftex-toc-toggle-context ()
309 "Toggle inclusion of label context in *toc* buffer.
310 Label context is only displayed when the labels are there as well."
312 (setq reftex-toc-include-context
(not reftex-toc-include-context
))
314 (defun reftex-toc-max-level (arg)
315 "Set the maximum level of toc lines in this buffer to value of prefix ARG.
316 When no prefix is given, set the max level to a large number, so that all
317 levels are shown. For eaxample, to set the level to 3, type `3 m'."
319 (setq reftex-toc-max-level
(if arg
320 (prefix-numeric-value arg
)
322 (setq reftex-toc-max-level-indicator
323 (if arg
(int-to-string reftex-toc-max-level
) "ALL"))
325 (defun reftex-toc-view-line ()
326 "View document location in other window."
328 (reftex-toc-visit-location))
329 (defun reftex-toc-goto-line-and-hide ()
330 "Go to document location in other window. Hide the *toc* window."
332 (reftex-toc-visit-location 'hide
))
333 (defun reftex-toc-goto-line ()
334 "Go to document location in other window. *toc* window stays."
336 (reftex-toc-visit-location t
))
337 (defun reftex-toc-mouse-goto-line-and-hide (ev)
338 "Go to document location in other window. Hide the *toc* window."
341 (reftex-toc-visit-location 'hide
))
342 (defun reftex-toc-show-calling-point ()
343 "Show point where reftex-toc was called from."
345 (let ((this-window (selected-window)))
348 (switch-to-buffer-other-window
349 (marker-buffer reftex-toc-return-marker
))
350 (goto-char (marker-position reftex-toc-return-marker
))
352 (select-window this-window
))))
353 (defun reftex-toc-quit ()
354 "Hide the *toc* window and do not move point."
356 (or (one-window-p) (delete-window))
357 (switch-to-buffer (marker-buffer reftex-toc-return-marker
))
359 (goto-char (or (marker-position reftex-toc-return-marker
) (point))))
360 (defun reftex-toc-quit-and-kill ()
361 "Kill the *toc* buffer."
363 (kill-buffer "*toc*")
364 (or (one-window-p) (delete-window))
365 (switch-to-buffer (marker-buffer reftex-toc-return-marker
))
367 (goto-char (marker-position reftex-toc-return-marker
)))
368 (defun reftex-toc-display-index (&optional arg
)
369 "Display the index buffer for the current document.
370 This works just like `reftex-display-index' from a LaTeX buffer.
371 With prefix arg 1, restrict index to the section at point."
373 (let ((data (get-text-property (point) :data
))
374 (docstruct (symbol-value reftex-docstruct-symbol
))
377 (setq bor
(reftex-last-assoc-before-elt 'toc data docstruct
)
378 eor
(assoc 'toc
(cdr (memq bor docstruct
)))
379 restr
(list (nth 6 bor
) bor eor
)))
380 (reftex-toc-goto-line)
381 (reftex-display-index (if restr nil arg
) restr
)))
382 (defun reftex-toc-rescan (&rest ignore
)
383 "Regenerate the *toc* buffer by reparsing file of section at point."
385 (if (and reftex-enable-partial-scans
386 (null current-prefix-arg
))
387 (let* ((data (get-text-property (point) :data
))
389 (file (cond ((eq what
'toc
) (nth 3 data
))
390 ((memq what
'(eof bof file-error
)) (nth 1 data
))
391 ((stringp what
) (nth 3 data
))
392 ((eq what
'index
) (nth 3 data
))))
393 (line (+ (count-lines (point-min) (point)) (if (bolp) 1 0))))
395 (error "Don't know which file to rescan. Try `C-u r'")
396 (put 'reftex-toc
:reftex-line line
)
397 (switch-to-buffer-other-window
398 (reftex-get-file-buffer-force file
))
399 (setq current-prefix-arg
'(4))
402 (reftex-kill-temporary-buffers))
403 (defun reftex-toc-Rescan (&rest ignore
)
404 "Regenerate the *toc* buffer by reparsing the entire document."
406 (switch-to-buffer-other-window
407 (reftex-get-file-buffer-force reftex-last-toc-file
))
408 (setq current-prefix-arg
'(16))
410 (defun reftex-toc-revert (&rest ignore
)
411 "Regenerate the *toc* from the internal lists."
413 (switch-to-buffer-other-window
414 (reftex-get-file-buffer-force reftex-last-toc-file
))
415 (reftex-erase-buffer "*toc*")
416 (setq current-prefix-arg nil
)
418 (defun reftex-toc-external (&rest ignore
)
419 "Switch to table of contents of an external document."
421 (let* ((old-buf (current-buffer))
422 (xr-alist (get-text-property 1 'xr-alist
))
423 (xr-index (reftex-select-external-document
425 (switch-to-buffer-other-window (or (reftex-get-file-buffer-force
426 (cdr (nth xr-index xr-alist
)))
427 (error "Cannot switch document")))
429 (if (equal old-buf
(current-buffer))
431 (message "Switched document"))))
433 (defun reftex-toc-jump (arg)
434 "Jump to a specific section. E.g. '3 z' jumps to section 3.
435 Useful for large TOC's."
437 (goto-char (point-min))
439 (concat "^ *" (number-to-string (if (numberp arg
) arg
1)) " ")
443 (defun reftex-toc-visit-location (&optional final no-revisit
)
444 ;; Visit the tex file corresponding to the toc entry on the current line.
445 ;; If FINAL is t, stay there
446 ;; If FINAL is 'hide, hide the *toc* window.
447 ;; Otherwise, move cursor back into *toc* window.
448 ;; NO-REVISIT means don't visit files, just use live biffers.
449 ;; This function is pretty clever about finding back a section heading,
450 ;; even if the buffer is not live, or things like outline, x-symbol etc.
453 (let* ((toc (get-text-property (point) :data
))
454 (toc-window (selected-window))
455 show-window show-buffer match
)
457 (unless toc
(error "Don't know which toc line to visit"))
463 (setq match
(reftex-toc-find-section toc no-revisit
)))
465 ((eq (car toc
) 'index
)
467 (setq match
(reftex-index-show-entry toc no-revisit
)))
469 ((memq (car toc
) '(bof eof
))
472 (let ((where (car toc
))
474 (if (or (not no-revisit
) (reftex-get-buffer-visiting file
))
476 (switch-to-buffer-other-window
477 (reftex-get-file-buffer-force file nil
))
478 (goto-char (if (eq where
'bof
) (point-min) (point-max))))
479 (message reftex-no-follow-message
) nil
))))
483 (setq match
(reftex-show-label-location toc reftex-callback-fwd
486 (setq show-window
(selected-window)
487 show-buffer
(current-buffer))
490 (select-window toc-window
)
491 (error "Cannot find location"))
493 (select-window toc-window
)
495 ;; use the `final' parameter to decide what to do next
498 (reftex-unhighlight 0)
499 (select-window show-window
))
501 (reftex-unhighlight 0)
502 (or (one-window-p) (delete-window))
503 (switch-to-buffer show-buffer
)
507 (defun reftex-toc-find-section (toc &optional no-revisit
)
508 (let* ((file (nth 3 toc
))
511 (literal (nth 7 toc
))
512 (emergency-point (nth 8 toc
))
515 ((and (markerp marker
) (marker-buffer marker
))
516 ;; Buffer is still live and we have the marker. Should be easy.
517 (switch-to-buffer-other-window (marker-buffer marker
))
518 (goto-char (marker-position marker
))
519 (or (looking-at (regexp-quote literal
))
520 (looking-at (reftex-make-regexp-allow-for-ctrl-m literal
))
521 (looking-at (reftex-make-desperate-section-regexp literal
))
522 (looking-at (concat "\\\\"
526 reftex-section-levels-all
)))
528 ((or (not no-revisit
)
529 (reftex-get-buffer-visiting file
))
530 ;; Marker is lost. Use the backup method.
531 (switch-to-buffer-other-window
532 (reftex-get-file-buffer-force file nil
))
533 (goto-char (or emergency-point
(point-min)))
534 (or (looking-at (regexp-quote literal
))
535 (let ((len (length literal
)))
536 (or (reftex-nearest-match (regexp-quote literal
) len
)
537 (reftex-nearest-match
538 (reftex-make-regexp-allow-for-ctrl-m literal
) len
)
539 (reftex-nearest-match
540 (reftex-make-desperate-section-regexp literal
) len
)))))
541 (t (message reftex-no-follow-message
) nil
))))
543 (goto-char (match-beginning 0))
544 (if (not (= (point) (point-max))) (recenter 1))
545 (reftex-highlight 0 (match-beginning 0) (match-end 0) (current-buffer)))
548 (defun reftex-make-desperate-section-regexp (old)
549 ;; Return a regexp which will still match a section statement even if
550 ;; x-symbol or isotex or the like have been at work in the mean time.
551 (let* ((n (1+ (string-match "[[{]" old
)))
552 (new (regexp-quote (substring old
0 (1+ (string-match "[[{]" old
)))))
553 (old (substring old n
)))
555 "\\([\r\n]\\)\\|\\(\\`\\|[ \t\n\r]\\)\\([a-zA-Z0-9]+\\)\\([ \t\n\r]\\|}\\'\\)"
557 (if (match-beginning 1)
558 (setq new
(concat new
"[^\n\r]*[\n\r]"))
559 (setq new
(concat new
"[^\n\r]*" (match-string 3 old
))))
560 (setq old
(substring old
(match-end 0))))
563 ;; Table of Contents map
564 (define-key reftex-toc-map
(if (featurep 'xemacs
) [(button2)] [(mouse-2)])
565 'reftex-toc-mouse-goto-line-and-hide
)
567 (substitute-key-definition
568 'next-line
'reftex-toc-next reftex-toc-map global-map
)
569 (substitute-key-definition
570 'previous-line
'reftex-toc-previous reftex-toc-map global-map
)
573 '(("n" . reftex-toc-next
)
574 ("p" . reftex-toc-previous
)
575 ("?" . reftex-toc-show-help
)
576 (" " . reftex-toc-view-line
)
577 ("\C-m" . reftex-toc-goto-line-and-hide
)
578 ("\C-i" . reftex-toc-goto-line
)
579 ("\C-c>". reftex-toc-display-index
)
580 ("r" . reftex-toc-rescan
)
581 ("R" . reftex-toc-Rescan
)
582 ("g" . revert-buffer
)
583 ("q" . reftex-toc-quit
)
584 ("k" . reftex-toc-quit-and-kill
)
585 ("f" . reftex-toc-toggle-follow
)
586 ("F" . reftex-toc-toggle-file-boundary
)
587 ("i" . reftex-toc-toggle-index
)
588 ("l" . reftex-toc-toggle-labels
)
589 ("t" . reftex-toc-max-level
)
590 ("c" . reftex-toc-toggle-context
)
591 ("%" . reftex-toc-toggle-commented
)
592 ("x" . reftex-toc-external
)
593 ("z" . reftex-toc-jump
)
594 ("." . reftex-toc-show-calling-point
)
595 ("\C-c\C-n" . reftex-toc-next-heading
)
596 ("\C-c\C-p" . reftex-toc-previous-heading
))
597 do
(define-key reftex-toc-map
(car x
) (cdr x
)))
599 (loop for key across
"0123456789" do
600 (define-key reftex-toc-map
(vector (list key
)) 'digit-argument
))
601 (define-key reftex-toc-map
"-" 'negative-argument
)
604 reftex-toc-menu reftex-toc-map
605 "Menu for Table of Contents buffer"
607 ["Show Location" reftex-toc-view-line t
]
608 ["Go To Location" reftex-toc-goto-line t
]
609 ["Exit & Go To Location" reftex-toc-goto-line-and-hide t
]
610 ["Index" reftex-toc-display-index t
]
611 ["Quit" reftex-toc-quit t
]
613 ["External Document TOC " reftex-toc-external t
]
616 ["Rebuilt *toc* Buffer" revert-buffer t
]
617 ["Rescan One File" reftex-toc-rescan reftex-enable-partial-scans
]
618 ["Rescan Entire Document" reftex-toc-Rescan t
])
621 ["File Boundaries" reftex-toc-toggle-file-boundary
:style toggle
622 :selected reftex-toc-include-file-boundaries
]
623 ["Labels" reftex-toc-toggle-labels
:style toggle
624 :selected reftex-toc-include-labels
]
625 ["Index Entries" reftex-toc-toggle-index
:style toggle
626 :selected reftex-toc-include-index-entries
]
627 ["Context" reftex-toc-toggle-context
:style toggle
628 :selected reftex-toc-include-context
]
630 ["Follow Mode" reftex-toc-toggle-follow
:style toggle
631 :selected reftex-toc-follow-mode
])
633 ["Help" reftex-toc-show-help t
]))
636 ;;; reftex-toc.el ends here