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

NAME

6       ctags-lang-iPythonCell  -  The  man  page of the iPythonCell parser for
7       Universal Ctags
8

SYNOPSIS

10       ctags ... --extras=+{subparser} --languages=+iPythonCell,Python \
11         [--extras-IPythonCell=+{doubleSharps}] \
12         [--regex-IPythonCell=/<PATTERN>/\n/c/] ...
13
14

DESCRIPTION

16       iPythonCell parser is a subparser stacked on top of the Python  parser.
17       It works when:
18
19       • the Python parser is enabled,
20
21       • the subparser extra is enabled, and
22
23       • the iPythonCell parser itself is enabled.
24
25       The  iPythonCell parser extracts cells explained as in vim-ipython-cell
26       (https://github.com/hanschen/vim-ipython-cell/blob/master/README.md).
27

KIND(S)

29       The iPythonCell parser defines only a cell kind.
30

EXTRA(S)

32       Tagging cells staring with ##... is disabled  by  default  because  the
33       pattern  is  too  generic;  with  that pattern unwanted tags can be ex‐
34       tracted.
35
36       Enable doubleSharps language specific extra for tagging  cells  staring
37       with ##....
38

CUSTOMIZING

40       If  your  favorite cell pattern is not supported in the parser, you can
41       define the pattern in your .ctagd.d/your.ctags or command lines.   Here
42       is an example how to support "# CTAGS: ...":
43
44       "input.py"
45
46          x=1
47          # CTAGS: DEFINE F
48          def F():
49                  # CTAGS: DO NOTING
50                  pass
51
52       "output.tags"   with  "--options=NONE  --sort=no  --extras=+{subparser}
53       --regex-IPythonCell=/[ t]*# CTAGS:[ ]?(.*)$/1/c/ -o - input.py"
54
55          x    input.py        /^x=1$/;"       v
56          DEFINE F     input.py        /^# CTAGS: DEFINE F$/;" c
57          F    input.py        /^def F():$/;"  f
58          DO NOTING    input.py        /^      # CTAGS: DO NOTING$/;"  c
59
60       You can put "--regex-IPythonCell=/[  \t]*#  CTAGS:[  ]?(.*)$/\1/c/"  in
61       your.ctags to avoid specifying the pattern repeatedly.
62

SEE ALSO

64       ctags(1), ctags-client-tools(7), ctags-lang-python(7)
65
66
67
68
696.0.0                                                CTAGS-LANG-IPYTHONCELL(7)
Impressum