%tag-file - Tags file name
%tag-template - Tag file search string
%tag-option - Tag file search option
The %tag-file and %tag-template variables must 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 search string and end of line "%[^\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 / .... / for a forward search tag and ? .... ? for a reverse search tag. Note that a tag's search string typically starts with the character '^' and ends with '$' which indicate the start and end of the line. The variable fields are expected to be in conventional order of label, filename and lineText.
%tag-option is a user defined variable that modifies the behavior of find-tag(2). This is defined as a string, where each character identifies an option, when undefined then default behavior is assumed. The options are defined as:-
m - Enable multiple tags support
r - recursive tags file
c - Continue recursive tag search
Modifications to this variable should be made in the user.emf file, e.g. To enable multi recursive ascent tag searching define:-
set-variable %tag-option "mrc"
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 '06 find-tag command.
The above settings should support the extended version 2 tag file format which has an extra tag type field at the end of each line.
Copyright (c) 1998-2006 JASSPA
Last Modified: 2002/01/11
Generated On: 2006/10/07