forked from VimPlug/jedi
make docstrings ready for sphinx
This commit is contained in:
@@ -8,7 +8,7 @@ search functions `get_names_for_scope` and `get_scopes_for_name`. At the end
|
|||||||
there are the `follow_` functions, which evaluate a statement, or parts of a
|
there are the `follow_` functions, which evaluate a statement, or parts of a
|
||||||
statement.
|
statement.
|
||||||
|
|
||||||
TODO nonlocal statement, needed or can be ignored? (py3k)
|
.. todo:: nonlocal statement, needed or can be ignored? (py3k)
|
||||||
"""
|
"""
|
||||||
from _compatibility import next, property, hasattr, is_py3k, use_metaclass, \
|
from _compatibility import next, property, hasattr, is_py3k, use_metaclass, \
|
||||||
unicode
|
unicode
|
||||||
|
|||||||
@@ -13,18 +13,21 @@ This original codebase of this parser, which has been refactored and heavily
|
|||||||
changed, was programmed by Aaron Griffin <aaronmgriffin@gmail.com>.
|
changed, was programmed by Aaron Griffin <aaronmgriffin@gmail.com>.
|
||||||
|
|
||||||
**The structure of the following script:**
|
**The structure of the following script:**
|
||||||
A Scope has
|
|
||||||
|
A Scope has:
|
||||||
|
|
||||||
- imports (Import)
|
- imports (Import)
|
||||||
- subscopes (Scope, Class, Function, Flow)
|
- subscopes (Scope, Class, Function, Flow)
|
||||||
- statements (Statement)
|
- statements (Statement)
|
||||||
|
|
||||||
All these objects have `Name`s. `Call` and `Array` are used as detail objects
|
All these objects have ``Name``. ``Call`` and ``Array`` are used as detail
|
||||||
of a statement.
|
objects of a statement.
|
||||||
|
|
||||||
All those classes are being generated by PyFuzzyParser, which takes python text
|
All those classes are being generated by PyFuzzyParser, which takes python text
|
||||||
as input and ignores just all the non-python stuff. Basically you could feed it
|
as input and ignores just all the non-python stuff. Basically you could feed it
|
||||||
a perl script, and it should still work (which means throw no error).
|
a perl script, and it should still work (which means throw no error).
|
||||||
TODO remove docstr params from Scope.__init__()
|
|
||||||
|
.. todo:: remove docstr params from Scope.__init__()
|
||||||
"""
|
"""
|
||||||
from _compatibility import (next, literal_eval, StringIO, unicode,
|
from _compatibility import (next, literal_eval, StringIO, unicode,
|
||||||
property, cleandoc, Python3Method)
|
property, cleandoc, Python3Method)
|
||||||
|
|||||||
Reference in New Issue
Block a user