Manual page for PTAGS(1)
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
- -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 ALSO
ctags(1), ctree(1)
Created by unroff & hp-tools.
© somebody (See intro for details). All Rights Reserved.
Last modified 11/5/97