ctags(3f)

NAME

ctags - Generate a C tags file

SYNOPSIS

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

DESCRIPTION

The start-up file ctags.emf may be invoked from the command line to generate a tags file for C and C++ source and header files.

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. This is a good alternative on Microsoft platforms where a utility such as ctags(1) is not typically available. 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 C and C++ source and header 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.

The generated tags file includes #define and C++ class names.

NOTES

This function is invoked from menu

Tools -> C Tools -> Create Tags File

when the user requests a tags file to be generated.

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

The following variables are set within "ctags.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 ":*.[cC]:*.cpp:*.cc:*.h:*.hpp:".

%tag-ignoredir


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

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

SEE ALSO

find-tag(2), start-up(3), c(9).

(c) Copyright JASSPA 1999
Last Modified: 1999/11/09
Generated On: 1999/12/01