PTAGS

Section: User Commands (1)
Updated: February 17, 1989
Index Return to Main Contents
 

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

-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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
DIAGNOSTICS
FILES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 17:19:22 GMT, March 25, 2025