annotate lisp/progmodes/etags.el @ 42307:922f0ef2951b

(balance-windows): Use new PRESERVE-BEFORE arg to enlarge-window. Use save-selected-window. Don't try to resize windows that end at the bottom "level". Retry changing the sizes until the windows get the desired sizes. Discount the minibuffer when computing total height available.
author Richard M. Stallman <rms@gnu.org>
date Tue, 25 Dec 2001 10:34:39 +0000
parents 647a7868ae38
children 36dc6c5f8b28
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2229
bd3c525fa6fc Added standard library headers.
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 1976
diff changeset
1 ;;; etags.el --- etags facility for Emacs
40255
ad4ee591fe2f Adapt to change in perform-replace.
Gerd Moellmann <gerd@gnu.org>
parents: 37963
diff changeset
2
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
3 ;; Copyright (C) 1985, 86, 88, 89, 92, 93, 94, 95, 96, 98, 2000, 2001
1806
da47cfb7624e (visit-tags-table-buffer): Error if called with 'same and no current table.
Roland McGrath <roland@gnu.org>
parents: 1724
diff changeset
4 ;; Free Software Foundation, Inc.
846
20674ae6bf52 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 824
diff changeset
5
25278
cbe304a26771 Fix maintainer address.
Karl Heuer <kwzh@gnu.org>
parents: 23561
diff changeset
6 ;; Author: Roland McGrath <roland@gnu.org>
32324
581b490bcb94 Maintainer line updated.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32311
diff changeset
7 ;; Maintainer: FSF
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
8 ;; Keywords: tools
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
9
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
10 ;; This file is part of GNU Emacs.
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
11
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
13 ;; it under the terms of the GNU General Public License as published by
727
540b047ece4d *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 662
diff changeset
14 ;; the Free Software Foundation; either version 2, or (at your option)
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
15 ;; any later version.
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
16
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
17 ;; GNU Emacs is distributed in the hope that it will be useful,
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
18 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
19 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
20 ;; GNU General Public License for more details.
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
21
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
22 ;; You should have received a copy of the GNU General Public License
14169
83f275dcd93a Update FSF's address.
Erik Naggum <erik@naggum.no>
parents: 13731
diff changeset
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
83f275dcd93a Update FSF's address.
Erik Naggum <erik@naggum.no>
parents: 13731
diff changeset
24 ;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
83f275dcd93a Update FSF's address.
Erik Naggum <erik@naggum.no>
parents: 13731
diff changeset
25 ;; Boston, MA 02111-1307, USA.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
26
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
27 ;;; Commentary:
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
28
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
29 ;;; Code:
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
30
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
31 (require 'ring)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
32
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
33 ;;;###autoload
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
34 (defvar tags-file-name nil
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
35 "*File name of tags table.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
36 To switch to a new tags table, setting this variable is sufficient.
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
37 If you set this variable, do not also set `tags-table-list'.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
38 Use the `etags' program to make a tags table file.")
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
39 ;; Make M-x set-variable tags-file-name like M-x visit-tags-table.
824
b7ba8d69e136 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 817
diff changeset
40 ;;;###autoload (put 'tags-file-name 'variable-interactive "fVisit tags table: ")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
41
20836
18b33fb503f3 (etags): Fix defgroup syntax. Why should it
Kenichi Handa <handa@m17n.org>
parents: 20799
diff changeset
42 (defgroup etags nil "Tags tables"
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
43 :group 'tools)
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
44
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
45 ;;;###autoload
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
46 (defcustom tags-case-fold-search 'default
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
47 "*Whether tags operations should be case-sensitive.
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
48 A value of t means case-insensitive, a value of nil means case-sensitive.
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
49 Any other value means use the setting of `case-fold-search'."
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
50 :group 'etags
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
51 :type '(choice (const :tag "Case-sensitive" nil)
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
52 (const :tag "Case-insensitive" t)
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
53 (other :tag "Use default" default))
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
54 :version "21.1")
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
55
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
56 ;;;###autoload
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
57 ;; Use `visit-tags-table-buffer' to cycle through tags tables in this list.
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
58 (defcustom tags-table-list nil
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
59 "*List of file names of tags tables to search.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
60 An element that is a directory means the file \"TAGS\" in that directory.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
61 To switch to a new list of tags tables, setting this variable is sufficient.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
62 If you set this variable, do not also set `tags-file-name'.
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
63 Use the `etags' program to make a tags table file."
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
64 :group 'etags
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
65 :type '(repeat file))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
66
6140
35fc497c9f4e (tags-add-tables): Change default value to 'ask-user; update doc.
Roland McGrath <roland@gnu.org>
parents: 5892
diff changeset
67 ;;;###autoload
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
68 (defcustom tags-compression-info-list '("" ".Z" ".bz2" ".gz" ".tgz")
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
69 "*List of extensions tried by etags when jka-compr is used.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
70 An empty string means search the non-compressed file.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
71 These extensions will be tried only if jka-compr was activated
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
72 \(i.e. via customize of `auto-compression-mode' or by calling the function
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
73 `auto-compression-mode')."
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
74 :type '(repeat string)
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
75 :group 'etags)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
76
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
77 ;; !!! tags-compression-info-list should probably be replaced by access
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
78 ;; to directory list and matching jka-compr-compression-info-list. Currently,
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
79 ;; this implementation forces each modification of
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
80 ;; jka-compr-compression-info-list to be reflected in this var.
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
81 ;; An alternative could be to say that introducing a special
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
82 ;; element in this list (e.g. t) means : try at this point
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
83 ;; using directory listing and regexp matching using
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
84 ;; jka-compr-compression-info-list.
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
85
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
86
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
87 ;;;###autoload
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
88 (defcustom tags-add-tables 'ask-user
7112
91ba2f787c8f (tags-add-tables): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 6245
diff changeset
89 "*Control whether to add a new tags table to the current list.
91ba2f787c8f (tags-add-tables): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 6245
diff changeset
90 t means do; nil means don't (always start a new list).
91ba2f787c8f (tags-add-tables): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 6245
diff changeset
91 Any other value means ask the user whether to add a new tags table
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
92 to the current list (as opposed to starting a new list)."
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
93 :group 'etags
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
94 :type '(choice (const :tag "Do" t)
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
95 (const :tag "Don't" nil)
22594
d5904b1c89af (tags-add-tables): Use `other' widget type.
Andreas Schwab <schwab@suse.de>
parents: 21669
diff changeset
96 (other :tag "Ask" ask-user)))
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
97
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
98 (defcustom tags-revert-without-query nil
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
99 "*Non-nil means reread a TAGS table without querying, if it has changed."
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
100 :group 'etags
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
101 :type 'boolean)
5174
bb40928e9e47 (tags-add-tables): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 5079
diff changeset
102
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
103 (defvar tags-table-computed-list nil
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
104 "List of tags tables to search, computed from `tags-table-list'.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
105 This includes tables implicitly included by other tables. The list is not
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
106 always complete: the included tables of a table are not known until that
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
107 table is read into core. An element that is t is a placeholder
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
108 indicating that the preceding element is a table that has not been read
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
109 into core and might contain included tables to search.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
110 See `tags-table-check-computed-list'.")
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
111
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
112 (defvar tags-table-computed-list-for nil
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
113 "Value of `tags-table-list' that `tags-table-computed-list' corresponds to.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
114 If `tags-table-list' changes, `tags-table-computed-list' is thrown away and
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
115 recomputed; see `tags-table-check-computed-list'.")
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
116
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
117 (defvar tags-table-list-pointer nil
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
118 "Pointer into `tags-table-computed-list' for the current state of searching.
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
119 Use `visit-tags-table-buffer' to cycle through tags tables in this list.")
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
120
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
121 (defvar tags-table-list-started-at nil
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
122 "Pointer into `tags-table-computed-list', where the current search started.")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
123
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
124 (defvar tags-table-set-list nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
125 "List of sets of tags table which have been used together in the past.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
126 Each element is a list of strings which are file names.")
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
127
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
128 ;;;###autoload
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
129 (defcustom find-tag-hook nil
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
130 "*Hook to be run by \\[find-tag] after finding a tag. See `run-hooks'.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
131 The value in the buffer in which \\[find-tag] is done is used,
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
132 not the value in the buffer \\[find-tag] goes to."
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
133 :group 'etags
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
134 :type 'hook)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
135
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
136 ;;;###autoload
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
137 (defcustom find-tag-default-function nil
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
138 "*A function of no arguments used by \\[find-tag] to pick a default tag.
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
139 If nil, and the symbol that is the value of `major-mode'
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
140 has a `find-tag-default-function' property (see `put'), that is used.
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
141 Otherwise, `find-tag-default' is used."
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
142 :group 'etags
35961
850d490d87f3 (find-tag-default-function): Fix :type.
Dave Love <fx@gnu.org>
parents: 35649
diff changeset
143 :type '(choice (const nil) function))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
144
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
145 (defcustom find-tag-marker-ring-length 16
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
146 "*Length of marker rings `find-tag-marker-ring' and `tags-location-ring'."
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
147 :group 'etags
21669
9861518505cb *** empty log message ***
Dan Nicolaescu <done@ece.arizona.edu>
parents: 21097
diff changeset
148 :type 'integer
9861518505cb *** empty log message ***
Dan Nicolaescu <done@ece.arizona.edu>
parents: 21097
diff changeset
149 :version "20.3")
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
150
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
151 (defcustom tags-tag-face 'default
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
152 "*Face for tags in the output of `tags-apropos'."
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
153 :group 'etags
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
154 :type 'face
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
155 :version "21.1")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
156
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
157 (defcustom tags-apropos-verbose nil
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
158 "If non-nil, print the name of the tags file in the *Tags List* buffer."
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
159 :group 'etags
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
160 :type 'boolean
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
161 :version "21.1")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
162
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
163 (defcustom tags-apropos-additional-actions nil
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
164 "Specify additional actions for `tags-apropos'.
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
165
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
166 If non-nil, value should be a list of triples (TITLE FUNCTION
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
167 TO-SEARCH). For each triple, `tags-apropos' processes TO-SEARCH and
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
168 lists tags from it. TO-SEARCH should be an alist, obarray, or symbol.
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
169 If it is a symbol, the symbol's value is used.
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
170 TITLE, a string, is a title used to label the additional list of tags.
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
171 FUNCTION is a function to call when a symbol is selected in the
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
172 *Tags List* buffer. It will be called with one argument SYMBOL which
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
173 is the symbol being selected.
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
174
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
175 Example value:
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
176
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
177 '((\"Emacs Lisp\" Info-goto-emacs-command-node obarray)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
178 (\"Common Lisp\" common-lisp-hyperspec common-lisp-hyperspec-obarray)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
179 (\"SCWM\" scwm-documentation scwm-obarray))"
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
180 :group 'etags
35181
62f469e476eb (tags-apropos-additional-actions): Fix :type.
Dave Love <fx@gnu.org>
parents: 34190
diff changeset
181 :type '(repeat (list (string :tag "Title")
62f469e476eb (tags-apropos-additional-actions): Fix :type.
Dave Love <fx@gnu.org>
parents: 34190
diff changeset
182 function
62f469e476eb (tags-apropos-additional-actions): Fix :type.
Dave Love <fx@gnu.org>
parents: 34190
diff changeset
183 (sexp :tag "Tags to search")))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
184 :version "21.1")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
185
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
186 (defvar find-tag-marker-ring (make-ring find-tag-marker-ring-length)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
187 "Ring of markers which are locations from which \\[find-tag] was invoked.")
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
188
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
189 (defvar default-tags-table-function nil
5174
bb40928e9e47 (tags-add-tables): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 5079
diff changeset
190 "If non-nil, a function to choose a default tags file for a buffer.
bb40928e9e47 (tags-add-tables): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 5079
diff changeset
191 This function receives no arguments and should return the default
bb40928e9e47 (tags-add-tables): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 5079
diff changeset
192 tags table file to use for the current buffer.")
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
193
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
194 (defvar tags-location-ring (make-ring find-tag-marker-ring-length)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
195 "Ring of markers which are locations visited by \\[find-tag].
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
196 Pop back to the last location with \\[negative-argument] \\[find-tag].")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
197
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
198 ;; Tags table state.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
199 ;; These variables are local in tags table buffers.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
200
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
201 (defvar tags-table-files nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
202 "List of file names covered by current tags table.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
203 nil means it has not yet been computed; use `tags-table-files' to do so.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
204
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
205 (defvar tags-completion-table nil
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
206 "Obarray of tag names defined in current tags table.")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
207
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
208 (defvar tags-included-tables nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
209 "List of tags tables included by the current tags table.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
210
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
211 (defvar next-file-list nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
212 "List of files for \\[next-file] to process.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
213
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
214 ;; Hooks for file formats.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
215
32324
581b490bcb94 Maintainer line updated.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32311
diff changeset
216 (defvar tags-table-format-functions '(etags-recognize-tags-table
581b490bcb94 Maintainer line updated.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32311
diff changeset
217 tags-recognize-empty-tags-table)
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
218 "Hook to be called in a tags table buffer to identify the type of tags table.
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
219 The functions are called in order, with no arguments,
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
220 until one returns non-nil. The function should make buffer-local bindings
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
221 of the format-parsing tags function variables if successful.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
222
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
223 (defvar file-of-tag-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
224 "Function to do the work of `file-of-tag' (which see).")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
225 (defvar tags-table-files-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
226 "Function to do the work of `tags-table-files' (which see).")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
227 (defvar tags-completion-table-function nil
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
228 "Function to build the `tags-completion-table'.")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
229 (defvar snarf-tag-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
230 "Function to get info about a matched tag for `goto-tag-location-function'.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
231 (defvar goto-tag-location-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
232 "Function of to go to the location in the buffer specified by a tag.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
233 One argument, the tag info returned by `snarf-tag-function'.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
234 (defvar find-tag-regexp-search-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
235 "Search function passed to `find-tag-in-order' for finding a regexp tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
236 (defvar find-tag-regexp-tag-order nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
237 "Tag order passed to `find-tag-in-order' for finding a regexp tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
238 (defvar find-tag-regexp-next-line-after-failure-p nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
239 "Flag passed to `find-tag-in-order' for finding a regexp tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
240 (defvar find-tag-search-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
241 "Search function passed to `find-tag-in-order' for finding a tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
242 (defvar find-tag-tag-order nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
243 "Tag order passed to `find-tag-in-order' for finding a tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
244 (defvar find-tag-next-line-after-failure-p nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
245 "Flag passed to `find-tag-in-order' for finding a tag.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
246 (defvar list-tags-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
247 "Function to do the work of `list-tags' (which see).")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
248 (defvar tags-apropos-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
249 "Function to do the work of `tags-apropos' (which see).")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
250 (defvar tags-included-tables-function nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
251 "Function to do the work of `tags-included-tables' (which see).")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
252 (defvar verify-tags-table-function nil
19358
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
253 "Function to return t iff current buffer contains valid tags file.")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
254
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
255 ;; Initialize the tags table in the current buffer.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
256 ;; Returns non-nil iff it is a valid tags table. On
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
257 ;; non-nil return, the tags table state variable are
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
258 ;; made buffer-local and initialized to nil.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
259 (defun initialize-new-tags-table ()
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
260 (set (make-local-variable 'tags-table-files) nil)
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
261 (set (make-local-variable 'tags-completion-table) nil)
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
262 (set (make-local-variable 'tags-included-tables) nil)
23561
70fafedc3c4c (initialize-new-tags-table):
Richard M. Stallman <rms@gnu.org>
parents: 23415
diff changeset
263 ;; We used to initialize find-tag-marker-ring and tags-location-ring
70fafedc3c4c (initialize-new-tags-table):
Richard M. Stallman <rms@gnu.org>
parents: 23415
diff changeset
264 ;; here, to new empty rings. But that is wrong, because those
70fafedc3c4c (initialize-new-tags-table):
Richard M. Stallman <rms@gnu.org>
parents: 23415
diff changeset
265 ;; are global.
70fafedc3c4c (initialize-new-tags-table):
Richard M. Stallman <rms@gnu.org>
parents: 23415
diff changeset
266
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
267 ;; Value is t if we have found a valid tags table buffer.
32324
581b490bcb94 Maintainer line updated.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 32311
diff changeset
268 (run-hook-with-args-until-success 'tags-table-format-functions))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
269
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
270 ;;;###autoload
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
271 (defun visit-tags-table (file &optional local)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
272 "Tell tags commands to use tags table file FILE.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
273 FILE should be the name of a file created with the `etags' program.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
274 A directory name is ok too; it means file TAGS in that directory.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
275
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
276 Normally \\[visit-tags-table] sets the global value of `tags-file-name'.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
277 With a prefix arg, set the buffer-local value instead.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
278 When you find a tag with \\[find-tag], the buffer it finds the tag
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
279 in is given a local value of this variable which is the name of the tags
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
280 file the tag was in."
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
281 (interactive (list (read-file-name "Visit tags table: (default TAGS) "
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
282 default-directory
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
283 (expand-file-name "TAGS"
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
284 default-directory)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
285 t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
286 current-prefix-arg))
7287
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
287 (or (stringp file) (signal 'wrong-type-argument (list 'stringp file)))
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
288 ;; Bind tags-file-name so we can control below whether the local or
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
289 ;; global value gets set. Calling visit-tags-table-buffer will
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
290 ;; initialize a buffer for the file and set tags-file-name to the
10661
32beb7b6dbf7 Changes to support filenames as tags too and provided
Richard M. Stallman <rms@gnu.org>
parents: 10458
diff changeset
291 ;; Calling visit-tags-table-buffer with tags-file-name set to FILE will
32beb7b6dbf7 Changes to support filenames as tags too and provided
Richard M. Stallman <rms@gnu.org>
parents: 10458
diff changeset
292 ;; initialize a buffer for FILE and set tags-file-name to the
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
293 ;; fully-expanded name.
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
294 (let ((tags-file-name file))
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
295 (save-excursion
7287
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
296 (or (visit-tags-table-buffer file)
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
297 (signal 'file-error (list "Visiting tags table"
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
298 "file does not exist"
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
299 file)))
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
300 ;; Set FILE to the expanded name.
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
301 (setq file tags-file-name)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
302 (if local
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
303 ;; Set the local value of tags-file-name.
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
304 (set (make-local-variable 'tags-file-name) file)
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
305 ;; Set the global value of tags-file-name.
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
306 (setq-default tags-file-name file)))
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
307
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
308 (defun tags-table-check-computed-list ()
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
309 "Compute `tags-table-computed-list' from `tags-table-list' if necessary."
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
310 (let ((expanded-list (mapcar 'tags-expand-table-name tags-table-list)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
311 (or (equal tags-table-computed-list-for expanded-list)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
312 ;; The list (or default-directory) has changed since last computed.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
313 (let* ((compute-for (mapcar 'copy-sequence expanded-list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
314 (tables (copy-sequence compute-for)) ;Mutated in the loop.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
315 (computed nil)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
316 table-buffer)
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
317
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
318 (while tables
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
319 (setq computed (cons (car tables) computed)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
320 table-buffer (get-file-buffer (car tables)))
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
321 (if (and table-buffer
9020
857ced7767c0 (tags-table-check-computed-list): Call tags-verify-table on existing
Roland McGrath <roland@gnu.org>
parents: 8973
diff changeset
322 ;; There is a buffer visiting the file. Now make sure
857ced7767c0 (tags-table-check-computed-list): Call tags-verify-table on existing
Roland McGrath <roland@gnu.org>
parents: 8973
diff changeset
323 ;; it is initialized as a tag table buffer.
857ced7767c0 (tags-table-check-computed-list): Call tags-verify-table on existing
Roland McGrath <roland@gnu.org>
parents: 8973
diff changeset
324 (save-excursion
857ced7767c0 (tags-table-check-computed-list): Call tags-verify-table on existing
Roland McGrath <roland@gnu.org>
parents: 8973
diff changeset
325 (tags-verify-table (buffer-file-name table-buffer))))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
326 (save-excursion
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
327 (set-buffer table-buffer)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
328 (if (tags-included-tables)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
329 ;; Insert the included tables into the list we
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
330 ;; are processing.
13165
e5431229a09f (tags-table-check-computed-list): Map tags-expand-table-name over lists of
Roland McGrath <roland@gnu.org>
parents: 12942
diff changeset
331 (setcdr tables (nconc (mapcar 'tags-expand-table-name
e5431229a09f (tags-table-check-computed-list): Map tags-expand-table-name over lists of
Roland McGrath <roland@gnu.org>
parents: 12942
diff changeset
332 (tags-included-tables))
e5431229a09f (tags-table-check-computed-list): Map tags-expand-table-name over lists of
Roland McGrath <roland@gnu.org>
parents: 12942
diff changeset
333 (cdr tables)))))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
334 ;; This table is not in core yet. Insert a placeholder
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
335 ;; saying we must read it into core to check for included
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
336 ;; tables before searching the next table in the list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
337 (setq computed (cons t computed)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
338 (setq tables (cdr tables)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
339
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
340 ;; Record the tags-table-list value (and the context of the
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
341 ;; current directory) we computed from.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
342 (setq tags-table-computed-list-for compute-for
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
343 tags-table-computed-list (nreverse computed))))))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
344
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
345 ;; Extend `tags-table-computed-list' to remove the first `t' placeholder.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
346 ;; An element of the list that is `t' is a placeholder indicating that the
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
347 ;; preceding element is a table that has not been read into core and might
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
348 ;; contain included tables to search. On return, the first placeholder
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
349 ;; element will be gone and the element before it read into core and its
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
350 ;; included tables inserted into the list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
351 (defun tags-table-extend-computed-list ()
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
352 (let ((list tags-table-computed-list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
353 (while (not (eq (nth 1 list) t))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
354 (setq list (cdr list)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
355 (save-excursion
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
356 (if (tags-verify-table (car list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
357 ;; We are now in the buffer visiting (car LIST). Extract its
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
358 ;; list of included tables and insert it into the computed list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
359 (let ((tables (tags-included-tables))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
360 (computed nil)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
361 table-buffer)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
362 (while tables
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
363 (setq computed (cons (car tables) computed)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
364 table-buffer (get-file-buffer (car tables)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
365 (if table-buffer
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
366 (save-excursion
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
367 (set-buffer table-buffer)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
368 (if (tags-included-tables)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
369 ;; Insert the included tables into the list we
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
370 ;; are processing.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
371 (setcdr tables (append (tags-included-tables)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
372 tables))))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
373 ;; This table is not in core yet. Insert a placeholder
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
374 ;; saying we must read it into core to check for included
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
375 ;; tables before searching the next table in the list.
8623
428abda49671 (tags-table-extend-computed-list): In loop processing list of included
Roland McGrath <roland@gnu.org>
parents: 8509
diff changeset
376 (setq computed (cons t computed)))
428abda49671 (tags-table-extend-computed-list): In loop processing list of included
Roland McGrath <roland@gnu.org>
parents: 8509
diff changeset
377 (setq tables (cdr tables)))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
378 (setq computed (nreverse computed))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
379 ;; COMPUTED now contains the list of included tables (and
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
380 ;; tables included by them, etc.). Now splice this into the
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
381 ;; current list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
382 (setcdr list (nconc computed (cdr (cdr list)))))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
383 ;; It was not a valid table, so just remove the following placeholder.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
384 (setcdr list (cdr (cdr list)))))))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
385
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
386 ;; Expand tags table name FILE into a complete file name.
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
387 (defun tags-expand-table-name (file)
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
388 (setq file (expand-file-name file))
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
389 (if (file-directory-p file)
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
390 (expand-file-name "TAGS" file)
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
391 file))
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
392
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
393 ;; Like member, but comparison is done after tags-expand-table-name on both
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
394 ;; sides and elements of LIST that are t are skipped.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
395 (defun tags-table-list-member (file list)
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
396 (setq file (tags-expand-table-name file))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
397 (while (and list
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
398 (or (eq (car list) t)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
399 (not (string= file (tags-expand-table-name (car list))))))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
400 (setq list (cdr list)))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
401 list)
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
402
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
403 (defun tags-verify-table (file)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
404 "Read FILE into a buffer and verify that it is a valid tags table.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
405 Sets the current buffer to one visiting FILE (if it exists).
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
406 Returns non-nil iff it is a valid table."
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
407 (if (get-file-buffer file)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
408 ;; The file is already in a buffer. Check for the visited file
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
409 ;; having changed since we last used it.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
410 (let (win)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
411 (set-buffer (get-file-buffer file))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
412 (setq win (or verify-tags-table-function (initialize-new-tags-table)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
413 (if (or (verify-visited-file-modtime (current-buffer))
19358
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
414 ;; Decide whether to revert the file.
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
415 ;; revert-without-query can say to revert
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
416 ;; or the user can say to revert.
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
417 (not (or (let ((tail revert-without-query)
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
418 (found nil))
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
419 (while tail
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
420 (if (string-match (car tail) buffer-file-name)
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
421 (setq found t))
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
422 (setq tail (cdr tail)))
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
423 found)
20515
2edce6cd0ef0 Customized.
Richard M. Stallman <rms@gnu.org>
parents: 19735
diff changeset
424 tags-revert-without-query
19358
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
425 (yes-or-no-p
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
426 (format "Tags file %s has changed, read new contents? "
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
427 file)))))
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
428 (and verify-tags-table-function
33f430abc9ed (tags-verify-table): Obey revert-without-query.
Richard M. Stallman <rms@gnu.org>
parents: 18623
diff changeset
429 (funcall verify-tags-table-function))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
430 (revert-buffer t t)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
431 (initialize-new-tags-table)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
432 (and (file-exists-p file)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
433 (progn
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
434 (set-buffer (find-file-noselect file))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
435 (or (string= file buffer-file-name)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
436 ;; find-file-noselect has changed the file name.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
437 ;; Propagate the change to tags-file-name and tags-table-list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
438 (let ((tail (member file tags-table-list)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
439 (if tail
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
440 (setcar tail buffer-file-name))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
441 (if (eq file tags-file-name)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
442 (setq tags-file-name buffer-file-name))))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
443 (initialize-new-tags-table)))))
4391
2f181ad12c41 (visit-tags-table-buffer): New local named
Richard M. Stallman <rms@gnu.org>
parents: 4389
diff changeset
444
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
445 ;; Subroutine of visit-tags-table-buffer. Search the current tags tables
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
446 ;; for one that has tags for THIS-FILE (or that includes a table that
8040
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
447 ;; does). Return the name of the first table table listing THIS-FILE; if
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
448 ;; the table is one included by another table, it is the master table that
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
449 ;; we return. If CORE-ONLY is non-nil, check only tags tables that are
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
450 ;; already in buffers--don't visit any new files.
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
451 (defun tags-table-including (this-file core-only)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
452 (let ((tables tags-table-computed-list)
7211
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
453 (found nil))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
454 ;; Loop over the list, looking for a table containing tags for THIS-FILE.
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
455 (while (and (not found)
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
456 tables)
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
457
8509
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
458 (if core-only
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
459 ;; Skip tables not in core.
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
460 (while (eq (nth 1 tables) t)
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
461 (setq tables (cdr (cdr tables))))
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
462 (if (eq (nth 1 tables) t)
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
463 ;; This table has not been read into core yet. Read it in now.
be778f8834a5 (tags-table-including): Inside loop: if CORE-ONLY skip all consecutive
Roland McGrath <roland@gnu.org>
parents: 8456
diff changeset
464 (tags-table-extend-computed-list)))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
465
8014
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
466 (if tables
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
467 ;; Select the tags table buffer and get the file list up to date.
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
468 (let ((tags-file-name (car tables)))
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
469 (visit-tags-table-buffer 'same)
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
470 (if (member this-file (mapcar 'expand-file-name
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
471 (tags-table-files)))
8014
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
472 ;; Found it.
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
473 (setq found tables))))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
474 (setq tables (cdr tables)))
8014
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
475 (if found
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
476 ;; Now determine if the table we found was one included by another
9928
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
477 ;; table, not explicitly listed. We do this by checking each
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
478 ;; element of the computed list to see if it appears in the user's
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
479 ;; explicit list; the last element we will check is FOUND itself.
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
480 ;; Then we return the last one which did in fact appear in
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
481 ;; tags-table-list.
8014
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
482 (let ((could-be nil)
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
483 (elt tags-table-computed-list))
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
484 (while (not (eq elt (cdr found)))
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
485 (if (tags-table-list-member (car elt) tags-table-list)
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
486 ;; This table appears in the user's list, so it could be
0d4288705550 (tags-table-including): Don't call tags-table-check-computed-list.
Roland McGrath <roland@gnu.org>
parents: 7934
diff changeset
487 ;; the one which includes the table we found.
9928
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
488 (setq could-be (car elt)))
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
489 (setq elt (cdr elt))
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
490 (if (eq t (car elt))
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
491 (setq elt (cdr elt))))
8015
3d6ee294a710 Fix bits of last change lost in Emacs crash.
Roland McGrath <roland@gnu.org>
parents: 8014
diff changeset
492 ;; The last element we found in the computed list before FOUND
3d6ee294a710 Fix bits of last change lost in Emacs crash.
Roland McGrath <roland@gnu.org>
parents: 8014
diff changeset
493 ;; that appears in the user's list will be the table that
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
494 ;; included the one we found.
9928
d49a23c098df (tags-table-including): Don't gratuitously cons (what was I thinking?).
Roland McGrath <roland@gnu.org>
parents: 9631
diff changeset
495 could-be))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
496
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
497 ;; Subroutine of visit-tags-table-buffer. Move tags-table-list-pointer
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
498 ;; along and set tags-file-name. Returns nil when out of tables.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
499 (defun tags-next-table ()
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
500 ;; If there is a placeholder element next, compute the list to replace it.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
501 (while (eq (nth 1 tags-table-list-pointer) t)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
502 (tags-table-extend-computed-list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
503
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
504 ;; Go to the next table in the list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
505 (setq tags-table-list-pointer (cdr tags-table-list-pointer))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
506 (or tags-table-list-pointer
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
507 ;; Wrap around.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
508 (setq tags-table-list-pointer tags-table-computed-list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
509
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
510 (if (eq tags-table-list-pointer tags-table-list-started-at)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
511 ;; We have come full circle. No more tables.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
512 (setq tags-table-list-pointer nil)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
513 ;; Set tags-file-name to the name from the list. It is already expanded.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
514 (setq tags-file-name (car tags-table-list-pointer))))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
515
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
516 (defun visit-tags-table-buffer (&optional cont)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
517 "Select the buffer containing the current tags table.
7287
0e89007c19c6 (visit-tags-tbale-buffer): If CONT is stringp, use it for tags-file-name.
Roland McGrath <roland@gnu.org>
parents: 7284
diff changeset
518 If optional arg is a string, visit that file as a tags table.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
519 If optional arg is t, visit the next table in `tags-table-list'.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
520 If optional arg is the atom `same', don't look for a new table;
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
521 just select the buffer visiting `tags-file-name'.
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
522 If arg is nil or absent, choose a first buffer from information in
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
523 `tags-file-name', `tags-table-list', `tags-table-list-pointer'.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
524 Returns t if it visits a tags table, or nil if there are no more in the list."
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
525
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
526 ;; Set tags-file-name to the tags table file we want to visit.
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
527 (cond ((eq cont 'same)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
528 ;; Use the ambient value of tags-file-name.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
529 (or tags-file-name
14420
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
530 (error "%s"
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
531 (substitute-command-keys
18623
fc78e7f26a64 (next-file, tags-loop-scan): Fix error message.
Richard M. Stallman <rms@gnu.org>
parents: 18324
diff changeset
532 (concat "No tags table in use; "
fc78e7f26a64 (next-file, tags-loop-scan): Fix error message.
Richard M. Stallman <rms@gnu.org>
parents: 18324
diff changeset
533 "use \\[visit-tags-table] to select one")))))
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
534
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
535 ((eq t cont)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
536 ;; Find the next table.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
537 (if (tags-next-table)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
538 ;; Skip over nonexistent files.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
539 (while (and (not (or (get-file-buffer tags-file-name)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
540 (file-exists-p tags-file-name)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
541 (tags-next-table)))))
7211
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
542
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
543 (t
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
544 ;; Pick a table out of our hat.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
545 (tags-table-check-computed-list) ;Get it up to date, we might use it.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
546 (setq tags-file-name
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
547 (or
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
548 ;; If passed a string, use that.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
549 (if (stringp cont)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
550 (prog1 cont
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
551 (setq cont nil)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
552 ;; First, try a local variable.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
553 (cdr (assq 'tags-file-name (buffer-local-variables)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
554 ;; Second, try a user-specified function to guess.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
555 (and default-tags-table-function
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
556 (funcall default-tags-table-function))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
557 ;; Third, look for a tags table that contains tags for the
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
558 ;; current buffer's file. If one is found, the lists will
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
559 ;; be frobnicated, and CONT will be set non-nil so we don't
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
560 ;; do it below.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
561 (and buffer-file-name
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
562 (or
8040
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
563 ;; First check only tables already in buffers.
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
564 (tags-table-including buffer-file-name t)
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
565 ;; Since that didn't find any, now do the
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
566 ;; expensive version: reading new files.
b35d46349f46 (visit-tags-table-buffer): Don't take car of return frmo
Roland McGrath <roland@gnu.org>
parents: 8015
diff changeset
567 (tags-table-including buffer-file-name nil)))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
568 ;; Fourth, use the user variable tags-file-name, if it is
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
569 ;; not already in the current list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
570 (and tags-file-name
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
571 (not (tags-table-list-member tags-file-name
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
572 tags-table-computed-list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
573 tags-file-name)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
574 ;; Fifth, use the user variable giving the table list.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
575 ;; Find the first element of the list that actually exists.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
576 (let ((list tags-table-list)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
577 file)
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
578 (while (and list
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
579 (setq file (tags-expand-table-name (car list)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
580 (not (get-file-buffer file))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
581 (not (file-exists-p file)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
582 (setq list (cdr list)))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
583 (car list))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
584 ;; Finally, prompt the user for a file name.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
585 (expand-file-name
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
586 (read-file-name "Visit tags table: (default TAGS) "
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
587 default-directory
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
588 "TAGS"
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
589 t))))))
1138
f2897f71f361 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1136
diff changeset
590
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
591 ;; Expand the table name into a full file name.
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
592 (setq tags-file-name (tags-expand-table-name tags-file-name))
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
593
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
594 (unless (and (eq cont t) (null tags-table-list-pointer))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
595 ;; Verify that tags-file-name names a valid tags table.
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
596 ;; Bind another variable with the value of tags-file-name
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
597 ;; before we switch buffers, in case tags-file-name is buffer-local.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
598 (let ((curbuf (current-buffer))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
599 (local-tags-file-name tags-file-name))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
600 (if (tags-verify-table local-tags-file-name)
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
601
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
602 ;; We have a valid tags table.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
603 (progn
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
604 ;; Bury the tags table buffer so it
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
605 ;; doesn't get in the user's way.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
606 (bury-buffer (current-buffer))
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
607
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
608 ;; If this was a new table selection (CONT is nil), make
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
609 ;; sure tags-table-list includes the chosen table, and
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
610 ;; update the list pointer variables.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
611 (or cont
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
612 ;; Look in the list for the table we chose.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
613 (let ((found (tags-table-list-member
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
614 local-tags-file-name
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
615 tags-table-computed-list)))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
616 (if found
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
617 ;; There it is. Just switch to it.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
618 (setq tags-table-list-pointer found
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
619 tags-table-list-started-at found)
4391
2f181ad12c41 (visit-tags-table-buffer): New local named
Richard M. Stallman <rms@gnu.org>
parents: 4389
diff changeset
620
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
621 ;; The table is not in the current set.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
622 ;; Try to find it in another previously used set.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
623 (let ((sets tags-table-set-list))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
624 (while (and sets
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
625 (not (tags-table-list-member
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
626 local-tags-file-name
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
627 (car sets))))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
628 (setq sets (cdr sets)))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
629 (if sets
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
630 ;; Found in some other set. Switch to that set.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
631 (progn
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
632 (or (memq tags-table-list tags-table-set-list)
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
633 ;; Save the current list.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
634 (setq tags-table-set-list
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
635 (cons tags-table-list
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
636 tags-table-set-list)))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
637 (setq tags-table-list (car sets)))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
638
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
639 ;; Not found in any existing set.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
640 (if (and tags-table-list
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
641 (or (eq t tags-add-tables)
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
642 (and tags-add-tables
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
643 (y-or-n-p
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
644 (concat "Keep current list of "
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
645 "tags tables also? ")))))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
646 ;; Add it to the current list.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
647 (setq tags-table-list (cons local-tags-file-name
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
648 tags-table-list))
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
649
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
650 ;; Make a fresh list, and store the old one.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
651 (message "Starting a new list of tags tables")
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
652 (or (null tags-table-list)
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
653 (memq tags-table-list tags-table-set-list)
7211
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
654 (setq tags-table-set-list
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
655 (cons tags-table-list
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
656 tags-table-set-list)))
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
657 ;; Clear out buffers holding old tables.
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
658 (dolist (table tags-table-list)
33418
5908c0927a3e (visit-tags-table-buffer): Beware of `t' in
Dave Love <fx@gnu.org>
parents: 32324
diff changeset
659 ;; The list can contain items `t'.
5908c0927a3e (visit-tags-table-buffer): Beware of `t' in
Dave Love <fx@gnu.org>
parents: 32324
diff changeset
660 (if (stringp table)
5908c0927a3e (visit-tags-table-buffer): Beware of `t' in
Dave Love <fx@gnu.org>
parents: 32324
diff changeset
661 (let ((buffer (find-buffer-visiting table)))
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
662 (if buffer
33418
5908c0927a3e (visit-tags-table-buffer): Beware of `t' in
Dave Love <fx@gnu.org>
parents: 32324
diff changeset
663 (kill-buffer buffer)))))
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
664 (setq tags-table-list (list local-tags-file-name))))
7211
b2485e94101a (tags-table-parent-pointer-list): Doc fix; elts are now 3-elt lists.
Roland McGrath <roland@gnu.org>
parents: 7112
diff changeset
665
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
666 ;; Recompute tags-table-computed-list.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
667 (tags-table-check-computed-list)
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
668 ;; Set the tags table list state variables to start
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
669 ;; over from tags-table-computed-list.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
670 (setq tags-table-list-started-at tags-table-computed-list
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
671 tags-table-list-pointer
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
672 tags-table-computed-list)))))
1156
2a92ddfaf6ba entered into RCS
Roland McGrath <roland@gnu.org>
parents: 1152
diff changeset
673
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
674 ;; Return of t says the tags table is valid.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
675 t)
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
676
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
677 ;; The buffer was not valid. Don't use it again.
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
678 (set-buffer curbuf)
7934
b5e9b6a00f5d (tags-table-computed-list, tags-table-computed-list-for): New variables.
Roland McGrath <roland@gnu.org>
parents: 7904
diff changeset
679 (kill-local-variable 'tags-file-name)
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
680 (if (eq local-tags-file-name tags-file-name)
8116
67c8a970fd4d (visit-tags-table-buffer): Move error call into scope of `file'.
Richard M. Stallman <rms@gnu.org>
parents: 8082
diff changeset
681 (setq tags-file-name nil))
8297
80d4bf018aec (visit-tags-table-buffer): Bind a variable local-tags-file-name with the
Roland McGrath <roland@gnu.org>
parents: 8187
diff changeset
682 (error "File %s is not a valid tags table" local-tags-file-name)))))
9525
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
683
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
684 (defun tags-reset-tags-tables ()
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
685 "Reset tags state to cancel effect of any previous \\[visit-tags-table] or \\[find-tag]."
9525
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
686 (interactive)
23377
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
687 ;; Clear out the markers we are throwing away.
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
688 (let ((i 0))
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
689 (while (< i find-tag-marker-ring-length)
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
690 (if (aref (cddr tags-location-ring) i)
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
691 (set-marker (aref (cddr tags-location-ring) i) nil))
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
692 (if (aref (cddr find-tag-marker-ring) i)
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
693 (set-marker (aref (cddr find-tag-marker-ring) i) nil))
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
694 (setq i (1+ i))))
9525
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
695 (setq tags-file-name nil
23377
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
696 tags-location-ring (make-ring find-tag-marker-ring-length)
acb6d2c4220b (tags-reset-tags-tables): Properly
Karl Heuer <kwzh@gnu.org>
parents: 22594
diff changeset
697 find-tag-marker-ring (make-ring find-tag-marker-ring-length)
9525
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
698 tags-table-list nil
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
699 tags-table-computed-list nil
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
700 tags-table-computed-list-for nil
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
701 tags-table-list-pointer nil
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
702 tags-table-list-started-at nil
6cd679419a9c (tags-reset-tags-tables): New function.
Roland McGrath <roland@gnu.org>
parents: 9152
diff changeset
703 tags-table-set-list nil))
1397
d469afe703c4 (visit-tags-table-buffer): When trying to pick table, call
Roland McGrath <roland@gnu.org>
parents: 1156
diff changeset
704
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
705 (defun file-of-tag ()
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
706 "Return the file name of the file whose tags point is within.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
707 Assumes the tags table is the current buffer.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
708 File name returned is relative to tags table file's directory."
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
709 (funcall file-of-tag-function))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
710
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
711 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
712 (defun tags-table-files ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
713 "Return a list of files in the current tags table.
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
714 Assumes the tags table is the current buffer. The file names are returned
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
715 as they appeared in the `etags' command that created the table, usually
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
716 without directory names."
1397
d469afe703c4 (visit-tags-table-buffer): When trying to pick table, call
Roland McGrath <roland@gnu.org>
parents: 1156
diff changeset
717 (or tags-table-files
d469afe703c4 (visit-tags-table-buffer): When trying to pick table, call
Roland McGrath <roland@gnu.org>
parents: 1156
diff changeset
718 (setq tags-table-files
d469afe703c4 (visit-tags-table-buffer): When trying to pick table, call
Roland McGrath <roland@gnu.org>
parents: 1156
diff changeset
719 (funcall tags-table-files-function))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
720
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
721 (defun tags-included-tables ()
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
722 "Return a list of tags tables included by the current table.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
723 Assumes the tags table is the current buffer."
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
724 (or tags-included-tables
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
725 (setq tags-included-tables (funcall tags-included-tables-function))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
726
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
727 ;; Build tags-completion-table on demand. The single current tags table
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
728 ;; and its included tags tables (and their included tables, etc.) have
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
729 ;; their tags included in the completion table.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
730 (defun tags-completion-table ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
731 (or tags-completion-table
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
732 (condition-case ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
733 (prog2
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
734 (message "Making tags completion table for %s..." buffer-file-name)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
735 (let ((included (tags-included-tables))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
736 (table (funcall tags-completion-table-function)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
737 (save-excursion
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
738 ;; Iterate over the list of included tables, and combine each
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
739 ;; included table's completion obarray to the parent obarray.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
740 (while included
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
741 ;; Visit the buffer.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
742 (let ((tags-file-name (car included)))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
743 (visit-tags-table-buffer 'same))
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
744 ;; Recurse in that buffer to compute its completion table.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
745 (if (tags-completion-table)
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
746 ;; Combine the tables.
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
747 (mapatoms (lambda (sym) (intern (symbol-name sym) table))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
748 tags-completion-table))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
749 (setq included (cdr included))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
750 (setq tags-completion-table table))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
751 (message "Making tags completion table for %s...done"
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
752 buffer-file-name))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
753 (quit (message "Tags completion table construction aborted.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
754 (setq tags-completion-table nil)))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
755
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
756 ;; Completion function for tags. Does normal try-completion,
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
757 ;; but builds tags-completion-table on demand.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
758 (defun tags-complete-tag (string predicate what)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
759 (save-excursion
5079
1d253bc912d8 (tags-complete-tag): Bind enable-recursive-minibuffers to t.
Richard M. Stallman <rms@gnu.org>
parents: 4940
diff changeset
760 ;; If we need to ask for the tag table, allow that.
1d253bc912d8 (tags-complete-tag): Bind enable-recursive-minibuffers to t.
Richard M. Stallman <rms@gnu.org>
parents: 4940
diff changeset
761 (let ((enable-recursive-minibuffers t))
1d253bc912d8 (tags-complete-tag): Bind enable-recursive-minibuffers to t.
Richard M. Stallman <rms@gnu.org>
parents: 4940
diff changeset
762 (visit-tags-table-buffer))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
763 (if (eq what t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
764 (all-completions string (tags-completion-table) predicate)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
765 (try-completion string (tags-completion-table) predicate))))
1397
d469afe703c4 (visit-tags-table-buffer): When trying to pick table, call
Roland McGrath <roland@gnu.org>
parents: 1156
diff changeset
766
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
767 ;; Return a default tag to search for, based on the text at point.
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
768 (defun find-tag-default ()
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
769 (save-excursion
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
770 (while (looking-at "\\sw\\|\\s_")
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
771 (forward-char 1))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
772 (if (or (re-search-backward "\\sw\\|\\s_"
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
773 (save-excursion (beginning-of-line) (point))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
774 t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
775 (re-search-forward "\\(\\sw\\|\\s_\\)+"
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
776 (save-excursion (end-of-line) (point))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
777 t))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
778 (progn (goto-char (match-end 0))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
779 (buffer-substring (point)
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
780 (progn (forward-sexp -1)
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
781 (while (looking-at "\\s'")
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
782 (forward-char 1))
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
783 (point))))
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
784 nil)))
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
785
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
786 ;; Read a tag name from the minibuffer with defaulting and completion.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
787 (defun find-tag-tag (string)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
788 (let* ((default (funcall (or find-tag-default-function
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
789 (get major-mode 'find-tag-default-function)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
790 'find-tag-default)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
791 (spec (completing-read (if default
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
792 (format "%s(default %s) " string default)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
793 string)
19735
73c2effb07a4 (find-tag-tag): Pass default to completing-read.
Richard M. Stallman <rms@gnu.org>
parents: 19358
diff changeset
794 'tags-complete-tag
73c2effb07a4 (find-tag-tag): Pass default to completing-read.
Richard M. Stallman <rms@gnu.org>
parents: 19358
diff changeset
795 nil nil nil nil default)))
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
796 (if (equal spec "")
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
797 (or default (error "There is no default tag"))
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
798 spec)))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
799
852
06165faefe70 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 846
diff changeset
800 (defvar last-tag nil
06165faefe70 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 846
diff changeset
801 "Last tag found by \\[find-tag].")
06165faefe70 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 846
diff changeset
802
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
803 ;; Get interactive args for find-tag{-noselect,-other-window,-regexp}.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
804 (defun find-tag-interactive (prompt &optional no-default)
35226
e1ba079c4709 (find-tag-interactive): If last-tag is nil,
Eli Zaretskii <eliz@gnu.org>
parents: 35181
diff changeset
805 (if (and current-prefix-arg last-tag)
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
806 (list nil (if (< (prefix-numeric-value current-prefix-arg) 0)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
807 '-
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
808 t))
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
809 (list (if no-default
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
810 (read-string prompt)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
811 (find-tag-tag prompt)))))
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
812
7904
c2259f58ef7e (find-tag-history): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 7843
diff changeset
813 (defvar find-tag-history nil)
c2259f58ef7e (find-tag-history): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 7843
diff changeset
814
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
815 ;; Dynamic bondage:
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
816 (eval-when-compile
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
817 (defvar etags-case-fold-search)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
818 (defvar etags-syntax-table))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
819
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
820 ;;;###autoload
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
821 (defun find-tag-noselect (tagname &optional next-p regexp-p)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
822 "Find tag (in current tags table) whose name contains TAGNAME.
1555
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
823 Returns the buffer containing the tag's definition and moves its point there,
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
824 but does not select the buffer.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
825 The default for TAGNAME is the expression in the buffer near point.
474
c3bbd755b7da *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 452
diff changeset
826
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
827 If second arg NEXT-P is t (interactively, with prefix arg), search for
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
828 another tag that matches the last tagname or regexp used. When there are
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
829 multiple matches for a tag, more exact matches are found first. If NEXT-P
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
830 is the atom `-' (interactively, with prefix arg that is a negative number
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
831 or just \\[negative-argument]), pop back to the previous tag gone to.
450
0bac8c701777 *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 449
diff changeset
832
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
833 If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
834
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
835 A marker representing the point when this command is onvoked is pushed
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
836 onto a ring and may be popped back to with \\[pop-tag-mark].
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
837 Contrast this with the ring of marks gone to by the command.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
838
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
839 See documentation of variable `tags-file-name'."
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
840 (interactive (find-tag-interactive "Find tag: "))
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
841
7904
c2259f58ef7e (find-tag-history): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 7843
diff changeset
842 (setq find-tag-history (cons tagname find-tag-history))
35312
2f2f03dac098 (find-tag-noselect): Save the value of
Gerd Moellmann <gerd@gnu.org>
parents: 35226
diff changeset
843 ;; Save the current buffer's value of `find-tag-hook' before
2f2f03dac098 (find-tag-noselect): Save the value of
Gerd Moellmann <gerd@gnu.org>
parents: 35226
diff changeset
844 ;; selecting the tags table buffer. For the same reason, save value
2f2f03dac098 (find-tag-noselect): Save the value of
Gerd Moellmann <gerd@gnu.org>
parents: 35226
diff changeset
845 ;; of `tags-file-name' in case it has a buffer-local value.
35649
3379eca770e2 (find-tag-noselect): Don't bind
Gerd Moellmann <gerd@gnu.org>
parents: 35312
diff changeset
846 (let ((local-find-tag-hook find-tag-hook))
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
847 (if (eq '- next-p)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
848 ;; Pop back to a previous location.
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
849 (if (ring-empty-p tags-location-ring)
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
850 (error "No previous tag locations")
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
851 (let ((marker (ring-remove tags-location-ring 0)))
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
852 (prog1
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
853 ;; Move to the saved location.
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
854 (set-buffer (or (marker-buffer marker)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
855 (error "The marked buffer has been deleted")))
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
856 (goto-char (marker-position marker))
3591
507f64624555 Apply typo patches from Paul Eggert.
Jim Blandy <jimb@redhat.com>
parents: 3548
diff changeset
857 ;; Kill that marker so it doesn't slow down editing.
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
858 (set-marker marker nil nil)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
859 ;; Run the user's hook. Do we really want to do this for pop?
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
860 (run-hooks 'local-find-tag-hook))))
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
861 ;; Record whence we came.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
862 (ring-insert find-tag-marker-ring (point-marker))
35226
e1ba079c4709 (find-tag-interactive): If last-tag is nil,
Eli Zaretskii <eliz@gnu.org>
parents: 35181
diff changeset
863 (if (and next-p last-tag)
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
864 ;; Find the same table we last used.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
865 (visit-tags-table-buffer 'same)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
866 ;; Pick a table to use.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
867 (visit-tags-table-buffer)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
868 ;; Record TAGNAME for a future call with NEXT-P non-nil.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
869 (setq last-tag tagname))
8973
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
870 ;; Record the location so we can pop back to it later.
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
871 (let ((marker (make-marker)))
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
872 (save-excursion
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
873 (set-buffer
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
874 ;; find-tag-in-order does the real work.
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
875 (find-tag-in-order
35226
e1ba079c4709 (find-tag-interactive): If last-tag is nil,
Eli Zaretskii <eliz@gnu.org>
parents: 35181
diff changeset
876 (if (and next-p last-tag) last-tag tagname)
8973
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
877 (if regexp-p
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
878 find-tag-regexp-search-function
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
879 find-tag-search-function)
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
880 (if regexp-p
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
881 find-tag-regexp-tag-order
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
882 find-tag-tag-order)
8973
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
883 (if regexp-p
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
884 find-tag-regexp-next-line-after-failure-p
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
885 find-tag-next-line-after-failure-p)
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
886 (if regexp-p "matching" "containing")
35226
e1ba079c4709 (find-tag-interactive): If last-tag is nil,
Eli Zaretskii <eliz@gnu.org>
parents: 35181
diff changeset
887 (or (not next-p) (not last-tag))))
8973
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
888 (set-marker marker (point))
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
889 (run-hooks 'local-find-tag-hook)
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
890 (ring-insert tags-location-ring marker)
8973
99d8538efe2f (find-tag-noselect): Simplify.
Richard M. Stallman <rms@gnu.org>
parents: 8623
diff changeset
891 (current-buffer))))))
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
892
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
893 ;;;###autoload
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
894 (defun find-tag (tagname &optional next-p regexp-p)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
895 "Find tag (in current tags table) whose name contains TAGNAME.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
896 Select the buffer containing the tag's definition, and move point there.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
897 The default for TAGNAME is the expression in the buffer around or before point.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
898
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
899 If second arg NEXT-P is t (interactively, with prefix arg), search for
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
900 another tag that matches the last tagname or regexp used. When there are
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
901 multiple matches for a tag, more exact matches are found first. If NEXT-P
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
902 is the atom `-' (interactively, with prefix arg that is a negative number
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
903 or just \\[negative-argument]), pop back to the previous tag gone to.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
904
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
905 If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
906
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
907 A marker representing the point when this command is onvoked is pushed
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
908 onto a ring and may be popped back to with \\[pop-tag-mark].
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
909 Contrast this with the ring of marks gone to by the command.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
910
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
911 See documentation of variable `tags-file-name'."
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
912 (interactive (find-tag-interactive "Find tag: "))
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
913 (let ((buf (find-tag-noselect tagname next-p regexp-p)))
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
914 (condition-case nil
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
915 (switch-to-buffer buf)
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
916 (error (pop-to-buffer buf)))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
917 ;;;###autoload (define-key esc-map "." 'find-tag)
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
918
727
540b047ece4d *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 662
diff changeset
919 ;;;###autoload
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
920 (defun find-tag-other-window (tagname &optional next-p regexp-p)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
921 "Find tag (in current tags table) whose name contains TAGNAME.
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
922 Select the buffer containing the tag's definition in another window, and
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
923 move point there. The default for TAGNAME is the expression in the buffer
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
924 around or before point.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
925
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
926 If second arg NEXT-P is t (interactively, with prefix arg), search for
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
927 another tag that matches the last tagname or regexp used. When there are
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
928 multiple matches for a tag, more exact matches are found first. If NEXT-P
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
929 is negative (interactively, with prefix arg that is a negative number or
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
930 just \\[negative-argument]), pop back to the previous tag gone to.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
931
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
932 If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
933
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
934 A marker representing the point when this command is onvoked is pushed
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
935 onto a ring and may be popped back to with \\[pop-tag-mark].
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
936 Contrast this with the ring of marks gone to by the command.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
937
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
938 See documentation of variable `tags-file-name'."
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
939 (interactive (find-tag-interactive "Find tag other window: "))
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
940
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
941 ;; This hair is to deal with the case where the tag is found in the
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
942 ;; selected window's buffer; without the hair, point is moved in both
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
943 ;; windows. To prevent this, we save the selected window's point before
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
944 ;; doing find-tag-noselect, and restore it after.
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
945 (let* ((window-point (window-point (selected-window)))
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
946 (tagbuf (find-tag-noselect tagname next-p regexp-p))
1976
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
947 (tagpoint (progn (set-buffer tagbuf) (point))))
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
948 (set-window-point (prog1
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
949 (selected-window)
1976
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
950 (switch-to-buffer-other-window tagbuf)
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
951 ;; We have to set this new window's point; it
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
952 ;; might already have been displaying a
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
953 ;; different portion of tagbuf, in which case
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
954 ;; switch-to-buffer-other-window doesn't set
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
955 ;; the window's point from the buffer.
eda7eec8f8ad * etags.el (find-tag-other-window): If another window is already
Jim Blandy <jimb@redhat.com>
parents: 1816
diff changeset
956 (set-window-point (selected-window) tagpoint))
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
957 window-point)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
958 ;;;###autoload (define-key ctl-x-4-map "." 'find-tag-other-window)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
959
804
33aaf4b71a1d *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 800
diff changeset
960 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
961 (defun find-tag-other-frame (tagname &optional next-p)
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
962 "Find tag (in current tags table) whose name contains TAGNAME.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
963 Select the buffer containing the tag's definition in another frame, and
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
964 move point there. The default for TAGNAME is the expression in the buffer
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
965 around or before point.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
966
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
967 If second arg NEXT-P is t (interactively, with prefix arg), search for
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
968 another tag that matches the last tagname or regexp used. When there are
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
969 multiple matches for a tag, more exact matches are found first. If NEXT-P
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
970 is negative (interactively, with prefix arg that is a negative number or
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
971 just \\[negative-argument]), pop back to the previous tag gone to.
727
540b047ece4d *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 662
diff changeset
972
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
973 If third arg REGEXP-P is non-nil, treat TAGNAME as a regexp.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
974
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
975 A marker representing the point when this command is onvoked is pushed
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
976 onto a ring and may be popped back to with \\[pop-tag-mark].
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
977 Contrast this with the ring of marks gone to by the command.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
978
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
979 See documentation of variable `tags-file-name'."
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
980 (interactive (find-tag-interactive "Find tag other frame: "))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
981 (let ((pop-up-frames t))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
982 (find-tag-other-window tagname next-p)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
983 ;;;###autoload (define-key ctl-x-5-map "." 'find-tag-other-frame)
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
984
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
985 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
986 (defun find-tag-regexp (regexp &optional next-p other-window)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
987 "Find tag (in current tags table) whose name matches REGEXP.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
988 Select the buffer containing the tag's definition and move point there.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
989
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
990 If second arg NEXT-P is t (interactively, with prefix arg), search for
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
991 another tag that matches the last tagname or regexp used. When there are
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
992 multiple matches for a tag, more exact matches are found first. If NEXT-P
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
993 is negative (interactively, with prefix arg that is a negative number or
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
994 just \\[negative-argument]), pop back to the previous tag gone to.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
995
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
996 If third arg OTHER-WINDOW is non-nil, select the buffer in another window.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
997
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
998 A marker representing the point when this command is onvoked is pushed
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
999 onto a ring and may be popped back to with \\[pop-tag-mark].
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1000 Contrast this with the ring of marks gone to by the command.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1001
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1002 See documentation of variable `tags-file-name'."
2590
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
1003 (interactive (find-tag-interactive "Find tag regexp: " t))
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
1004 ;; We go through find-tag-other-window to do all the display hair there.
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
1005 (funcall (if other-window 'find-tag-other-window 'find-tag)
9dace03bd76c (find-tag-interactive): New function to read args for find-tag et al.
Roland McGrath <roland@gnu.org>
parents: 2448
diff changeset
1006 regexp next-p t))
8187
9120cee6bfab (find-tag-regexp): Bind to C-M-..
Richard M. Stallman <rms@gnu.org>
parents: 8116
diff changeset
1007 ;;;###autoload (define-key esc-map [?\C-.] 'find-tag-regexp)
20799
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1008
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1009 ;;;###autoload (define-key esc-map "*" 'pop-tag-mark)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1010
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1011 ;;;###autoload
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1012 (defun pop-tag-mark ()
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1013 "Pop back to where \\[find-tag] was last invoked.
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1014
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1015 This is distinct from invoking \\[find-tag] with a negative argument
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1016 since that pops a stack of markers at which tags were found, not from
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1017 where they were found."
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1018 (interactive)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1019 (if (ring-empty-p find-tag-marker-ring)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1020 (error "No previous locations for find-tag invocation"))
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1021 (let ((marker (ring-remove find-tag-marker-ring 0)))
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1022 (switch-to-buffer (or (marker-buffer marker)
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1023 (error "The marked buffer has been deleted")))
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1024 (goto-char (marker-position marker))
e244bb966970 (find-tag-marker-ring-length): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 20682
diff changeset
1025 (set-marker marker nil nil)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1026
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1027 ;; Internal tag finding function.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1028
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1029 ;; PATTERN is a string to pass to second arg SEARCH-FORWARD-FUNC, and to
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1030 ;; any member of the function list ORDER (third arg). If ORDER is nil,
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1031 ;; use saved state to continue a previous search.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1032
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1033 ;; Fourth arg MATCHING is a string, an English '-ing' word, to be used in
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1034 ;; an error message.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1035
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1036 ;; Fifth arg NEXT-LINE-AFTER-FAILURE-P is non-nil if after a failed match,
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1037 ;; point should be moved to the next line.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1038
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1039 ;; Algorithm is as follows. For each qualifier-func in ORDER, go to
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1040 ;; beginning of tags file, and perform inner loop: for each naive match for
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1041 ;; PATTERN found using SEARCH-FORWARD-FUNC, qualify the naive match using
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1042 ;; qualifier-func. If it qualifies, go to the specified line in the
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1043 ;; specified source file and return. Qualified matches are remembered to
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1044 ;; avoid repetition. State is saved so that the loop can be continued.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1045
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1046 (defvar tag-lines-already-matched nil) ;matches remembered here between calls
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1047
1555
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1048 (defun find-tag-in-order (pattern
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1049 search-forward-func
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1050 order
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1051 next-line-after-failure-p
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1052 matching
695c6eb2ff31 * etags.el (find-tag-noselect): Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1397
diff changeset
1053 first-search)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1054 (let (file ;name of file containing tag
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1055 tag-info ;where to find the tag in FILE
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1056 (first-table t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1057 (tag-order order)
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1058 (match-marker (make-marker))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1059 goto-func
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1060 (case-fold-search (if (memq tags-case-fold-search '(nil t))
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1061 tags-case-fold-search
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1062 case-fold-search))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1063 )
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1064 (save-excursion
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1065
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1066 (if first-search
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1067 ;; This is the start of a search for a fresh tag.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1068 ;; Clear the list of tags matched by the previous search.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1069 ;; find-tag-noselect has already put us in the first tags table
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1070 ;; buffer before we got called.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1071 (setq tag-lines-already-matched nil)
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1072 ;; Continuing to search for the tag specified last time.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1073 ;; tag-lines-already-matched lists locations matched in previous
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1074 ;; calls so we don't visit the same tag twice if it matches twice
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1075 ;; during two passes with different qualification predicates.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1076 ;; Switch to the current tags table buffer.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1077 (visit-tags-table-buffer 'same))
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
1078
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1079 ;; Get a qualified match.
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1080 (catch 'qualified-match-found
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
1081
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1082 ;; Iterate over the list of tags tables.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1083 (while (or first-table
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1084 (visit-tags-table-buffer t))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1085
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1086 (and first-search first-table
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1087 ;; Start at beginning of tags file.
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1088 (goto-char (point-min)))
10661
32beb7b6dbf7 Changes to support filenames as tags too and provided
Richard M. Stallman <rms@gnu.org>
parents: 10458
diff changeset
1089
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1090 (setq first-table nil)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1091
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1092 ;; Iterate over the list of ordering predicates.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1093 (while order
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1094 (while (funcall search-forward-func pattern nil t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1095 ;; Naive match found. Qualify the match.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1096 (and (funcall (car order) pattern)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1097 ;; Make sure it is not a previous qualified match.
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1098 (not (member (set-marker match-marker (save-excursion
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1099 (beginning-of-line)
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1100 (point)))
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1101 tag-lines-already-matched))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1102 (throw 'qualified-match-found nil))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1103 (if next-line-after-failure-p
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1104 (forward-line 1)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1105 ;; Try the next flavor of match.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1106 (setq order (cdr order))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1107 (goto-char (point-min)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1108 (setq order tag-order))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1109 ;; We throw out on match, so only get here if there were no matches.
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1110 ;; Clear out the markers we use to avoid duplicate matches so they
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1111 ;; don't slow down editting and are immediately available for GC.
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1112 (while tag-lines-already-matched
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1113 (set-marker (car tag-lines-already-matched) nil nil)
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1114 (setq tag-lines-already-matched (cdr tag-lines-already-matched)))
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1115 (set-marker match-marker nil nil)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1116 (error "No %stags %s %s" (if first-search "" "more ")
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1117 matching pattern))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1118
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1119 ;; Found a tag; extract location info.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1120 (beginning-of-line)
15352
e648211d5bac Fri Jun 7 13:06:53 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
Roland McGrath <roland@gnu.org>
parents: 14420
diff changeset
1121 (setq tag-lines-already-matched (cons match-marker
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1122 tag-lines-already-matched))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1123 ;; Expand the filename, using the tags table buffer's default-directory.
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1124 ;; We should be able to search for file-name backwards in file-of-tag:
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1125 ;; the beginning-of-line is ok except when positioned on a "file-name" tag.
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1126 (setq file (expand-file-name
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1127 (if (memq (car order) '(tag-exact-file-name-match-p
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1128 tag-file-name-match-p
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1129 tag-partial-file-name-match-p))
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1130 (save-excursion (next-line 1)
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1131 (file-of-tag))
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1132 (file-of-tag)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1133 tag-info (funcall snarf-tag-function))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1134
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1135 ;; Get the local value in the tags table buffer before switching buffers.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1136 (setq goto-func goto-tag-location-function)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1137
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1138 ;; Find the right line in the specified file.
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1139 ;; If we are interested in compressed-files,
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1140 ;; we search files with extensions.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1141 ;; otherwise only the real file.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1142 (let* ((buffer-search-extensions (if (featurep 'jka-compr)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1143 tags-compression-info-list
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1144 '("")))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1145 the-buffer
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1146 (file-search-extensions buffer-search-extensions))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1147 ;; search a buffer visiting the file with each possible extension
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1148 ;; Note: there is a small inefficiency in find-buffer-visiting :
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1149 ;; truename is computed even if not needed. Not too sure about this
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1150 ;; but I suspect truename computation accesses the disk.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1151 ;; It is maybe a good idea to optimise this find-buffer-visiting.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1152 ;; An alternative would be to use only get-file-buffer
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1153 ;; but this looks less "sure" to find the buffer for the file.
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1154 (while (and (not the-buffer) buffer-search-extensions)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1155 (setq the-buffer (find-buffer-visiting (concat file (car buffer-search-extensions))))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1156 (setq buffer-search-extensions (cdr buffer-search-extensions)))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1157 ;; if found a buffer but file modified, ensure we re-read !
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1158 (if (and the-buffer (not (verify-visited-file-modtime the-buffer)))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1159 (find-file-noselect (buffer-file-name the-buffer)))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1160 ;; if no buffer found, search for files with possible extensions on disk
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1161 (while (and (not the-buffer) file-search-extensions)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1162 (if (not (file-exists-p (concat file (car file-search-extensions))))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1163 (setq file-search-extensions (cdr file-search-extensions))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1164 (setq the-buffer (find-file-noselect (concat file (car file-search-extensions))))))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1165 (if (not the-buffer)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1166 (if (featurep 'jka-compr)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1167 (error "File %s (with or without extensions %s) not found" file tags-compression-info-list)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1168 (error "File %s not found" file))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1169 (set-buffer the-buffer)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1170 (widen)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1171 (push-mark)
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1172 (funcall goto-func tag-info)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1173
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1174 ;; Return the buffer where the tag was found.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1175 (current-buffer))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1176
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1177 ;; `etags' TAGS file format support.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1178
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1179 ;; If the current buffer is a valid etags TAGS file, give it local values of
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1180 ;; the tags table format variables, and return non-nil.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1181 (defun etags-recognize-tags-table ()
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1182 (and (etags-verify-tags-table)
1136
4d4c177b980f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 1032
diff changeset
1183 ;; It is annoying to flash messages on the screen briefly,
4d4c177b980f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 1032
diff changeset
1184 ;; and this message is not useful. -- rms
4d4c177b980f *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 1032
diff changeset
1185 ;; (message "%s is an `etags' TAGS file" buffer-file-name)
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1186 (mapc (lambda (elt) (set (make-local-variable (car elt)) (cdr elt)))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1187 '((file-of-tag-function . etags-file-of-tag)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1188 (tags-table-files-function . etags-tags-table-files)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1189 (tags-completion-table-function . etags-tags-completion-table)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1190 (snarf-tag-function . etags-snarf-tag)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1191 (goto-tag-location-function . etags-goto-tag-location)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1192 (find-tag-regexp-search-function . re-search-forward)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1193 (find-tag-regexp-tag-order . (tag-re-match-p))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1194 (find-tag-regexp-next-line-after-failure-p . t)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1195 (find-tag-search-function . search-forward)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1196 (find-tag-tag-order . (tag-exact-file-name-match-p
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1197 tag-file-name-match-p
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1198 tag-exact-match-p
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1199 tag-symbol-match-p
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1200 tag-word-match-p
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1201 tag-partial-file-name-match-p
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1202 tag-any-match-p))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1203 (find-tag-next-line-after-failure-p . nil)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1204 (list-tags-function . etags-list-tags)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1205 (tags-apropos-function . etags-tags-apropos)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1206 (tags-included-tables-function . etags-tags-included-tables)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1207 (verify-tags-table-function . etags-verify-tags-table)
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1208 ))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1209
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1210 ;; Return non-nil iff the current buffer is a valid etags TAGS file.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1211 (defun etags-verify-tags-table ()
1723
4023bea27d64 (etags-verify-tags-table): Use eq instead of = in case char-after returns
Roland McGrath <roland@gnu.org>
parents: 1697
diff changeset
1212 ;; Use eq instead of = in case char-after returns nil.
4023bea27d64 (etags-verify-tags-table): Use eq instead of = in case char-after returns
Roland McGrath <roland@gnu.org>
parents: 1697
diff changeset
1213 (eq (char-after 1) ?\f))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1214
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1215 (defun etags-file-of-tag ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1216 (save-excursion
16367
168e1370e887 (etags-file-of-tag): Fix looking-at regexp.
Richard M. Stallman <rms@gnu.org>
parents: 16281
diff changeset
1217 (re-search-backward "\f\n\\([^\n]+\\),[0-9]*\n")
16625
b24b7ef8573b (etags-file-of-tag): Expand the file name
Richard M. Stallman <rms@gnu.org>
parents: 16367
diff changeset
1218 (expand-file-name (buffer-substring (match-beginning 1) (match-end 1))
b24b7ef8573b (etags-file-of-tag): Expand the file name
Richard M. Stallman <rms@gnu.org>
parents: 16367
diff changeset
1219 (file-truename default-directory))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1220
10680
69cbb0d5671d (etags-file-of-tag): Handle file name used as tag.
Richard M. Stallman <rms@gnu.org>
parents: 10661
diff changeset
1221
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1222 (defun etags-tags-completion-table ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1223 (let ((table (make-vector 511 0)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1224 (save-excursion
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1225 (goto-char (point-min))
2448
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1226 ;; This monster regexp matches an etags tag line.
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1227 ;; \1 is the string to match;
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1228 ;; \2 is not interesting;
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1229 ;; \3 is the guessed tag name; XXX guess should be better eg DEFUN
4407
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1230 ;; \4 is not interesting;
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1231 ;; \5 is the explicitly-specified tag name.
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1232 ;; \6 is the line to start searching at;
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1233 ;; \7 is the char to start searching at.
2448
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1234 (while (re-search-forward
28738
d53c2c6bc56f (etags-tags-completion-table): Add a `:'
Gerd Moellmann <gerd@gnu.org>
parents: 28704
diff changeset
1235 "^\\(\\([^\177]+[^-a-zA-Z0-9_+*$:\177]+\\)?\
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1236 \\([-a-zA-Z0-9_+*$?:]+\\)[^-a-zA-Z0-9_+*$?:\177]*\\)\177\
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1237 \\(\\([^\n\001]+\\)\001\\)?\\([0-9]+\\)?,\\([0-9]+\\)?\n"
2448
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1238 nil t)
4407
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1239 (intern (if (match-beginning 5)
2448
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1240 ;; There is an explicit tag name.
4407
5568d8e60c21 (etags-tags-completion-table): Fixed regexp for today's format.
Roland McGrath <roland@gnu.org>
parents: 4391
diff changeset
1241 (buffer-substring (match-beginning 5) (match-end 5))
2448
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1242 ;; No explicit tag name. Best guess.
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1243 (buffer-substring (match-beginning 3) (match-end 3)))
0d7fdb12dcdb (etags-tags-completion-table): Rewritten with a mondo regexp.
Roland McGrath <roland@gnu.org>
parents: 2445
diff changeset
1244 table)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1245 table))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1246
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1247 (defun etags-snarf-tag ()
6244
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1248 (let (tag-text line startpos)
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1249 (if (save-excursion
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1250 (forward-line -1)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1251 (looking-at "\f\n"))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1252 ;; The match was for a source file name, not any tag within a file.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1253 ;; Give text of t, meaning to go exactly to the location we specify,
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1254 ;; the beginning of the file.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1255 (setq tag-text t
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1256 line nil
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1257 startpos 1)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1258
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1259 ;; Find the end of the tag and record the whole tag text.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1260 (search-forward "\177")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1261 (setq tag-text (buffer-substring (1- (point))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1262 (save-excursion (beginning-of-line)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1263 (point))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1264 ;; Skip explicit tag name if present.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1265 (search-forward "\001" (save-excursion (forward-line 1) (point)) t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1266 (if (looking-at "[0-9]")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1267 (setq line (string-to-int (buffer-substring
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1268 (point)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1269 (progn (skip-chars-forward "0-9")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1270 (point))))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1271 (search-forward ",")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1272 (if (looking-at "[0-9]")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1273 (setq startpos (string-to-int (buffer-substring
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1274 (point)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1275 (progn (skip-chars-forward "0-9")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1276 (point)))))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1277 ;; Leave point on the next line of the tags file.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1278 (forward-line 1)
6244
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1279 (cons tag-text (cons line startpos))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1280
6244
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1281 ;; TAG-INFO is a cons (TEXT LINE . POSITION) where TEXT is the initial part
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1282 ;; of a line containing the tag and POSITION is the character position of
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1283 ;; TEXT within the file (starting from 1); LINE is the line number. If
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1284 ;; TEXT is t, it means the tag refers to exactly LINE or POSITION
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1285 ;; (whichever is present, LINE having preference, no searching. Either
6244
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1286 ;; LINE or POSITION may be nil; POSITION is used if present. If the tag
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1287 ;; isn't exactly at the given position then look around that position using
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1288 ;; a search window which expands until it hits the start of file.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1289 (defun etags-goto-tag-location (tag-info)
6244
3ad3a0150b6d (etags-tags-completion-table): Let the line number or char pos be empty.
Roland McGrath <roland@gnu.org>
parents: 6140
diff changeset
1290 (let ((startpos (cdr (cdr tag-info)))
15770
17158dfe7765 (etags-goto-tag-location): New local variable LINE; use it.
Roland McGrath <roland@gnu.org>
parents: 15360
diff changeset
1291 (line (car (cdr tag-info)))
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1292 offset found pat)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1293 (if (eq (car tag-info) t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1294 ;; Direct file tag.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1295 (cond (line (goto-line line))
15770
17158dfe7765 (etags-goto-tag-location): New local variable LINE; use it.
Roland McGrath <roland@gnu.org>
parents: 15360
diff changeset
1296 (startpos (goto-char startpos))
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1297 (t (error "etags.el BUG: bogus direct file tag")))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1298 ;; This constant is 1/2 the initial search window.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1299 ;; There is no sense in making it too small,
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1300 ;; since just going around the loop once probably
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1301 ;; costs about as much as searching 2000 chars.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1302 (setq offset 1000
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1303 found nil
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1304 pat (concat (if (eq selective-display t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1305 "\\(^\\|\^m\\)" "^")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1306 (regexp-quote (car tag-info))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1307 ;; The character position in the tags table is 0-origin.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1308 ;; Convert it to a 1-origin Emacs character position.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1309 (if startpos (setq startpos (1+ startpos)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1310 ;; If no char pos was given, try the given line number.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1311 (or startpos
15770
17158dfe7765 (etags-goto-tag-location): New local variable LINE; use it.
Roland McGrath <roland@gnu.org>
parents: 15360
diff changeset
1312 (if line
17158dfe7765 (etags-goto-tag-location): New local variable LINE; use it.
Roland McGrath <roland@gnu.org>
parents: 15360
diff changeset
1313 (setq startpos (progn (goto-line line)
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1314 (point)))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1315 (or startpos
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1316 (setq startpos (point-min)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1317 ;; First see if the tag is right at the specified location.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1318 (goto-char startpos)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1319 (setq found (looking-at pat))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1320 (while (and (not found)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1321 (progn
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1322 (goto-char (- startpos offset))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1323 (not (bobp))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1324 (setq found
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1325 (re-search-forward pat (+ startpos offset) t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1326 offset (* 3 offset))) ; expand search window
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1327 (or found
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1328 (re-search-forward pat nil t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1329 (error "Rerun etags: `%s' not found in %s"
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1330 pat buffer-file-name)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1331 ;; Position point at the right place
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1332 ;; if the search string matched an extra Ctrl-m at the beginning.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1333 (and (eq selective-display t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1334 (looking-at "\^m")
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1335 (forward-char 1))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1336 (beginning-of-line)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1337
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1338 (defun etags-list-tags (file)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1339 (goto-char 1)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1340 (when (search-forward (concat "\f\n" file ",") nil t)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1341 (forward-line 1)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1342 (while (not (or (eobp) (looking-at "\f")))
6245
c05d1d7bc400 (etags-list-tags): Check for explicit tag names.
Roland McGrath <roland@gnu.org>
parents: 6244
diff changeset
1343 (let ((tag (buffer-substring (point)
c05d1d7bc400 (etags-list-tags): Check for explicit tag names.
Roland McGrath <roland@gnu.org>
parents: 6244
diff changeset
1344 (progn (skip-chars-forward "^\177")
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1345 (point))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1346 (props `(action find-tag-other-window mouse-face highlight
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1347 face ,tags-tag-face))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1348 (pt (with-current-buffer standard-output (point))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1349 (when (looking-at "[^\n]+\001")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1350 ;; There is an explicit tag name; use that.
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1351 (setq tag (buffer-substring (1+ (point)) ; skip \177
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1352 (progn (skip-chars-forward "^\001")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1353 (point)))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1354 (princ tag)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1355 (when (= (aref tag 0) ?\() (princ " ...)"))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1356 (add-text-properties pt (with-current-buffer standard-output (point))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1357 (cons 'item (cons tag props)) standard-output))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1358 (terpri)
4940
2f65b0f9c6fc (etags-list-tags): Return t if found the file.
Richard M. Stallman <rms@gnu.org>
parents: 4857
diff changeset
1359 (forward-line 1))
2f65b0f9c6fc (etags-list-tags): Return t if found the file.
Richard M. Stallman <rms@gnu.org>
parents: 4857
diff changeset
1360 t))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1361
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1362 (defmacro tags-with-face (face &rest body)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1363 "Execute BODY, give output to `standard-output' face FACE."
41772
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1364 (let ((pp (make-symbol "start")))
29086
a4b321043588 Fix last change.
Dave Love <fx@gnu.org>
parents: 29080
diff changeset
1365 `(let ((,pp (with-current-buffer standard-output (point))))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1366 ,@body
29086
a4b321043588 Fix last change.
Dave Love <fx@gnu.org>
parents: 29080
diff changeset
1367 (put-text-property ,pp (with-current-buffer standard-output (point))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1368 'face ,face standard-output))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1369
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1370 (defun etags-tags-apropos-additional (regexp)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1371 "Display tags matching REGEXP from `tags-apropos-additional-actions'."
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1372 (with-current-buffer standard-output
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1373 (dolist (oba tags-apropos-additional-actions)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1374 (princ "\n\n")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1375 (tags-with-face 'highlight (princ (car oba)))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1376 (princ":\n\n")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1377 (let* ((props `(action ,(cadr oba) mouse-face highlight face
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1378 ,tags-tag-face))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1379 (beg (point))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1380 (symbs (car (cddr oba)))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1381 (ins-symb (lambda (sy)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1382 (let ((sn (symbol-name sy)))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1383 (when (string-match regexp sn)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1384 (add-text-properties (point)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1385 (progn (princ sy) (point))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1386 (cons 'item (cons sn props)))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1387 (terpri))))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1388 (when (symbolp symbs)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1389 (if (boundp symbs)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1390 (setq symbs (symbol-value symbs))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1391 (insert "symbol `" (symbol-name symbs) "' has no value\n")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1392 (setq symbs nil)))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1393 (if (vectorp symbs)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1394 (mapatoms ins-symb symbs)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1395 (dolist (sy symbs)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1396 (funcall ins-symb (car sy))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1397 (sort-lines nil beg (point))))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1398
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1399 (defun etags-tags-apropos (string)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1400 (when tags-apropos-verbose
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1401 (princ "Tags in file `")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1402 (tags-with-face 'highlight (princ buffer-file-name))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1403 (princ "':\n\n"))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1404 (goto-char 1)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1405 (while (re-search-forward string nil t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1406 (beginning-of-line)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1407 (let ((tag (buffer-substring (point)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1408 (progn (skip-chars-forward "^\177")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1409 (point))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1410 (props `(action find-tag-other-window mouse-face highlight
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1411 face ,tags-tag-face))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1412 (pt (with-current-buffer standard-output (point))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1413 (princ tag)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1414 (when (= (aref tag 0) ?\() (princ " ...)"))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1415 (add-text-properties pt (with-current-buffer standard-output (point))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1416 `(item ,tag ,@props) standard-output))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1417 (terpri)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1418 (forward-line 1))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1419 (when tags-apropos-verbose (princ "\n")))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1420
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1421 (defun etags-tags-table-files ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1422 (let ((files nil)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1423 beg)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1424 (goto-char (point-min))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1425 (while (search-forward "\f\n" nil t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1426 (setq beg (point))
9579
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1427 (end-of-line)
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1428 (skip-chars-backward "^," beg)
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1429 (or (looking-at "include$")
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1430 (setq files (cons (buffer-substring beg (1- (point))) files))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1431 (nreverse files)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1432
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1433 (defun etags-tags-included-tables ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1434 (let ((files nil)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1435 beg)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1436 (goto-char (point-min))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1437 (while (search-forward "\f\n" nil t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1438 (setq beg (point))
9579
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1439 (end-of-line)
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1440 (skip-chars-backward "^," beg)
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1441 (if (looking-at "include$")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1442 ;; Expand in the default-directory of the tags table buffer.
9579
2a5d9c96525f (etags-tags-table-files, etags-tags-included-tables):
Richard M. Stallman <rms@gnu.org>
parents: 9525
diff changeset
1443 (setq files (cons (expand-file-name (buffer-substring beg (1- (point))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1444 files))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1445 (nreverse files)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1446
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1447 ;; Empty tags file support.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1448
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1449 ;; Recognize an empty file and give it local values of the tags table format
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1450 ;; variables which do nothing.
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1451 (defun tags-recognize-empty-tags-table ()
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1452 (and (zerop (buffer-size))
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1453 (mapc (lambda (sym) (set (make-local-variable sym) 'ignore))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1454 '(tags-table-files-function
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1455 tags-completion-table-function
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1456 find-tag-regexp-search-function
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1457 find-tag-search-function
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1458 tags-apropos-function
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1459 tags-included-tables-function))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1460 (set (make-local-variable 'verify-tags-table-function)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1461 (lambda () (zerop (buffer-size))))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1462
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1463 ;; Match qualifier functions for tagnames.
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1464 ;; XXX these functions assume etags file format.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1465
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1466 ;; This might be a neat idea, but it's too hairy at the moment.
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1467 ;;(defmacro tags-with-syntax (&rest body)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1468 ;; `(let ((current (current-buffer))
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1469 ;; (otable (syntax-table))
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1470 ;; (buffer (find-file-noselect (file-of-tag)))
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1471 ;; table)
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1472 ;; (unwind-protect
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1473 ;; (progn
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1474 ;; (set-buffer buffer)
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1475 ;; (setq table (syntax-table))
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1476 ;; (set-buffer current)
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1477 ;; (set-syntax-table table)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1478 ;; ,@body)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1479 ;; (set-syntax-table otable))))
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1480 ;;(put 'tags-with-syntax 'edebug-form-spec '(&rest form))
877
e0dde8b90613 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 852
diff changeset
1481
9021
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1482 ;; t if point is at a tag line that matches TAG exactly.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1483 ;; point should be just after a string that matches TAG.
884
93a935b7a479 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 878
diff changeset
1484 (defun tag-exact-match-p (tag)
4666
674082454a0c (tag-exact-match-p): Return true if TAG is the explicit tag name.
Roland McGrath <roland@gnu.org>
parents: 4661
diff changeset
1485 ;; The match is really exact if there is an explicit tag name.
8081
6099d3d43685 (tag-exact-match-p): Test for point sitting after the explicit tag name
Roland McGrath <roland@gnu.org>
parents: 8040
diff changeset
1486 (or (and (eq (char-after (point)) ?\001)
8082
215cfbab6d72 (tag-exact-match-p): Fix typo in last change.
Roland McGrath <roland@gnu.org>
parents: 8081
diff changeset
1487 (eq (char-after (- (point) (length tag) 1)) ?\177))
8081
6099d3d43685 (tag-exact-match-p): Test for point sitting after the explicit tag name
Roland McGrath <roland@gnu.org>
parents: 8040
diff changeset
1488 ;; We are not on the explicit tag name, but perhaps it follows.
9021
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1489 (looking-at (concat "[^\177\n]*\177" (regexp-quote tag) "\001"))))
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1490
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1491 ;; t if point is at a tag line that matches TAG as a symbol.
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1492 ;; point should be just after a string that matches TAG.
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1493 (defun tag-symbol-match-p (tag)
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1494 (and (looking-at "\\Sw.*\177") (looking-at "\\S_.*\177")
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1495 (save-excursion
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1496 (backward-char (1+ (length tag)))
e0709ca0418a (tag-symbol-match-p): New function.
Roland McGrath <roland@gnu.org>
parents: 9020
diff changeset
1497 (and (looking-at "\\Sw") (looking-at "\\S_")))))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1498
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1499 ;; t if point is at a tag line that matches TAG as a word.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1500 ;; point should be just after a string that matches TAG.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1501 (defun tag-word-match-p (tag)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1502 (and (looking-at "\\b.*\177")
15770
17158dfe7765 (etags-goto-tag-location): New local variable LINE; use it.
Roland McGrath <roland@gnu.org>
parents: 15360
diff changeset
1503 (save-excursion (backward-char (length tag))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1504 (looking-at "\\b"))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1505
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1506 ;; exact file name match, i.e. searched tag must match complete file
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1507 ;; name including directories parts if there are some.
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1508 (defun tag-exact-file-name-match-p (tag)
10661
32beb7b6dbf7 Changes to support filenames as tags too and provided
Richard M. Stallman <rms@gnu.org>
parents: 10458
diff changeset
1509 (and (looking-at ",")
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1510 (save-excursion (backward-char (+ 2 (length tag)))
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1511 (looking-at "\f\n"))))
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1512 ;; file name match as above, but searched tag must match the file
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1513 ;; name not including the directories if there are some.
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1514 (defun tag-file-name-match-p (tag)
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1515 (and (looking-at ",")
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1516 (save-excursion (backward-char (1+ (length tag)))
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1517 (looking-at "/"))))
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1518 ;; this / to detect we are after a directory separator is ok for unix,
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1519 ;; is there a variable that contains the regexp for directory separator
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1520 ;; on whatever operating system ?
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1521 ;; Looks like ms-win will lose here :).
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1522
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1523 ;; partial file name match, i.e. searched tag must match a substring
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1524 ;; of the file name (potentially including a directory separator).
34190
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1525 (defun tag-partial-file-name-match-p (tag)
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1526 (and (looking-at ".*,")
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1527 (save-excursion (beginning-of-line)
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1528 (backward-char 2)
e624fa36b252 (tag-partial-file-name-match-p): New function.
Gerd Moellmann <gerd@gnu.org>
parents: 33418
diff changeset
1529 (looking-at "\f\n"))))
10661
32beb7b6dbf7 Changes to support filenames as tags too and provided
Richard M. Stallman <rms@gnu.org>
parents: 10458
diff changeset
1530
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1531 ;; t if point is in a tag line with a tag containing TAG as a substring.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1532 (defun tag-any-match-p (tag)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1533 (looking-at ".*\177"))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1534
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1535 ;; t if point is at a tag line that matches RE as a regexp.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1536 (defun tag-re-match-p (re)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1537 (save-excursion
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1538 (beginning-of-line)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1539 (let ((bol (point)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1540 (and (search-forward "\177" (save-excursion (end-of-line) (point)) t)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1541 (re-search-backward re bol t)))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1542
23415
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1543 (defcustom tags-loop-revert-buffers nil
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1544 "*Non-nil means tags-scanning loops should offer to reread changed files.
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1545 These loops normally read each file into Emacs, but when a file
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1546 is already visited, they use the existing buffer.
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1547 When this flag is non-nil, they offer to revert the existing buffer
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1548 in the case where the file has changed since you visited it."
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1549 :type 'boolean
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1550 :group 'etags)
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1551
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1552 ;;;###autoload
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1553 (defun next-file (&optional initialize novisit)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1554 "Select next file among files in current tags table.
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1555
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1556 A first argument of t (prefix arg, if interactive) initializes to the
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1557 beginning of the list of files in the tags table. If the argument is
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1558 neither nil nor t, it is evalled to initialize the list of files.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1559
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1560 Non-nil second argument NOVISIT means use a temporary buffer
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1561 to save time and avoid uninteresting warnings.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1562
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1563 Value is nil if the file was already visited;
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1564 if the file was newly read in, the value is the filename."
13576
38c6a718abb8 (next-file): Make interactive arg t if had any prefix arg.
Richard M. Stallman <rms@gnu.org>
parents: 13341
diff changeset
1565 ;; Make the interactive arg t if there was any prefix arg.
38c6a718abb8 (next-file): Make interactive arg t if had any prefix arg.
Richard M. Stallman <rms@gnu.org>
parents: 13341
diff changeset
1566 (interactive (list (if current-prefix-arg t)))
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1567 (cond ((not initialize)
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1568 ;; Not the first run.
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1569 )
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1570 ((eq initialize t)
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1571 ;; Initialize the list from the tags table.
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1572 (save-excursion
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1573 ;; Visit the tags table buffer to get its list of files.
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1574 (visit-tags-table-buffer)
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1575 ;; Copy the list so we can setcdr below, and expand the file
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1576 ;; names while we are at it, in this buffer's default directory.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1577 (setq next-file-list (mapcar 'expand-file-name (tags-table-files)))
9631
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1578 ;; Iterate over all the tags table files, collecting
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1579 ;; a complete list of referenced file names.
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1580 (while (visit-tags-table-buffer t)
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1581 ;; Find the tail of the working list and chain on the new
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1582 ;; sublist for this tags table.
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1583 (let ((tail next-file-list))
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1584 (while (cdr tail)
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1585 (setq tail (cdr tail)))
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1586 ;; Use a copy so the next loop iteration will not modify the
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1587 ;; list later returned by (tags-table-files).
11316
72f527d22fe1 (next-file): Handle empty list returned by (tags-table-files).
Roland McGrath <roland@gnu.org>
parents: 10680
diff changeset
1588 (if tail
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1589 (setcdr tail (mapcar 'expand-file-name (tags-table-files)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1590 (setq next-file-list (mapcar 'expand-file-name
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1591 (tags-table-files))))))))
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1592 (t
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1593 ;; Initialize the list by evalling the argument.
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1594 (setq next-file-list (eval initialize))))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1595 (unless next-file-list
9631
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1596 (and novisit
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1597 (get-buffer " *next-file*")
a5bd0b6b080e (next-file): Initialize next-file-list all at once from all tables.
Roland McGrath <roland@gnu.org>
parents: 9579
diff changeset
1598 (kill-buffer " *next-file*"))
18623
fc78e7f26a64 (next-file, tags-loop-scan): Fix error message.
Richard M. Stallman <rms@gnu.org>
parents: 18324
diff changeset
1599 (error "All files processed"))
12942
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1600 (let* ((next (car next-file-list))
23415
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1601 (buffer (get-file-buffer next))
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1602 (new (not buffer)))
12942
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1603 ;; Advance the list before trying to find the file.
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1604 ;; If we get an error finding the file, don't get stuck on it.
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1605 (setq next-file-list (cdr next-file-list))
23415
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1606 ;; Optionally offer to revert buffers
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1607 ;; if the files have changed on disk.
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1608 (and buffer tags-loop-revert-buffers
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1609 (not (verify-visited-file-modtime buffer))
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1610 (with-current-buffer buffer
b511a32c37fd (tags-loop-revert-buffers): New variable.
Richard M. Stallman <rms@gnu.org>
parents: 23377
diff changeset
1611 (revert-buffer t)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1612 (if (not (and new novisit))
12942
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1613 (set-buffer (find-file-noselect next novisit))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1614 ;; Like find-file, but avoids random warning messages.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1615 (set-buffer (get-buffer-create " *next-file*"))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1616 (kill-all-local-variables)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1617 (erase-buffer)
12942
3685b0e52d2a (next-file): Advance next-file-list before finding the file named in its
Roland McGrath <roland@gnu.org>
parents: 11792
diff changeset
1618 (setq new next)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1619 (insert-file-contents new nil))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1620 new))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1621
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1622 (defvar tags-loop-operate nil
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1623 "Form for `tags-loop-continue' to eval to change one file.")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1624
1808
60685747963c (tags-loop-scan): Set default value to an error form.
Roland McGrath <roland@gnu.org>
parents: 1807
diff changeset
1625 (defvar tags-loop-scan
14420
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
1626 '(error "%s"
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
1627 (substitute-command-keys
18623
fc78e7f26a64 (next-file, tags-loop-scan): Fix error message.
Richard M. Stallman <rms@gnu.org>
parents: 18324
diff changeset
1628 "No \\[tags-search] or \\[tags-query-replace] in progress"))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1629 "Form for `tags-loop-continue' to eval to scan one file.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1630 If it returns non-nil, this file needs processing by evalling
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1631 \`tags-loop-operate'. Otherwise, move on to the next file.")
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1632
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1633 (defun tags-loop-eval (form)
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1634 "Evaluate FORM and return its result.
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1635 Bind `case-fold-search' during the evaluation, depending on the value of
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1636 `tags-case-fold-search'."
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1637 (let ((case-fold-search (if (memq tags-case-fold-search '(t nil))
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1638 tags-case-fold-search
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1639 case-fold-search)))
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1640 (eval form)))
36736
2eea125a1272 2001-03-12 Philippe Waroquiers <wao@gull.tact.cfmu.eurocontrol.be>
Francesco Potortì <pot@gnu.org>
parents: 35961
diff changeset
1641
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1642
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
1643 ;;;###autoload
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1644 (defun tags-loop-continue (&optional first-time)
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1645 "Continue last \\[tags-search] or \\[tags-query-replace] command.
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1646 Used noninteractively with non-nil argument to begin such a command (the
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1647 argument is passed to `next-file', which see).
11792
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1648
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1649 Two variables control the processing we do on each file: the value of
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1650 `tags-loop-scan' is a form to be executed on each file to see if it is
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1651 interesting (it returns non-nil if so) and `tags-loop-operate' is a form to
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1652 evaluate to operate on an interesting file. If the latter evaluates to
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1653 nil, we exit; otherwise we scan the next file."
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1654 (interactive)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1655 (let (new
25438
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1656 ;; Non-nil means we have finished one file
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1657 ;; and should not scan it again.
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1658 file-finished
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1659 original-point
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1660 (messaged nil))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1661 (while
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1662 (progn
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1663 ;; Scan files quickly for the first or next interesting one.
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1664 ;; This starts at point in the current buffer.
25438
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1665 (while (or first-time file-finished
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1666 (save-restriction
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1667 (widen)
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1668 (not (tags-loop-eval tags-loop-scan))))
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1669 ;; If nothing was found in the previous file, and
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1670 ;; that file isn't in a temp buffer, restore point to
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1671 ;; where it was.
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1672 (when original-point
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1673 (goto-char original-point))
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1674
25438
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1675 (setq file-finished nil)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1676 (setq new (next-file first-time t))
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1677
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1678 ;; If NEW is non-nil, we got a temp buffer,
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1679 ;; and NEW is the file name.
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1680 (when (or messaged
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1681 (and (not first-time)
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1682 (> baud-rate search-slow-speed)
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1683 (setq messaged t)))
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1684 (message "Scanning file %s..." (or new buffer-file-name)))
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1685
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1686 (setq first-time nil)
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1687 (setq original-point (if new nil (point)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1688 (goto-char (point-min)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1689
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1690 ;; If we visited it in a temp buffer, visit it now for real.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1691 (if new
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1692 (let ((pos (point)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1693 (erase-buffer)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1694 (set-buffer (find-file-noselect new))
11792
4284a0c7971a (tags-loop-continue): Doc fix.
Roland McGrath <roland@gnu.org>
parents: 11482
diff changeset
1695 (setq new nil) ;No longer in a temp buffer.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1696 (widen)
36748
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1697 (goto-char pos))
1e71d38a27df (tags-loop-continue): Don't change point in a
Gerd Moellmann <gerd@gnu.org>
parents: 36736
diff changeset
1698 (push-mark original-point t))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1699
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1700 (switch-to-buffer (current-buffer))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1701
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1702 ;; Now operate on the file.
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1703 ;; If value is non-nil, continue to scan the next file.
28243
9669a6691caa (tags-case-fold-search): New user-option.
Gerd Moellmann <gerd@gnu.org>
parents: 26720
diff changeset
1704 (tags-loop-eval tags-loop-operate))
25438
4868ac7f6a3f (tags-loop-continue): After tags-loop-operate returns, force skip to next file.
Richard M. Stallman <rms@gnu.org>
parents: 25278
diff changeset
1705 (setq file-finished t))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1706 (and messaged
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1707 (null tags-loop-operate)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1708 (message "Scanning file %s...found" buffer-file-name))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1709 ;;;###autoload (define-key esc-map "," 'tags-loop-continue)
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1710
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
1711 ;;;###autoload
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1712 (defun tags-search (regexp &optional file-list-form)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1713 "Search through all files listed in tags table for match for REGEXP.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1714 Stops when a match is found.
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1715 To continue searching for next match, use command \\[tags-loop-continue].
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1716
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1717 See documentation of variable `tags-file-name'."
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1718 (interactive "sTags search (regexp): ")
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1719 (if (and (equal regexp "")
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1720 (eq (car tags-loop-scan) 're-search-forward)
1696
cceb5375ce40 Many comments added and docstrings fixed.
Roland McGrath <roland@gnu.org>
parents: 1555
diff changeset
1721 (null tags-loop-operate))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1722 ;; Continue last tags-search as if by M-,.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1723 (tags-loop-continue nil)
41772
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1724 (setq tags-loop-scan `(re-search-forward ',regexp nil t)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1725 tags-loop-operate nil)
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1726 (tags-loop-continue (or file-list-form t))))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1727
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
1728 ;;;###autoload
29730
8b7b0c7c65db (tags-query-replace): Put new parameters
Andreas Schwab <schwab@suse.de>
parents: 29086
diff changeset
1729 (defun tags-query-replace (from to &optional delimited file-list-form start end)
32311
035ce2227d76 Docstring fixes.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 29730
diff changeset
1730 "`Query-replace-regexp' FROM with TO through all files listed in tags table.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1731 Third arg DELIMITED (prefix arg) means replace only word-delimited matches.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1732 If you exit (\\[keyboard-quit] or ESC), you can resume the query-replace
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1733 with the command \\[tags-loop-continue].
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1734
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1735 See documentation of variable `tags-file-name'."
9941
6d82f17895cf (tags-query-replace): Use query-replace-read-args in interactive spec.
Roland McGrath <roland@gnu.org>
parents: 9928
diff changeset
1736 (interactive (query-replace-read-args "Tags query replace (regexp)" t))
41772
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1737 (setq tags-loop-scan `(let ,(unless (equal from (downcase from))
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1738 '((case-fold-search nil)))
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1739 (if (re-search-forward ',from nil t)
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1740 ;; When we find a match, move back
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1741 ;; to the beginning of it so perform-replace
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1742 ;; will see it.
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1743 (goto-char (match-beginning 0))))
647a7868ae38 (tags-with-face): Use make-symbol.
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 40309
diff changeset
1744 tags-loop-operate `(perform-replace ',from ',to t t ',delimited))
4661
8ca17ed2aeb8 (next-file): If arg is neither t nor nil, then eval it to return initial
Roland McGrath <roland@gnu.org>
parents: 4486
diff changeset
1745 (tags-loop-continue (or file-list-form t)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1746
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1747 (defun tags-complete-tags-table-file (string predicate what)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1748 (save-excursion
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1749 ;; If we need to ask for the tag table, allow that.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1750 (let ((enable-recursive-minibuffers t))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1751 (visit-tags-table-buffer))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1752 (if (eq what t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1753 (all-completions string (mapcar 'list (tags-table-files))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1754 predicate)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1755 (try-completion string (mapcar 'list (tags-table-files))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1756 predicate))))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1757
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1758 ;;;###autoload
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1759 (defun list-tags (file &optional next-match)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1760 "Display list of tags in file FILE.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1761 This searches only the first table in the list, and no included tables.
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1762 FILE should be as it appeared in the `etags' command, usually without a
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1763 directory specification."
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1764 (interactive (list (completing-read "List tags in file: "
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1765 'tags-complete-tags-table-file
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1766 nil t nil)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1767 (with-output-to-temp-buffer "*Tags List*"
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1768 (princ "Tags in file `")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1769 (tags-with-face 'highlight (princ file))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1770 (princ "':\n\n")
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1771 (save-excursion
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1772 (let ((first-time t)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1773 (gotany nil))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1774 (while (visit-tags-table-buffer (not first-time))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1775 (setq first-time nil)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1776 (if (funcall list-tags-function file)
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1777 (setq gotany t)))
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1778 (or gotany
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1779 (error "File %s not in current tags tables" file)))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1780 (with-current-buffer "*Tags List*"
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1781 (setq buffer-read-only t)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1782 (apropos-mode)))
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1783
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
1784 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1785 (defun tags-apropos (regexp)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1786 "Display list of all tags in tags table REGEXP matches."
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1787 (interactive "sTags apropos (regexp): ")
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1788 (with-output-to-temp-buffer "*Tags List*"
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1789 (princ "Click mouse-2 to follow tags.\n\nTags matching regexp `")
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1790 (tags-with-face 'highlight (princ regexp))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1791 (princ "':\n\n")
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1792 (save-excursion
1149
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
1793 (let ((first-time t))
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
1794 (while (visit-tags-table-buffer (not first-time))
283fa748ba99 *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 1138
diff changeset
1795 (setq first-time nil)
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1796 (funcall tags-apropos-function regexp))))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1797 (etags-tags-apropos-additional regexp))
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1798 (with-current-buffer "*Tags List*"
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1799 (setq buffer-read-only t)
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1800 (apropos-mode)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1801
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1802 ;; XXX Kludge interface.
342
8bfd98a0dcdd Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
1803
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1804 ;; XXX If a file is in multiple tables, selection may get the wrong one.
804
33aaf4b71a1d *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 800
diff changeset
1805 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1806 (defun select-tags-table ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1807 "Select a tags table file from a menu of those you have already used.
8456
2ca3b54b45b1 (select-tags-table): Doc fix.
Richard M. Stallman <rms@gnu.org>
parents: 8297
diff changeset
1808 The list of tags tables to select from is stored in `tags-table-set-list';
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1809 see the doc of that variable if you want to add names to the list."
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1810 (interactive)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1811 (pop-to-buffer "*Tags Table List*")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1812 (setq buffer-read-only nil)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1813 (erase-buffer)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1814 (let ((set-list tags-table-set-list)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1815 (desired-point nil))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1816 (when tags-table-list
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1817 (setq desired-point (point-marker))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1818 (princ tags-table-list (current-buffer))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1819 (insert "\C-m")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1820 (prin1 (car tags-table-list) (current-buffer)) ;invisible
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1821 (insert "\n"))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1822 (while set-list
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1823 (unless (eq (car set-list) tags-table-list)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1824 (princ (car set-list) (current-buffer))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1825 (insert "\C-m")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1826 (prin1 (car (car set-list)) (current-buffer)) ;invisible
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1827 (insert "\n"))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1828 (setq set-list (cdr set-list)))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1829 (when tags-file-name
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1830 (or desired-point
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1831 (setq desired-point (point-marker)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1832 (insert tags-file-name "\C-m")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1833 (prin1 tags-file-name (current-buffer)) ;invisible
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1834 (insert "\n"))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1835 (setq set-list (delete tags-file-name
13341
c26492df6218 (select-tags-table): Don't modify the value of tags-table-list.
Richard M. Stallman <rms@gnu.org>
parents: 13165
diff changeset
1836 (apply 'nconc (cons (copy-sequence tags-table-list)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1837 (mapcar 'copy-sequence
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1838 tags-table-set-list)))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1839 (while set-list
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1840 (insert (car set-list) "\C-m")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1841 (prin1 (car set-list) (current-buffer)) ;invisible
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1842 (insert "\n")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1843 (setq set-list (delete (car set-list) set-list)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1844 (goto-char 1)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1845 (insert-before-markers
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1846 "Type `t' to select a tags table or set of tags tables:\n\n")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1847 (if desired-point
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1848 (goto-char desired-point))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1849 (set-window-start (selected-window) 1 t))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1850 (set-buffer-modified-p nil)
7645
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1851 (select-tags-table-mode))
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1852
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1853 (defvar select-tags-table-mode-map)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1854 (let ((map (make-sparse-keymap)))
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1855 (define-key map "t" 'select-tags-table-select)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1856 (define-key map " " 'next-line)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1857 (define-key map "\^?" 'previous-line)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1858 (define-key map "n" 'next-line)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1859 (define-key map "p" 'previous-line)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1860 (define-key map "q" 'select-tags-table-quit)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1861 (setq select-tags-table-mode-map map))
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1862
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1863 (defun select-tags-table-mode ()
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1864 "Major mode for choosing a current tags table among those already loaded.
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1865
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1866 \\{select-tags-table-mode-map}"
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1867 (interactive)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1868 (kill-all-local-variables)
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1869 (setq buffer-read-only t
7645
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1870 major-mode 'select-tags-table-mode
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1871 mode-name "Select Tags Table")
7645
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1872 (use-local-map select-tags-table-mode-map)
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1873 (setq selective-display t
202339c81fa4 (select-tags-table-mode): New function, a major mode.
Richard M. Stallman <rms@gnu.org>
parents: 7287
diff changeset
1874 selective-display-ellipses nil))
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1875
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1876 (defun select-tags-table-select ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1877 "Select the tags table named on this line."
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1878 (interactive)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1879 (search-forward "\C-m")
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1880 (let ((name (read (current-buffer))))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1881 (visit-tags-table name)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1882 (select-tags-table-quit)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1883 (message "Tags table now %s" name)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1884
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1885 (defun select-tags-table-quit ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1886 "Kill the buffer and delete the selected window."
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1887 (interactive)
21097
eb3dc7ea93c2 (select-tags-table-quit): Use quit-window.
Richard M. Stallman <rms@gnu.org>
parents: 20836
diff changeset
1888 (quit-window t (selected-window)))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1889
37963
c801f5d17c89 (tags-compression-info-list): Fix docstring
Stefan Monnier <monnier@iro.umontreal.ca>
parents: 36748
diff changeset
1890 ;; Note, there is another definition of this function in bindings.el.
360
066d9d0dd901 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 342
diff changeset
1891 ;;;###autoload
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1892 (defun complete-tag ()
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1893 "Perform tags completion on the text around point.
13731
f9bffca29486 Fix completely broken changes of 4 Feb 95 by brat@htilbom.ernet.in,
Roland McGrath <roland@gnu.org>
parents: 13576
diff changeset
1894 Completes to the set of names listed in the current tags table.
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1895 The string to complete is chosen in the same way as the default
981
49a539ef702f *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 895
diff changeset
1896 for \\[find-tag] (which see)."
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1897 (interactive)
981
49a539ef702f *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 895
diff changeset
1898 (or tags-table-list
49a539ef702f *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 895
diff changeset
1899 tags-file-name
14420
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
1900 (error "%s"
071f9717597f (visit-tags-table-buffer, tags-loop-scan, complete-tag): Fix error format
Karl Heuer <kwzh@gnu.org>
parents: 14169
diff changeset
1901 (substitute-command-keys
18623
fc78e7f26a64 (next-file, tags-loop-scan): Fix error message.
Richard M. Stallman <rms@gnu.org>
parents: 18324
diff changeset
1902 "No tags table loaded; try \\[visit-tags-table]")))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1903 (let ((pattern (funcall (or find-tag-default-function
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1904 (get major-mode 'find-tag-default-function)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1905 'find-tag-default)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1906 beg
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1907 completion)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1908 (or pattern
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1909 (error "Nothing to complete"))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1910 (search-backward pattern)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1911 (setq beg (point))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1912 (forward-char (length pattern))
26720
32e893b03ad2 (etags-tags-completion-table): Modified the
Gerd Moellmann <gerd@gnu.org>
parents: 25438
diff changeset
1913 (setq completion (tags-complete-tag pattern nil nil))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1914 (cond ((eq completion t))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1915 ((null completion)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1916 (message "Can't find completion for \"%s\"" pattern)
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1917 (ding))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1918 ((not (string= pattern completion))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1919 (delete-region beg (point))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1920 (insert completion))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1921 (t
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1922 (message "Making completion list...")
7843
38d89820ab47 (complete-tag): Likewise.
Richard M. Stallman <rms@gnu.org>
parents: 7645
diff changeset
1923 (with-output-to-temp-buffer "*Completions*"
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1924 (display-completion-list
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1925 (all-completions pattern 'tags-complete-tag nil)))
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1926 (message "Making completion list...%s" "done")))))
29080
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1927
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1928 (dolist (x '("^No tags table in use; use .* to select one$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1929 "^There is no default tag$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1930 "^No previous tag locations$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1931 "^File .* is not a valid tags table$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1932 "^No \\(more \\|\\)tags \\(matching\\|containing\\) "
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1933 "^Rerun etags: `.*' not found in "
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1934 "^All files processed$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1935 "^No .* or .* in progress$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1936 "^File .* not in current tags tables$"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1937 "^No tags table loaded"
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1938 "^Nothing to complete$"))
3b2040b6030a Add to debug-ignored-errors.
Dave Love <fx@gnu.org>
parents: 28738
diff changeset
1939 (add-to-list 'debug-ignored-errors x))
799
f9874f408ddf *** empty log message ***
Roland McGrath <roland@gnu.org>
parents: 747
diff changeset
1940
584
4cd7543be581 *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 474
diff changeset
1941 (provide 'etags)
807
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
1942
4f28bd14272c *** empty log message ***
Eric S. Raymond <esr@snark.thyrsus.com>
parents: 804
diff changeset
1943 ;;; etags.el ends here