readtags(1) Universal Ctags readtags(1) (NAME) readtags - (SYNOPSIS) readtags -h | --help readtags (-H | --help-expression) (filter|sorter|formatter) readtags -v | --version readtags [OPTION]... ACTION (DESCRIPTION) readtags . (actions) . (post processors) (filter expressions) (sorter expressions) (formatter expressions) . (ACTIONS) -l, --list . [-] NAME NAME. "-" NAME - NAME . -D, --list-pseudo-tags . -Q . (OPTIONS) : -t TAGFILE, --tag-file TAGFILE (: "tags"). "-" TAGFILE . "-" readtags ACTION . -s[0|1|2], --override-sort-detection METHOD . METHOD unsorted|sorted|foldcase . NAME ( "foldcase") . NAME NAME : -i, --icase-match NAME. -p, --prefix-match NAME. readtags name input pattern . : -A, --absolute-input -C . -C, --canonicalize-input '..' '.' . . !_TAG_PROC_CWD . : !_TAG_PROC_CWD / C:\Somewhere . -d, --debug . -E, --escape-output tags(5). -e, --extension-fields . -n, --line-number -e. -P, --with-pseudo-tags -D . -Q -P -Q . -E: . readtags readtags -E . ctags-client-tools(7) . ({tagfile} tags(5)) -E: readtags ( ) ctags TAG_OUTPUT_MODE "u-ctags" TAG_OUTPUT_FILESEP "slash" ctags-client-tools(7) . : -Q EXP, --filter EXP ACTION EXP . -S EXP, --sorter EXP ACTION EXP . -F EXP, --formatter EXP ACTION EXP . << (EXPRESSION)>> . o "/path/to/tags": $ readtags -t /path/to/tags -l o "tags" "mymethod" : $ readtags -p - mymethod o "mymethod" : $ readtags -i - mymethod o "myvar" ( ): $ readtags -p -ne - myvar (EXPRESSION) -Q -S -F (Scheme-style) . : o . / . o . o #f . #t (true) . (+ 1 (+ 2 3)) . (and "string" 1 #t) AND "string" 1 #t #f . readtags . eq? prefix? suffix? substr? #/PATTERN/. $ $language . : o "myfunc" : $ readtags -p -Q '(eq? $language "Python")' - myfunc downcase upcase : o "my" : $ readtags -Q '(substr? (downcase $name) "my")' -l and or not . #f : o "impl" language:: $ readtags -Q '(and (substr? $name "impl")\ (or (not $language)\ (eq? $language "Python")))' -l #/PATTERN/ (prefix? suffix? substr?) . << (POSIX extended regular expression)>> PATTERN . o "A" : $ readtags -Q '(#/(^|,) ?A(,|$)/ $inherits)' -l $inherits "A,B,C" "P, A, Q" "A" . . #/PATTERN/i : o "A" "a" : $ readtags -Q '(#/(^|,) ?A(,|$)/i $inherits)' -l "/" \ "/" . : #/PATTERN/ . inherits: . ctags . inherits: . #/PATTERN/ #/PATTERN/i . readtags string->regexp #/PATTERN/ (string->regexp "PATTERN") #/PATTERN/i (string->regexp "PATTERN" :case-fold #t). string->regexp "/" \ . string->regexp . ctags-client-tools(7) . . inherits: . $inherits #f . : o "A" : $ readtags -Q '(and $inherits (#/(^|,) ?A(,|$)/ $inherits))' -l $inherits . . extras: extras: . : o : $ readtags -Q '(or (not $extras) (#/(^|,) ?reference(,|$)/ $extras))' -l (not $extras) $extras #t or #t . ctags -o - readtags -t - . o ( ) : $ ctags -o - --fields=+neKz input.c \ | ./readtags -t - -en \ -Q '(and (eq? $kind "function") $end $line (> (- $end $line) 100))' \ -l o : $ ctags -o - --fields=+neKz input.c \ | readtags -t - -ne \ -Q '(and $line (or (eq? $line 80) (and $end (< $line 80) (< 80 $end))))' \ -l "readtags -H filter" . . $ & $-entry &-entry . -1 0 1 . -1 $-entry &-entry 1 0 . <> . ( line: end: ). (<> a b) a < b -1 a > b 1 a = b 0 . strcmp strcmp(3) . : $ readtags -S '(<> $name &name)' -l : << $-entry &-entry >>. -1 1 . : $ readtags -S '( (<> $input &input) (<> $line &line))' -l *- (*- (<> a b)) (<> b a) . . if : (<> (if filter-expr-on-$-entry -1 1) (if filter-expr-on-&-entry -1 1)) $-entry &-entry (<> -1 1) -1 . "file" : (<> (if (eq? $kind "file") 1 -1) (if (eq? &kind "file") 1 -1)) : $-entry "file" &-entry (<> 1 -1) 1 $-entry &-entry . readtags . . readtags . #f #t . / . readtags . . list . list . list 1 #f "hello" : (list 1 #f "hello") : (backquote) . (output.tags) readtags : M input.c 4;" macro file: N input.c 3;" macro file: bar input.c 11;" f typeref:typename:void file: signature:(char ** argv,int * r) foo input.c 6;" f typeref:typename:int file: signature:(int v) main input.c 16;" f typeref:typename:int signature:(int argc,char ** argv) : $ readtags -t output.tags -Q '(eq? $kind "function")' -F '(list $name #t)' -l bar foo main : $ readtags -t output.tags -F '(if (eq? $kind "function") (list $name #t) #f)' -l bar foo main (declarations) : $ readtags -t output.tags -F \ '(if (eq? $kind "function") (list (if $file "static " #f) $typeref-name " " $name $signature ";" #t) #f)' -l static void bar(char ** argv,int * r); static int foo(int v); int main(int argc,char ** argv); print . : $ readtags -Q '(print $name)' -l . print #f . begin begin0 . begin begin0 . : $ readtags -Q '(begin0 #f (print (prefix? "ctags" "ct")))' -l "#t" ( ) . (SEE ALSO) tags(5) . ctags-client-tools(7) . Universal Ctags : readtags: (CREDITS) Universal Ctags (Darren Hiebert) <> readtags libreadtags Universal Ctags readtags.c readtags.h . 6.2.1 readtags(1)