github
/
aria2
mirror of https://github.com/aria2/aria2
1
0
Fork 0
Code Issues Releases Wiki Activity

Merge branch 'pep-394' of https://github.com/wasamasa/aria2 into wasamasa-pep-394

pull/251/merge
Tatsuhiro Tsujikawa 2015-06-05 00:19:22 +09:00
parent a1de6730ab 080266ac04
commit 79cdca5f5b
1 changed files with 24 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
doc/manual-src/en/mkapiref.py
View File

@ -32,6 +32,7 @@
# files in the program, then also delete it here.
#
# Generates API reference from C++ source code.
from __future__ import print_function
import re, sys, argparse
class FunctionDoc:
@ -41,10 +42,10 @@ class FunctionDoc:
self.domain = domain
def write(self, out):
print '''.. {}:: {}'''.format(self.domain, self.name)
print ''
print('''.. {}:: {}'''.format(self.domain, self.name))
print()
for line in self.content:
print ' {}'.format(line)
print(' {}'.format(line))
class TypedefDoc:
def __init__(self, name, content):
@ -52,10 +53,10 @@ class TypedefDoc:
self.content = content
def write(self, out):
print '''.. type:: {}'''.format(self.name)
print ''
print('''.. type:: {}'''.format(self.name))
print()
for line in self.content:
print ' {}'.format(line)
print(' {}'.format(line))
class StructDoc:
def __init__(self, name, content, domain, members, member_domain):
@ -67,19 +68,19 @@ class StructDoc:
def write(self, out):
if self.name:
print '''.. {}:: {}'''.format(self.domain, self.name)
print ''
print('''.. {}:: {}'''.format(self.domain, self.name))
print()
for line in self.content:
print ' {}'.format(line)
print ''
print(' {}'.format(line))
print()
for name, content in self.members:
print ''' .. {}:: {}'''.format(\
print(''' .. {}:: {}'''.format(\
'function' if name.endswith(')') else self.member_domain,
name)
print ''
name))
print()
for line in content:
print ''' {}'''.format(line)
print ''
print(''' {}'''.format(line))
print()
class MacroDoc:
def __init__(self, name, content):
@ -87,10 +88,10 @@ class MacroDoc:
self.content = content
def write(self, out):
print '''.. macro:: {}'''.format(self.name)
print ''
print('''.. macro:: {}'''.format(self.name))
print()
for line in self.content:
print ' {}'.format(line)
print(' {}'.format(line))
def make_api_ref(infiles):
macros = []
@ -124,12 +125,12 @@ def make_api_ref(infiles):
for title, docs in alldocs:
if not docs:
continue
print title
print '-'*len(title)
print(title)
print('-'*len(title))
for doc in docs:
doc.write(sys.stdout)
print ''
print ''
print()
print()
def process_macro(infile):
content = read_content(infile)
@ -263,6 +264,6 @@ if __name__ == '__main__':
help='source file')
args = parser.parse_args()
if args.header:
print args.header.read()
print(args.header.read())
for infile in args.files:
make_api_ref(args.files)