Rooba
/
kivy
mirror of https://github.com/kivy/kivy.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #2922 from merriam/issue-2921-autobuild 

Close Issue #2921 - build doc failure
This commit is contained in:
dessant 2015-01-28 00:03:07 +02:00
parent dd0e0cfef1 61415b7dcf
commit 5785eea868
1 changed files with 6 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
doc/autobuild.py
View File

@ -173,6 +173,10 @@ template_examples_ref = ('# :ref:`Jump directly to Examples'
def extract_summary_line(doc):
"""
:param doc: the __doc__ field of a module
:return: a doc string suitable for a header or empty string
"""
if doc is None:
return ''
for line in doc.split('\n'):
@ -187,7 +191,7 @@ def extract_summary_line(doc):
for package in packages:
summary = extract_summary_line(sys.modules[package].__doc__)
if summary is None:
if summary is None or summary == '':
summary = 'NO DOCUMENTATION (package %s)' % package
t = template.replace('$SUMMARY', summary)
t = t.replace('$PACKAGE', package)
@ -219,7 +223,7 @@ m.sort()
refid = 0
for module in m:
summary = extract_summary_line(sys.modules[module].__doc__)
if summary is None:
if summary is None or summary == '':
summary = 'NO DOCUMENTATION (module %s)' % package
# search examples