tags(5) Universal Ctags tags(5) (NAME) tags - (DESCRIPTION) FORMAT Exuberant Ctags subversion sourceforge.net . Universal Ctags "EXCEPTION" . Universal Ctags "COMMENT" . ---- Vi Version: 0.06 DRAFT Date: 1998 Feb 8 Author: Bram Moolenaar and Darren Hiebert (Introduction) "tags" Vi . : 1. (Static or local tags). . . 2. (Duplicate tags). . / . 3. ++C. ( ) . 4. (Future extension). . (From proposal to standard) Vi ctags . : Darren Hiebert Exuberant Ctags Bram Moolenaar Vim (Vi IMproved) : Nvi Keith Bostic Vile Tom E. Dickey NEdit Mark Edel CRiSP Paul Fox Lemmy James Iuliano Zeus Jussi Jumppanen Elvis Steve Kirkendall FTE Marko Macek (Backwards compatibility) Vi . Vi . Vi . : 1. : {tagname}{tagfile}{tagaddress} {tagname} .. EXCEPTION: Universal Ctags tagname (spaces) . (tab) . TAB ( Vi ). {tagfile} {tagname} ( ). {tagaddress} Ex. 'magic' . 2. {tagname} . . 3. ( ). Vi {tagaddress} . Vi . : main main.c /^main(argc, argv)$/ DEBUG defines.c 89 : main main.c /^main(argc, argv)$/;"any additional text DEBUG defines.c 89;"any additional text ';' '"' . Vi Posix . Posix . Nvi . (Security) Vi Ex . . Ex . . tagaddress . Ex : o : 89 o . Vi // ??: /^int c;$/ ?main()? : o ';' . ( ). . . /struct xyz {/;/int count;/ 389;/struct foo/;/char *s;/ o ';"' ( : - ) . . 89;" foo bar . . (Goals) . : 1. : o Vi 512 . o . . o . 2. : o ctags . o . o . 3. : o . (Proposal) {tagaddress}. : {tagname}{tagfile}{tagaddress}[;"{tagfield}..] {tagname} .. EXCEPTION: Universal Ctags . . "value" . TAB ( Vi ). {tagfile} {tagname} ( ). {tagaddress} Ex. 'magic' . (Posix). COMMENT: {tagaddress} . {tagaddress} ( "pattern field" ) ctags-client-tools(7) . : ;" - + : tagaddress Vi . {tagfield} . tagfield : "name:value". o . . . ("kind:" "Kind: tagfield ). EXCEPTION: Universal Ctags . o . . o \t . o \r . o \n . o \\ \ . . : tagfield MS-DOS ! EXCEPTION: Universal Ctags . o \a (0x07) . o \b (0x08) . o \v (0x0b) . o \f (0x0c) . o 0x01 0x1F 0x7F "value" \x . EXCEPTION: Universal Ctags {tagname} {tagfile} . {tagfile} . "Exceptions in Universal Ctags" . o (0x20) ! (0x21) {tagname} \x (\x20 \x21) . ! . ( ) . tagfield: +-----------+--------------------------------+ |FIELD-NAME | DESCRIPTION | +-----------+--------------------------------+ |arity | | | | | | | | | | . | +-----------+--------------------------------+ |class | | | | | | | | | | | | | . | +-----------+--------------------------------+ |enum | | | | | | | | | | | | | | | | . | +-----------+--------------------------------+ |file | | | | | | | () | | | | | | | | | . | | | | | | | | | | | | {tagfile} | | | | | | . | +-----------+--------------------------------+ |function | | | | | | | | | | . | | | | | | | | | ( | | | ) | | | . | | | | | | | | | | | | | | | ( | | | ) | | | | | | '/' | | | | | | | | | | | | | | | | | | | | | . | +-----------+--------------------------------+ |kind | . | | | | | | | | | . C | | | ++C | | | | | | | | | : 0.0 c | | | (class | | | name) d | | | ( | | | #define XXX) e | | | | | | (enumerator) f | | | | | | (function or method name) F | | | | | | (file name) g | | | | | | (enumeration name) m | | | ( | | | | | | | | | ) p | | | | | | (function | | | prototype) s | | | (structure | | | name) t | | | (typedef) u | | | | | | (union name) v | | | (variable) | | | 168u | | | | | | | | | | | | | | | . | +-----------+--------------------------------+ |struct | | | | | | | | | | | | | . | +-----------+--------------------------------+ |union | | | | | | | | | | | | | . | +-----------+--------------------------------+ C ++C . . . : asdf sub.cc /^asdf()$/;" new_field:some\svalue file: foo_t sub.h /^typedef foo_t$/;" kind:t func3 sub.p /^func3()$/;" function:/func1/func2 file: getflag sub.c /^getflag(arg)$/;" kind:f file: inc sub.cc /^inc()$/;" file: class:PipeBuf "kind:" . . "kind:" ':' . : foo_t sub.h /^typedef foo_t$/;" t getflag sub.c /^getflag(arg)$/;" f file: : o tagfield . : Vi . MS-DOS . . . fgets() . . : +-------------------------+--------------------------+-----------------------------------+ | | | | | | | | +-------------------------+--------------------------+-----------------------------------+ | | | MS-DOS | | | | | +-------------------------+--------------------------+-----------------------------------+ | | | | +-------------------------+--------------------------+-----------------------------------+ | | MS-DOS | MS-DOS | | | | | +-------------------------+--------------------------+-----------------------------------+ . ( ). (white space): Vi tagname tagfile tagaddress . . . tagfile . \s. MS-DOS . c:\vim\sap \s . . tagname . Vi . . . . Vi : :%s/^\([^ ^I]*\)[ ^I]*\([^ ^I]*\)[ ^I]*/\1^I\2^I/ ( ^I ). COMMENT: Universal Ctags MS Windows \ / {tagfile} . "Exceptions in Universal Ctags" . (TAG FILE INFORMATION): (: tagfield ) . ( / ) ( ) . . "!_TAG_" . "!" . . . : !_TAG_FILE_FORMAT {version-number} /optional comment/ !_TAG_FILE_SORTED {0|1} /0=unsorted, 1=sorted/ {version-number} "1" UNIX vi/ctags "2" . . : !_TAG_PROGRAM_AUTHOR {author-name} /{email-address}/ !_TAG_PROGRAM_NAME {program-name} /optional comment/ !_TAG_PROGRAM_URL {URL} /optional comment/ !_TAG_PROGRAM_VERSION {version-id} /optional comment/ EXCEPTION: Universal Ctags . ctags-client-tools(7) . COMMENT: : {tagname}{tagfile}{tagaddress} "Proposal" . ---- Universal Ctags (Exceptions in Universal Ctags) Universal Ctags . (Exceptions) 1. {tagname} Universal Ctags . Tex reStructuredText JavaScript . {tagname} Proposal . 2. {tagfile} Universal Ctags \ . / . MS Windows Universal Ctags \ / . . Universal Ctags . ctags-client-tools(7) . 3. "name" {tagfield} Universal Ctags "name" . (Compatible output and weakness) ( --output-format=u-ctags) . --output-format=e-ctags ctags Universal Ctags Exuberant Ctags . --output-format=e-ctags . TAG_OUTPUT_MODE ctags . (SEE ALSO) ctags(1), ctags-client-tools(7), ctags-incompatibilities(7), readtags(1) 2+ tags(5)