NAME

ptags − print tag information

SYNOPSIS

ptags [-aflstceqQSv] [-T tagpath] [-N number] [object ...]

DESCRIPTION

The ptags command prints information about objects indexed in a tags file created by ctags(1).  If no objects are given as arguments they are read from stdin.  The -flstce options specify which fields to print; if none of these options are given, the entire entry (file, location, size, type, caller list, callee list) is printed.  A string beginning with a slash, /words ..., may be appended to an object name, causing only those index entries for object which also reference words to be printed.  For instance,

ptags new/timer.c

attempts to print the tag information for new found in the file timer.c. 

OPTIONS

-aPrint all occurrences of the given object. 

-fPrint the file in which each object is defined. 

-lPrint the location (search pattern or line number) of each object definition. 

-sPrint the size of each object (in lines). 

-tPrint the type of each object (function, macro, global, etc). 

-cPrint the caller list for each object. 

-ePrint the callee list for each object. 

-qSuppress error messages. 

-QSurround locations (search patterns) and callee/caller lists with single quotes ’...’, to simplify the use of ptags in shell scripts. 

-SAttempt to locate and print the source text for the given object. 

-vPrint “tagfile: object:” before the fields for each object. 

-T tagpath
Set the path of tag files searched to tagpath (the default is $TAGS).  Giving the -T option more than once appends to the path (i.e., -T"a b" is equivalent to -T a -T b). 

-N number
If there’s more than one occurrence of the given object, print at most number of them (default is 1). 

DIAGNOSTICS

Exits with status 1 if a tag was not found. 

FILES

tagsdefault tags file searched

SEE ALSO

ctags(1), ctree(1)

NeXT, Inc.  —  February 17, 1989