jiigen666/libtorrent
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

some fixes to gen_reference_doc.py

Browse Source
This commit is contained in:
Arvid Norberg
2013-08-17 19:31:45 +00:00
parent 2971331f86
commit 45bf707a14
1 changed files with 14 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
docs/gen_reference_doc.py
View File

@@ -205,7 +205,9 @@ def parse_function(lno, lines, filename):
lno = consume_block(lno - 1, lines) lno = consume_block(lno - 1, lines)
signature += ';' signature += ';'
return [{ 'file': filename[11:], 'signatures': set([ signature ]), 'names': set([ signature.split('(')[0].split(' ')[-1].strip() + '()'])}, lno] ret = [{ 'file': filename[11:], 'signatures': set([ signature ]), 'names': set([ signature.split('(')[0].split(' ')[-1].strip() + '()'])}, lno]
if first_item(ret[0]['names']) == '()': return [None, lno]
return ret
if len(signature) > 0: if len(signature) > 0:
print '\x1b[31mFAILED TO PARSE FUNCTION\x1b[0m %s\nline: %d\nfile: %s' % (signature, lno, filename) print '\x1b[31mFAILED TO PARSE FUNCTION\x1b[0m %s\nline: %d\nfile: %s' % (signature, lno, filename)
return [None, lno] return [None, lno]
@@ -458,6 +460,11 @@ def consume_ifdef(lno, lines):
if l == '#else' and start_if - end_if == 1: break if l == '#else' and start_if - end_if == 1: break
if start_if - end_if == 0: break if start_if - end_if == 0: break
return lno return lno
else:
while l.endswith('\\') and lno < len(lines):
l = lines[lno].strip()
lno += 1
if verbose: print 'prep %s' % l
return lno return lno
@@ -744,12 +751,15 @@ def dump_link_targets():
def heading(string, c): def heading(string, c):
return '\n' + string + '\n' + (c * len(string)) + '\n' return '\n' + string + '\n' + (c * len(string)) + '\n'
def render_enums(out, enums): def render_enums(out, enums, print_declared_reference):
for e in enums: for e in enums:
print >>out, '.. raw:: html\n' print >>out, '.. raw:: html\n'
print >>out, '\t<a name="%s"></a>' % e['name'] print >>out, '\t<a name="%s"></a>' % e['name']
print >>out, '' print >>out, ''
print >>out, heading('enum %s' % e['name'], '.') print >>out, heading('enum %s' % e['name'], '.')
print_declared_in(out, e)
width = [len('name'), len('value'), len('description')] width = [len('name'), len('value'), len('description')]
for i in range(len(e['values'])): for i in range(len(e['values'])):
@@ -895,7 +905,7 @@ for cat in categories:
print >>out, dump_link_targets() print >>out, dump_link_targets()
render_enums(out, c['enums']) render_enums(out, c['enums'], False)
for f in c['fields']: for f in c['fields']:
if f['desc'] == '': continue if f['desc'] == '': continue
@@ -934,7 +944,7 @@ for cat in categories:
print >>out, dump_link_targets() print >>out, dump_link_targets()
render_enums(out, enums) render_enums(out, enums, True)
print >>out, dump_link_targets() print >>out, dump_link_targets()