diff options
author | Kiyoshi Aman <kiyoshi.aman+adelie@gmail.com> | 2019-05-28 19:32:52 -0500 |
---|---|---|
committer | Kiyoshi Aman <kiyoshi.aman+adelie@gmail.com> | 2019-05-28 19:32:52 -0500 |
commit | c5f26b5b2ab1271e12dd08f5fe69ce96c8d25cdb (patch) | |
tree | 87f279ae840ec3090ede464340b75e68d891430c /usr.bin/ctags/ctags.1 | |
parent | 915f92f0eb78b1f87f9ea604e5466b50fa05f315 (diff) | |
download | userland-c5f26b5b2ab1271e12dd08f5fe69ce96c8d25cdb.tar.gz userland-c5f26b5b2ab1271e12dd08f5fe69ce96c8d25cdb.tar.bz2 userland-c5f26b5b2ab1271e12dd08f5fe69ce96c8d25cdb.tar.xz userland-c5f26b5b2ab1271e12dd08f5fe69ce96c8d25cdb.zip |
usr.bin/ctags: remove, handled separately already
Diffstat (limited to 'usr.bin/ctags/ctags.1')
-rw-r--r-- | usr.bin/ctags/ctags.1 | 225 |
1 files changed, 0 insertions, 225 deletions
diff --git a/usr.bin/ctags/ctags.1 b/usr.bin/ctags/ctags.1 deleted file mode 100644 index 1dd72e8..0000000 --- a/usr.bin/ctags/ctags.1 +++ /dev/null @@ -1,225 +0,0 @@ -.\" $NetBSD: ctags.1,v 1.18 2017/07/03 21:34:19 wiz Exp $ -.\" -.\" Copyright (c) 1987, 1990, 1993 -.\" The Regents of the University of California. All rights reserved. -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. Neither the name of the University nor the names of its contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" @(#)ctags.1 8.1 (Berkeley) 6/6/93 -.\" -.Dd June 6, 1993 -.Dt CTAGS 1 -.Os -.Sh NAME -.Nm ctags -.Nd create a tags file -.Sh SYNOPSIS -.Nm -.Op Fl BFadtuwvx -.Op Fl f Ar tagsfile -.Ar name ... -.Sh DESCRIPTION -.Nm -makes a tags file for -.Xr ex 1 -from the specified C, -Pascal, Fortran, -.Tn YACC , -lex, and lisp sources. -A tags file gives the locations of specified objects in a group of files. -Each line of the tags file contains the object name, the file in which it -is defined, and a search pattern for the object definition, separated by -white-space. -Using the -.Ar tags -file, -.Xr ex 1 -can quickly locate these object definitions. -Depending upon the options provided to -.Nm , -objects will consist of subroutines, typedefs, defines, structs, -enums and unions. -.Bl -tag -width Ds -.It Fl B -use backward searching patterns -.Pq Li ?...? . -.It Fl F -use forward searching patterns -.Pq Li /.../ -(the default). -.It Fl a -append to -.Ar tags -file. -.It Fl d -create tags for -.Li #defines -that don't take arguments; -.Li #defines -that take arguments are tagged automatically. -.It Fl f -Places the tag descriptions in a file called -.Ar tagsfile . -The default behaviour is to place them in a file called -.Ar tags . -.It Fl t -create tags for typedefs, structs, unions, and enums. -.It Fl u -update the specified files in the -.Ar tags -file, that is, all -references to them are deleted, and the new values are appended to the -file. -(Beware: this option is implemented in a way which is rather -slow; it is usually faster to simply rebuild the -.Ar tags -file.) -.It Fl v -An index of the form expected by -.Xr vgrind 1 -is produced on the standard output. -This listing -contains the object name, file name, and page number (assuming 64 -line pages). -Since the output will be sorted into lexicographic order, -it may be desired to run the output through -.Xr sort 1 . -Sample use: -.Bd -literal -offset indent -ctags \-v files \&| sort \-f > index -vgrind \-x index -.Ed -.It Fl w -suppress warning diagnostics. -.It Fl x -.Nm -produces a list of object -names, the line number and file name on which each is defined, as well -as the text of that line and prints this on the standard output. -This -is a simple index which can be printed out as an off-line readable -function index. -.El -.Pp -Files whose names end in -.Sq \&.c -or -.Sq \&.h -are assumed to be C -source files and are searched for C style routine and macro definitions. -Files whose names end in -.Sq \&.y -are assumed to be -.Tn YACC -source files. -Files whose names end in -.Sq \&.l -are assumed to be lisp files if their -first non-blank character is -.Sq \&; , -.Sq \&( , -or -.Sq \&[ , -otherwise, they are -treated as lex files. -Other files are first examined to see if they -contain any Pascal or Fortran routine definitions, and, if not, are -searched for C style definitions. -.Pp -The tag -.Li main -is treated specially in C programs. -The tag formed -is created by prepending -.Ar M -to the name of the file, with the -trailing -.Sq \&.c -and any leading pathname components removed. -This -makes use of -.Nm -practical in directories with more than one -program. -.Pp -Yacc and lex files each have a special tag. -.Ar Yyparse -is the start -of the second section of the yacc file, and -.Ar yylex -is the start of -the second section of the lex file. -.Sh FILES -.Bl -tag -width tags -compact -.It Pa tags -default output tags file -.El -.Sh EXIT STATUS -.Ex -std -Duplicate objects are not considered errors. -.Sh SEE ALSO -.Xr ex 1 , -.Xr vi 1 -.Sh HISTORY -The -.Nm -command appeared in -.Bx 3.0 . -.Sh BUGS -Recognition of -.Em functions , -.Em subroutines -and -.Em procedures -for -.Tn FORTRAN -and Pascal is done in a very simpleminded way. -No attempt -is made to deal with block structure; if you have two Pascal procedures -in different blocks with the same name you lose. -.Nm -doesn't -understand about Pascal types. -.Pp -The method of deciding whether to look for C, Pascal or -.Tn FORTRAN -functions is a hack. -.Pp -.Nm -relies on the input being well formed, and any syntactical -errors will completely confuse it. -It also finds some legal syntax -confusing; for example, since it doesn't understand -.Li #ifdef Ns 's -(incidentally, that's a feature, not a bug), any code with unbalanced -braces inside -.Li #ifdef Ns 's -will cause it to become somewhat disoriented. -In a similar fashion, multiple line changes within a definition will -cause it to enter the last line of the object, rather than the first, as -the searching pattern. -The last line of multiple line -.Li typedef Ns 's -will similarly be noted. |