PTAGS(1)PTAGS(1)NAMEptags - print tag information
SYNOPSISptags [-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-a Print all occurrences of the given object.
-f Print the file in which each object is defined.
-l Print the location (search pattern or line number) of each
object definition.
-s Print the size of each object (in lines).
-t Print the type of each object (function, macro, global, etc).
-c Print the caller list for each object.
-e Print the callee list for each object.
-q Suppress error messages.
-Q Surround locations (search patterns) and callee/caller lists
with single quotes '...', to simplify the use of ptags in shell
scripts.
-S Attempt to locate and print the source text for the given
object.
-v Print ``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
tags default tags file searched
SEE ALSOctags(1), ctree(1)NeXT Computer, Inc. February 17, 1989 PTAGS(1)