emftags(3f)

NAME

emftags - Generate a MicroEmacs macro tags file

SYNOPSIS

me "@emftags" [-v%tag-option=<flags>] [files]

DESCRIPTION

The start-up file emftags.emf may be invoked from the command line to generate a tags file for MicroEmacs macro files, emf(8).

Given a list of files a tags file tags is generated in the current directory, which may be used by the find-tag(2) command. If no files are specified the default file list is "./", i.e. process the current directory. If a directory name is given (such as the default "./") all MicroEmacs macro files within the directory will be processed.

The value of variable %tag-option is used to control the tag generation process, its value <flags> can contain any number of the following flags:

a


Append new tags to the existing tag file, note that if also using flag 'm' multiple 'tags' to the same item may be created.

m


Enable multiple tags. This enables the existence of 2 tags with the same tag name, but typically with different locations. See help on find-tag(2) for more information on multiple tag support.

r


Enables recursive mode, any sub-directory found within any given directories will also be processed.

NOTES

This function is invoked from menu

Tools -> Emf Tools -> Create Tags File

when the user requests a tags file to be generated.

The user setup file "myemftags.emf" is executed by emftags during start-up, this file can be used to over-ride any of the emftags configuration variables (see below).

The following variables are set within "emftags.emf" and are used to control the process:

%tag-option


Tags options flag, default value is "". See above for more information.

%tag-filemask


A list of source file masks to be processed when a directory is given, default value is ":*.emf:".

%tag-ignoredir


A list of directories to be ignored when recursive option is used, default value is ":SCCS/:CVS/:.git/:.svn/:".

These variables can be changed using the -v command-line option or via the "myemftags.emf" file

SEE ALSO

find-tag(2), start-up(3), emf(8).

Ref: emftags(3f) File: m3fcl006.3 Date: 2025/07/18

(c) Copyright JASSPA 2026