1
0
forked from VimPlug/jedi

Merge pull request #95 from dbrgn/docs

Proper Sphinx deprecation warnings and cross references
This commit is contained in:
David Halter
2012-12-27 10:01:28 -08:00
2 changed files with 5 additions and 5 deletions

View File

@@ -5,7 +5,7 @@ The plugin API
If you want to set up an editor/IDE-plugin with **Jedi**, you first need to
``import jedi``. You then have direct access to the :class:`.Script`,
:class:`.NotFoundError` and :func:`.set_debug_function` objects.
:exc:`.NotFoundError` and :func:`.set_debug_function` objects.
API documentation

View File

@@ -93,8 +93,8 @@ class BaseDefinition(object):
@property
def line_nr(self):
"""
.. warning:: Deprecated! It's just here for backwards compatibility,
use `api_classes.BaseDefinition.line` instead.
.. deprecated:: 0.5.0
Use :attr:`.line` instead.
.. todo:: Remove!
"""
warnings.warn("Use line instead.", DeprecationWarning)
@@ -102,7 +102,7 @@ class BaseDefinition(object):
@property
def line(self):
""" The line where the definition occurs (starting with 1). """
"""The line where the definition occurs (starting with 1)."""
return self.start_pos[0]
@property
@@ -112,7 +112,7 @@ class BaseDefinition(object):
@property
def doc(self):
""" Return a document string for this completion object. """
"""Return a document string for this completion object."""
try:
return self.definition.doc
except AttributeError: