Man page - ctags-universal-lang-ipythoncell(7)

Packages contains this manual

Manual

CTAGS-LANG-IPYTHONCELL

NAME
SYNOPSIS
DESCRIPTION
KIND(S)
EXTRA(S)
CUSTOMIZING
SEE ALSO

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 is a subparser stacked on top of the Python parser. It works when:

β€’

The Python parser is enabled,

β€’

the subparser extra is enabled, and

β€’

the iPythonCell parser itself is enabled.

iPythonCell 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)