IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Small API change.

Browse Source
This commit is contained in:
Georg Brandl 2009-01-04 20:43:15 +01:00
parent 27bc4e3189
commit 04689accd0
2 changed files with 6 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
sphinx/ext/autodoc.py
View File

@ -212,8 +212,9 @@ class RstGenerator(object):
docstrings.append(initdocstring)
# the default is only the class docstring
# make sure we get Unicode docstrings
return [force_decode(docstring, encoding) for docstring in docstrings]
# make sure we have Unicode docstrings, then sanitize and split into lines
return [prepare_docstring(force_decode(docstring, encoding))
for docstring in docstrings]
def process_doc(self, docstrings, what, name, obj):
"""Let the user process the docstrings."""
@ -462,8 +463,7 @@ class RstGenerator(object):
# add content from docstrings
if not no_docstring:
encoding = analyzer and analyzer.encoding
docstrings = map(prepare_docstring,
self.get_doc(what, todoc, encoding))
docstrings = self.get_doc(what, todoc, encoding)
for i, line in enumerate(self.process_doc(docstrings, what,
fullname, todoc)):
self.result.append(indent + line, sourcename, i)

6
tests/test_autodoc.py
View File

@ -15,7 +15,6 @@ from util import *
from docutils.statemachine import ViewList
from sphinx.ext.autodoc import RstGenerator, cut_lines, between
from sphinx.util.docstrings import prepare_docstring
def setup_module():
@ -174,7 +173,7 @@ def test_format_signature():
def test_get_doc():
def getdocl(*args):
ds = map(prepare_docstring, gen.get_doc(*args))
ds = gen.get_doc(*args)
# for testing purposes, concat them and strip the empty line at the end
return sum(ds, [])[:-1]
@ -240,8 +239,7 @@ def test_get_doc():
def test_docstring_processing():
def process(what, name, obj):
return list(gen.process_doc(map(prepare_docstring, gen.get_doc(what, obj)),
what, name, obj))
return list(gen.process_doc(gen.get_doc(what, obj), what, name, obj))
class E:
def __init__(self):