Scroll to navigation

tags(3erl) Erlang Module Definition tags(3erl)

NAME

tags - Generate Emacs TAGS file from Erlang source files

DESCRIPTION

A TAGS file is used by Emacs to find function and variable definitions in any source file in large projects. This module can generate a TAGS file from Erlang source files. It recognises functions, records, and macro definitions.

EXPORTS


file(File) -> ok | error



file(File, Options) -> ok | error


Types:

File = file:filename()
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Create a TAGS file for the file File.


files(FileList) -> ok | error



files(FileList, Options) -> ok | error


Types:

FileList = [file:filename()]
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Create a TAGS file for the files in the list FileList.


dir(Dir) -> ok | error



dir(Dir, Options) -> ok | error


Types:

Dir = file:filename()
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Create a TAGS file for all files in directory Dir.


dirs(DirList) -> ok | error



dirs(DirList, Options) -> ok | error


Types:

DirList = [file:filename()]
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Create a TAGS file for all files in any directory in DirList.


subdir(Dir) -> ok | error



subdir(Dir, Options) -> ok | error


Types:

Dir = file:filename()
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Descend recursively down the directory Dir and create a TAGS file based on all files found.


subdirs(DirList) -> ok | error



subdirs(DirList, Options) -> ok | error


Types:

DirList = [file:filename()]
Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Descend recursively down all the directories in DirList and create a TAGS file based on all files found.


root() -> ok | error



root(Options) -> ok | error


Types:

Options = [option()]
option() = 

{outfile, NameOfTAGSFile :: file:filename()} |
{outdir, NameOfDirectory :: file:filename()}

Create a TAGS file covering all files in the Erlang distribution.

OPTIONS

The functions above have an optional argument, Options. It is a list which can contain the following elements:

*
{outfile, NameOfTAGSFile} Create a TAGS file named NameOfTAGSFile.
*
{outdir, NameOfDirectory} Create a file named TAGS in the directory NameOfDirectory.

The default behaviour is to create a file named TAGS in the current directory.

EXAMPLES

*
tags:root([{outfile, "root.TAGS"}]).

This command will create a file named root.TAGS in the current directory. The file will contain references to all Erlang source files in the Erlang distribution.

*
tags:files(["foo.erl", "bar.erl", "baz.erl"], [{outdir, "../projectdir"}]).

Here we create file named TAGS placed it in the directory ../projectdir. The file contains information about the functions, records, and macro definitions of the three files.

SEE ALSO

*
Richard M. Stallman. GNU Emacs Manual, chapter "Editing Programs", section "Tag Tables". Free Software Foundation, 1995.
*
Anders Lindgren. The Erlang editing mode for Emacs. Ericsson, 1998.
tools 3.5 Ericsson AB