mirror of
https://github.com/davidhalter/jedi.git
synced 2026-05-19 23:09:43 +08:00
Fix typo s/Epidoc/Epydoc/g and add links for markups
This commit is contained in:
+4
-4
@@ -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|
|
parsing is much easier. There are two different types of docstrings that |jedi|
|
||||||
understands:
|
understands:
|
||||||
|
|
||||||
- Sphinx
|
- `Sphinx <http://sphinx-doc.org/markup/desc.html#info-field-lists>`_
|
||||||
- Epidoc
|
- `Epydoc <http://epydoc.sourceforge.net/manual-fields.html>`_
|
||||||
|
|
||||||
For example, the sphinx annotation ``:type foo: str`` clearly states that the
|
For example, the sphinx annotation ``:type foo: str`` clearly states that the
|
||||||
type of ``foo`` is ``str``.
|
type of ``foo`` is ``str``.
|
||||||
@@ -23,12 +23,12 @@ import parsing
|
|||||||
|
|
||||||
DOCSTRING_PARAM_PATTERNS = [
|
DOCSTRING_PARAM_PATTERNS = [
|
||||||
r'\s*:type\s+%s:\s*([^\n]+)', # Sphinx
|
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 = [
|
DOCSTRING_RETURN_PATTERNS = [
|
||||||
re.compile(r'\s*:rtype:\s*([^\n]+)', re.M), # Sphinx
|
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':[^`]+:`([^`]+)`')
|
REST_ROLE_PATTERN = re.compile(r':[^`]+:`([^`]+)`')
|
||||||
|
|||||||
Reference in New Issue
Block a user