CTAGS-LANG-IPYTHONCELL(7)       Universal Ctags      CTAGS-LANG-IPYTHONCELL(7)

NAME
       ctags-lang-iPythonCell - The man page of the iPythonCell parser for
       Universal Ctags

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


DESCRIPTION
       iPythonCell parser is a subparser stacked on top of the Python parser.
       It works when:

       o the Python parser is enabled,

       o the subparser extra is enabled, and

       o the iPythonCell parser itself is enabled.

       The iPythonCell parser extracts cells explained as in vim-ipython-cell
       (https://github.com/hanschen/vim-ipython-cell/blob/master/README.md).

KIND(S)
       The iPythonCell parser defines only a cell kind.

EXTRA(S)
       Tagging cells staring with ##... is disabled by default because the
       pattern is too generic; with that pattern unwanted tags can be
       extracted.

       Enable doubleSharps language specific extra for tagging cells staring
       with ##....

CUSTOMIZING
       If your favorite cell pattern is not supported in the parser, you can
       define the pattern in your .ctagd.d/your.ctags or command lines.  Here
       is an example how to support "# CTAGS: ...":

       "input.py"

          x=1
          # CTAGS: DEFINE F
          def F():
                  # CTAGS: DO NOTING
                  pass

       "output.tags" with "--options=NONE --sort=no --extras=+{subparser}
       --regex-IPythonCell=/[ t]*# CTAGS:[ ]?(.*)$/1/c/ -o - input.py"

          x    input.py        /^x=1$/;"       v
          DEFINE F     input.py        /^# CTAGS: DEFINE F$/;" c
          F    input.py        /^def F():$/;"  f
          DO NOTING    input.py        /^      # CTAGS: DO NOTING$/;"  c

       You can put "--regex-IPythonCell=/[ \t]*# CTAGS:[ ]?(.*)$/\1/c/" in
       your.ctags to avoid specifying the pattern repeatedly.

SEE ALSO
       ctags(1), ctags-client-tools(7), ctags-lang-python(7)

6.1.0                                                CTAGS-LANG-IPYTHONCELL(7)