1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
.. _ctags-lang-iPythonCell(7):
==============================================================
ctags-lang-iPythonCell
==============================================================
-------------------------------------------------------------------
The man page of the iPythonCell parser for Universal Ctags
-------------------------------------------------------------------
:Version: @VERSION@
:Manual group: Universal Ctags
:Manual section: 7
SYNOPSIS
--------
| **@CTAGS_NAME_EXECUTABLE@** ... --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:
* the Python parser is enabled,
* the ``subparser`` extra is enabled, and
* 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"
.. code-block:: Python
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"
.. code-block:: tags
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)
|
