docs: Update docstring of SphinxDirective (add notice)

This commit is contained in:
Takeshi KOMIYA 2018-03-28 22:09:38 +09:00
parent f9e2a41a48
commit a4c30027bd

View File

@ -301,10 +301,12 @@ def switch_source_input(state, content):
class SphinxDirective(Directive):
"""A base class for Directives.
"""A base class for Sphinx directives.
Compared with ``docutils.parsers.rst.Directive``, this class improves
accessibility to Sphinx APIs.
This class provides helper methods for Sphinx directives.
.. note:: The subclasses of this class might not work with docutils.
This class is strongly coupled with Sphinx.
"""
@property