%tag-file - Tags file name
%tag-template - Tag file search string
%tag-file "fileName"
%tag-template "string"
These two variables need to be defined for find-tag(2) to work, they define the information required to locate tag references.
%tag-file is the name of the tag file to be used, usually set to "tags". %tag-template is a regular expression search string used to identify tags in a tag file. For example, a tag usually consists of a name "%[^\t]" followed by a tab "\t" followed by the file name that contains the function "%[^\t]" followed by another tab, followed by the string "/^" and the line search string "\%[^\n]\n", i.e.
set-variable %tag-template "%[^\t]\t%[^\t]\t/^\%[^\n]\n"
This would match a vi(1) tag string definition, as created by the UNIX utility ctags(1). The tags file typically contains entries such as:-
$auto-time m5var000.5 /^.XI $auto-time - "Automatic buffer"/ $buffer-bhook m5var002.5 /^.XI $buffer-bhook - "Buffer macro"/ $buffer-ehook m5var002.5 /^.XI $buffer-ehook - "Buffer macro"/
The tag-template definition is modified to match the output of the ctags(1) utility. The format of the tags file may differ from platform to platform, typically the differences are encountered in the line contents field which is usually defined as /^ .... "/ but may be defined as /^ .... $/. The variable fields are expected to be in conventional order of label, filename and lineText.
Note that GNU Emacs uses it's own tag file format generated by etags(1) which does not contain the appropriate information to drive the MicroEmacs '99 find-tag command.
find-tag(2), vi(1), ctags(1).
(c) Copyright JASSPA 1999
Last Modified: 1998/09/03
Generated On: 1999/07/16