1
0
forked from VimPlug/jedi

Fix typo s/Epidoc/Epydoc/g and add links for markups

This commit is contained in:
Takafumi Arakaki
2013-02-15 18:31:05 +01:00
parent ea9a667425
commit 98a6febb50

View File

@@ -4,8 +4,8 @@ Docstrings are another source of information for functions and classes.
parsing is much easier. There are two different types of docstrings that |jedi|
understands:
- Sphinx
- Epidoc
- `Sphinx <http://sphinx-doc.org/markup/desc.html#info-field-lists>`_
- `Epydoc <http://epydoc.sourceforge.net/manual-fields.html>`_
For example, the sphinx annotation ``:type foo: str`` clearly states that the
type of ``foo`` is ``str``.
@@ -23,12 +23,12 @@ import parsing
DOCSTRING_PARAM_PATTERNS = [
r'\s*:type\s+%s:\s*([^\n]+)', # Sphinx
r'\s*@type\s+%s:\s*([^\n]+)', # Epidoc
r'\s*@type\s+%s:\s*([^\n]+)', # Epydoc
]
DOCSTRING_RETURN_PATTERNS = [
re.compile(r'\s*:rtype:\s*([^\n]+)', re.M), # Sphinx
re.compile(r'\s*@rtype:\s*([^\n]+)', re.M), # Epidoc
re.compile(r'\s*@rtype:\s*([^\n]+)', re.M), # Epydoc
]
REST_ROLE_PATTERN = re.compile(r':[^`]+:`([^`]+)`')