1CTAGS-LANG-TCL(7)               Universal Ctags              CTAGS-LANG-TCL(7)
2
3
4

NAME

6       ctags-lang-tcl  -  Random notes about tagging tcl source code with Uni‐
7       versal Ctags
8

SYNOPSIS

10       ctags ... --languages=+Tcl ...
11       ctags ... --language-force=Tcl ...
12       ctags ... --map-Tcl=+.tcl ...
13
14

DESCRIPTION

16       This man page gathers random notes about tagging tcl source code.
17

TAGGING LANGUAGE OBJECTS OF OO EXTENSIONS

19       TclOO parser and ITcl parser are subparsers running on the Tcl  parser.
20       As  the names of parsers show, they are for tagging language objects of
21       object oriented programming extensions for the Tcl language.
22
23       A pattern, "namespace import oo" in an input file activates  the  TclOO
24       parser.  A  pattern, "namespace import itcl" in an input file activates
25       the ITcl parser.
26
27       There are cases that one of the OO extensions is  used  though  neither
28       pattern are appeared in an input file.
29
30       Consider the following input files:
31
32       "main.tcl"
33
34          package require Itcl
35          namespace import itcl::*
36          source input.tcl
37
38       "input.tcl"
39
40          class MyClass {
41                  public method foo {} {
42                  }
43          }
44
45       The  pattern  for  activating  the  ITcl parser is not appeared in "in‐
46       put.tcl" though "class" command is used. As a result, ctags cannot  ex‐
47       tract "MyClass".
48
49       The          parameters         TclOO.forceUse=true|[false]         and
50       ITcl.forceuse=true|[false] for handling this situation. With the param‐
51       eter, you can force ctags to activate one of the subparsers.
52
53       You  can  use  the parameters like --param-ITcl.forceuse=true in a com‐
54       mand-line.
55
56       Note that you can enable only one of ITcl parser or TclOO parser.   En‐
57       abling both parsers with specifying the parameters can cause unexpected
58       results.
59

SEE ALSO

61       ctags(1)
62
63
64
65
665.9.0                                                        CTAGS-LANG-TCL(7)
Impressum