BSD 4_3 release

[unix-history] / usr / man / man1 / ctags.1

diff --git a/usr/man/man1/ctags.1 b/usr/man/man1/ctags.1
index 487090d..ad3ef0c 100644 (file)
--- a/usr/man/man1/ctags.1
+++ b/usr/man/man1/ctags.1
@@ -1,4 +1,10 @@
-.TH CTAGS 1 "25 August 1982"
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)ctags.1     6.2 (Berkeley) 5/30/85
+.\"
+.TH CTAGS 1 "May 30, 1985"

 .UC 4
 .SH NAME
 ctags \- create a tags file
 .UC 4
 .SH NAME
 ctags \- create a tags file


@@ -6,13 +12,16 @@ ctags \- create a tags file
 .B ctags
 [ 
 .B \-BFatuwvx
 .B ctags
 [ 
 .B \-BFatuwvx

+] [
+.B \-f 
+.I tagsfile

 ]
 name ...
 .SH DESCRIPTION
 .I Ctags
 makes a tags file for
 .IR ex (1)
 ]
 name ...
 .SH DESCRIPTION
 .I Ctags
 makes a tags file for
 .IR ex (1)

-from the specified C, Pascal and Fortran sources.
+from the specified C, Pascal, Fortran, YACC, lex, and lisp sources.

 A tags file gives the locations of specified objects (in this case
 functions and typedefs) in a group of files.  Each line of the tags
 file contains the object name, the file in which it is defined, and
 A tags file gives the locations of specified objects (in this case
 functions and typedefs) in a group of files.  Each line of the tags
 file contains the object name, the file in which it is defined, and


@@ -52,13 +61,29 @@ Sample use:
        vgrind \-x index
 .fi
 .PP
        vgrind \-x index
 .fi
 .PP

-Files whose name ends in 
+Normally 
+.I ctags
+places the tag descriptions in a file called
+.IR tags ;
+this may be overridden with the
+.B \-f
+option.
+.PP
+Files whose names end in 

 .B \.c
 or
 .B \.h
 are assumed to be C source files and are searched for C routine and
 macro definitions.
 .B \.c
 or
 .B \.h
 are assumed to be C source files and are searched for C routine and
 macro definitions.

-Others are first examined to see if they contain any Pascal or
+Files whose names end in
+.B \.y
+are assumed to be YACC source files.
+Files whose names end in
+.B \.l
+are assumed to be either lisp files
+if their first non-blank character is `;', `(', or `[',
+or lex files otherwise.
+Other files are first examined to see if they contain any Pascal or

 Fortran routine definitions; if not, they are processed again
 looking for C definitions.
 .PP
 Fortran routine definitions; if not, they are processed again
 looking for C definitions.
 .PP


@@ -125,3 +150,4 @@ Does not know about #ifdefs.
 Should know about Pascal types.
 Relies on the input being well formed to detect typedefs.
 Use of -tx shows only the last line of typedefs.
 Should know about Pascal types.
 Relies on the input being well formed to detect typedefs.
 Use of -tx shows only the last line of typedefs.

+