Formatting.
docmaker.py will now run with older Python versions also. Small fix.
This commit is contained in:
Werner Lemberg
parent
95853c87f5
commit
dc7f9c8dd0
602
docs/docmaker.py
602
docs/docmaker.py
@ -126,140 +126,139 @@ def make_block_list():
|
||||
# 5 - process source
|
||||
#
|
||||
|
||||
comment = []
|
||||
source = []
|
||||
state = 0
|
||||
comment = []
|
||||
source = []
|
||||
state = 0
|
||||
|
||||
for line in fileinput.input():
|
||||
|
||||
# remove trailing CR
|
||||
l = len(line)
|
||||
if l > 0 and line[l-1] == '\012':
|
||||
line = line[0:l-1]
|
||||
l = len( line )
|
||||
if l > 0 and line[l - 1] == '\012':
|
||||
line = line[0 : l - 1]
|
||||
|
||||
# stripped version of the line
|
||||
line2 = string.strip(line)
|
||||
l = len(line2)
|
||||
line2 = string.strip( line )
|
||||
l = len( line2 )
|
||||
|
||||
# if this line begins with a comment and we're processing some source, exit
|
||||
# to state 0
|
||||
# if this line begins with a comment and we are processing some
|
||||
# source, exit to state 0
|
||||
#
|
||||
if format >= 4 and l > 2 and line2[0:2] == '/*':
|
||||
list.append( (block,source) )
|
||||
if format >= 4 and l > 2 and line2[0 : 2] == '/*':
|
||||
list.append( ( block, source ) )
|
||||
format = 0
|
||||
|
||||
if format == 0: ##################### wait beginning of comment ###########
|
||||
if l > 3 and line2[0:3] == '/**':
|
||||
i = 3
|
||||
while (i < l) and (line2[i] == '*'):
|
||||
i = i+1
|
||||
|
||||
if i == l:
|
||||
# this is '/**' followed by any number of '*', the
|
||||
# beginning of a Format 1 block
|
||||
#
|
||||
block = []
|
||||
source = []
|
||||
format = 1
|
||||
if format == 0: #### wait for beginning of comment ####
|
||||
|
||||
elif (i == l-1) and (line2[i] == '/'):
|
||||
# this is '/**' followed by any number of '*', followed
|
||||
# by a '/', i.e. the beginning of a Format 2 or 3 block
|
||||
#
|
||||
block = []
|
||||
source = []
|
||||
format = 2
|
||||
if l > 3 and line2[0 : 3] == '/**':
|
||||
i = 3
|
||||
while i < l and line2[i] == '*':
|
||||
i = i + 1
|
||||
|
||||
##############################################################
|
||||
#
|
||||
# FORMAT 1
|
||||
#
|
||||
elif format == 1:
|
||||
if i == l:
|
||||
# this is '/**' followed by any number of '*', the
|
||||
# beginning of a Format 1 block
|
||||
#
|
||||
block = []
|
||||
source = []
|
||||
format = 1
|
||||
|
||||
# if the line doesn't begin with a "*", something went
|
||||
# wrong, and we must exit, and forget the current block..
|
||||
if (l == 0) or (line2[0] != '*'):
|
||||
block = []
|
||||
format = 0
|
||||
|
||||
# otherwise, we test for an end of block, which is an
|
||||
# arbitrary number of '*', followed by '/'
|
||||
else:
|
||||
i = 1
|
||||
while (i < l) and (line2[i] == '*'):
|
||||
i = i+1
|
||||
elif i == l - 1 and line2[i] == '/':
|
||||
# this is '/**' followed by any number of '*', followed
|
||||
# by a '/', i.e. the beginning of a Format 2 or 3 block
|
||||
#
|
||||
block = []
|
||||
source = []
|
||||
format = 2
|
||||
|
||||
##############################################################
|
||||
#
|
||||
# FORMAT 1
|
||||
#
|
||||
elif format == 1:
|
||||
|
||||
# if the line doesn't begin with a "*", something went
|
||||
# wrong, and we must exit, and forget the current block..
|
||||
if l == 0 or line2[0] != '*':
|
||||
block = []
|
||||
format = 0
|
||||
|
||||
# otherwise, we test for an end of block, which is an
|
||||
# arbitrary number of '*', followed by '/'
|
||||
else:
|
||||
i = 1
|
||||
while i < l and line2[i] == '*':
|
||||
i = i + 1
|
||||
|
||||
# test for the end of the block
|
||||
if i < l and line2[i] == '/':
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# otherwise simply append line to current block
|
||||
block.append( line2 )
|
||||
|
||||
# test for the end of the block
|
||||
if (i < l) and (line2[i] == '/'):
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# otherwise simply append line to current block
|
||||
block.append(line2)
|
||||
continue
|
||||
|
||||
##############################################################
|
||||
#
|
||||
# FORMAT 2
|
||||
#
|
||||
elif format == 2:
|
||||
##############################################################
|
||||
#
|
||||
# FORMAT 2
|
||||
#
|
||||
elif format == 2:
|
||||
|
||||
# if the line doesn't begin with '/*' and end with '*/',
|
||||
# this is the end of the format 2 format..
|
||||
if (l < 4 ) or (line2[:2] != '/*') or (line2[-2:] != '*/'):
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# remove the start and end comment delimiters, then right-strip
|
||||
# the line
|
||||
line2 = string.rstrip(line2[2:-2])
|
||||
# if the line doesn't begin with '/*' and end with '*/',
|
||||
# this is the end of the format 2 format
|
||||
if l < 4 or line2[: 2] != '/*' or line2[-2 :] != '*/':
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# remove the start and end comment delimiters, then
|
||||
# right-strip the line
|
||||
line2 = string.rstrip( line2[2 : -2] )
|
||||
|
||||
# check for end of a format2 block, i.e. a run of '*'
|
||||
if string.count(line2,'*') == l-4:
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# otherwise, add the line to the current block
|
||||
block.append(line2)
|
||||
|
||||
continue
|
||||
# check for end of a format2 block, i.e. a run of '*'
|
||||
if string.count( line2, '*' ) == l - 4:
|
||||
if block != []:
|
||||
format = 4
|
||||
else:
|
||||
format = 0
|
||||
else:
|
||||
# otherwise, add the line to the current block
|
||||
block.append( line2 )
|
||||
|
||||
continue
|
||||
|
||||
|
||||
|
||||
if format >= 4: ########################## source processing ################
|
||||
if format >= 4: #### source processing ####
|
||||
|
||||
if l > 0:
|
||||
format = 5
|
||||
|
||||
if format == 5:
|
||||
source.append(line)
|
||||
source.append( line )
|
||||
|
||||
|
||||
if format >= 4:
|
||||
list.append([block,source])
|
||||
list.append( [block, source] )
|
||||
|
||||
return list
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
# This function is only used for debugging
|
||||
#
|
||||
def dump_block_list( list ):
|
||||
"""dump a comment block list"""
|
||||
for block in list:
|
||||
print "----------------------------------------"
|
||||
for line in block[0]:
|
||||
print line
|
||||
for line in block[1]:
|
||||
print line
|
||||
print "----------------------------------------"
|
||||
for line in block[0]:
|
||||
print line
|
||||
for line in block[1]:
|
||||
print line
|
||||
|
||||
print "---------the end-----------------------"
|
||||
|
||||
@ -271,77 +270,86 @@ def dump_block_list( list ):
|
||||
#
|
||||
class DocCode:
|
||||
|
||||
def __init__(self,margin=0):
|
||||
self.lines = []
|
||||
self.margin = margin
|
||||
|
||||
def add(self,line):
|
||||
def __init__( self, margin = 0 ):
|
||||
self.lines = []
|
||||
self.margin = margin
|
||||
|
||||
def add( self, line ):
|
||||
# remove margin whitespace
|
||||
if string.strip( line[:self.margin] ) == "": line = line[self.margin:]
|
||||
self.lines.append(line)
|
||||
if string.strip( line[: self.margin] ) == "":
|
||||
line = line[self.margin :]
|
||||
self.lines.append( line )
|
||||
|
||||
|
||||
def dump(self):
|
||||
def dump( self ):
|
||||
|
||||
max_width = 50
|
||||
max_width = 50
|
||||
|
||||
for line in self.lines:
|
||||
print "--" + line
|
||||
|
||||
print ""
|
||||
print ""
|
||||
|
||||
|
||||
def dump_html(self):
|
||||
def dump_html( self ):
|
||||
|
||||
# clean the last empty lines
|
||||
l = len(self.lines)-1
|
||||
while (len > 0) and string.strip(lines[len-1])=="":
|
||||
len = len-1
|
||||
l = len( self.lines ) - 1
|
||||
while len > 0 and string.strip( lines[len - 1] ) == "":
|
||||
len = len - 1
|
||||
|
||||
print code_header
|
||||
for line in self.lines[0:len]:
|
||||
for line in self.lines[0 : len]:
|
||||
print lines
|
||||
print code_footer
|
||||
|
||||
|
||||
##############################################################################
|
||||
#
|
||||
# The DocParagraph is used to store either simple text paragraphs
|
||||
# The DocParagraph is used to store text paragraphs
|
||||
# self.words is simply a list of words for the paragraph
|
||||
#
|
||||
class DocParagraph:
|
||||
|
||||
def __init__(self):
|
||||
self.words = []
|
||||
|
||||
def add(self,line):
|
||||
def __init__( self ):
|
||||
self.words = []
|
||||
|
||||
def add( self, line ):
|
||||
# get rid of unwanted spaces in the paragraph
|
||||
self.words.extend( string.split(line) )
|
||||
|
||||
#
|
||||
# the following line is the same as
|
||||
#
|
||||
# self.words.extend( string.split( line ) )
|
||||
#
|
||||
# but older Python versions don't have the `extend' attribute
|
||||
#
|
||||
self.words[len( self.words ) : len( self.words )] = \
|
||||
string.split( line )
|
||||
|
||||
|
||||
def dump(self):
|
||||
def dump( self ):
|
||||
|
||||
max_width = 50
|
||||
max_width = 50
|
||||
cursor = 0
|
||||
line = ""
|
||||
|
||||
for word in self.words:
|
||||
|
||||
if cursor+len(word)+1 > max_width:
|
||||
print line
|
||||
cursor = 0
|
||||
line = ""
|
||||
if cursor + len( word ) + 1 > max_width:
|
||||
print line
|
||||
cursor = 0
|
||||
line = ""
|
||||
|
||||
line = line + word + " "
|
||||
cursor = cursor + len(word) + 1
|
||||
|
||||
line = line + word + " "
|
||||
cursor = cursor + len( word ) + 1
|
||||
|
||||
if cursor > 0:
|
||||
print line
|
||||
print line
|
||||
|
||||
print ""
|
||||
print ""
|
||||
|
||||
|
||||
def dump_html(self):
|
||||
def dump_html( self ):
|
||||
|
||||
print para_header
|
||||
self.dump()
|
||||
@ -352,33 +360,31 @@ class DocParagraph:
|
||||
#
|
||||
# DocContent is used to store the content of a given marker.
|
||||
#
|
||||
#
|
||||
#
|
||||
class DocContent:
|
||||
|
||||
def __init__(self,lines_list):
|
||||
self.items = []
|
||||
code_mode = 0
|
||||
code_margin = 0
|
||||
text = []
|
||||
paragraph = None
|
||||
code = None
|
||||
elements = []
|
||||
field = None
|
||||
def __init__( self, lines_list ):
|
||||
self.items = []
|
||||
code_mode = 0
|
||||
code_margin = 0
|
||||
text = []
|
||||
paragraph = None
|
||||
code = None
|
||||
elements = []
|
||||
field = None
|
||||
|
||||
for aline in lines_list:
|
||||
|
||||
if code_mode == 0:
|
||||
line = string.lstrip(aline)
|
||||
l = len(line)
|
||||
margin = len(aline) - l
|
||||
for aline in lines_list:
|
||||
|
||||
if code_mode == 0:
|
||||
line = string.lstrip( aline )
|
||||
l = len( line )
|
||||
margin = len( aline ) - l
|
||||
|
||||
# if the line is empty, this is the end of the current
|
||||
# paragraph
|
||||
if l == 0 or line == '{':
|
||||
# if the line is empty, this is the end of the current
|
||||
# paragraph
|
||||
if l == 0 or line == '{':
|
||||
|
||||
if paragraph:
|
||||
elements.append(paragraph)
|
||||
if paragraph:
|
||||
elements.append( paragraph )
|
||||
paragraph = None
|
||||
|
||||
if line == "":
|
||||
@ -388,87 +394,87 @@ class DocContent:
|
||||
code_margin = margin
|
||||
code = None
|
||||
continue
|
||||
|
||||
words = string.split(line)
|
||||
|
||||
# test for a field delimiter on the start of the line, i.e.
|
||||
# the token `::'
|
||||
#
|
||||
if len(words) >= 2 and words[1] == "::":
|
||||
if paragraph:
|
||||
elements.append(paragraph)
|
||||
|
||||
words = string.split( line )
|
||||
|
||||
# test for a field delimiter on the start of the line, i.e.
|
||||
# the token `::'
|
||||
#
|
||||
if len( words ) >= 2 and words[1] == "::":
|
||||
if paragraph:
|
||||
elements.append( paragraph )
|
||||
paragraph = None
|
||||
|
||||
self.items.append( (field,elements) )
|
||||
|
||||
field = words[0]
|
||||
elements = []
|
||||
words = words[2:]
|
||||
|
||||
if len(words) > 0:
|
||||
line = string.join(words)
|
||||
if not paragraph:
|
||||
paragraph = DocParagraph()
|
||||
paragraph.add( line )
|
||||
|
||||
else:
|
||||
line = aline
|
||||
|
||||
# the code block ends with a line that has a single '}' on it
|
||||
if line == " "*code_margin+'}':
|
||||
self.items.append( ( field, elements ) )
|
||||
|
||||
field = words[0]
|
||||
elements = []
|
||||
words = words[2 :]
|
||||
|
||||
if len( words ) > 0:
|
||||
line = string.join( words )
|
||||
if not paragraph:
|
||||
paragraph = DocParagraph()
|
||||
paragraph.add( line )
|
||||
|
||||
else:
|
||||
line = aline
|
||||
|
||||
# the code block ends with a line that has a single '}' on it
|
||||
if line == " " * code_margin + '}':
|
||||
|
||||
if code:
|
||||
elements.append(code)
|
||||
elements.append( code )
|
||||
code = None
|
||||
|
||||
code_mode = 0
|
||||
code_margin = 0
|
||||
|
||||
# otherwise, add the line to the current paragraph
|
||||
else:
|
||||
code_mode = 0
|
||||
code_margin = 0
|
||||
|
||||
# otherwise, add the line to the current paragraph
|
||||
else:
|
||||
if not code:
|
||||
code = DocCode()
|
||||
code.add(line)
|
||||
|
||||
if paragraph:
|
||||
elements.append(paragraph)
|
||||
code.add( line )
|
||||
|
||||
if paragraph:
|
||||
elements.append( paragraph )
|
||||
|
||||
if code:
|
||||
elements.append(code)
|
||||
|
||||
self.items.append( (field,elements) )
|
||||
elements.append( code )
|
||||
|
||||
self.items.append( ( field, elements ) )
|
||||
|
||||
|
||||
|
||||
def dump(self):
|
||||
for item in self.items:
|
||||
def dump( self ):
|
||||
for item in self.items:
|
||||
field = item[0]
|
||||
if field:
|
||||
print "<field "+field+">"
|
||||
if field:
|
||||
print "<field " + field + ">"
|
||||
|
||||
for element in item[1]:
|
||||
for element in item[1]:
|
||||
element.dump()
|
||||
|
||||
if field:
|
||||
print "</field> "
|
||||
|
||||
if field:
|
||||
print "</field> "
|
||||
|
||||
def dump_html(self):
|
||||
def dump_html( self ):
|
||||
|
||||
n = len(self.items)
|
||||
n = len( self.items )
|
||||
in_table = 0
|
||||
|
||||
for i in range(n):
|
||||
for i in range( n ):
|
||||
item = self.items[i]
|
||||
field = item[0]
|
||||
|
||||
if not field:
|
||||
|
||||
if in_table:
|
||||
print "</td></tr></table>"
|
||||
in_table = 0
|
||||
print "</td></tr></table>"
|
||||
in_table = 0
|
||||
|
||||
for element in item[1]:
|
||||
element.dump_html()
|
||||
element.dump_html()
|
||||
else:
|
||||
if not in_table:
|
||||
print "<table cellpadding=4><tr valign=top><td>"
|
||||
@ -476,7 +482,7 @@ class DocContent:
|
||||
else:
|
||||
print "</td></tr><tr valign=top><td>"
|
||||
|
||||
print "<b>"+field+"</b></td><td>"
|
||||
print "<b>" + field + "</b></td><td>"
|
||||
|
||||
for element in item[1]:
|
||||
element.dump_html()
|
||||
@ -484,6 +490,7 @@ class DocContent:
|
||||
if in_table:
|
||||
print "</td></tr></table>"
|
||||
|
||||
|
||||
######################################################################################
|
||||
#
|
||||
#
|
||||
@ -493,9 +500,9 @@ class DocContent:
|
||||
#
|
||||
class DocBlock:
|
||||
|
||||
def __init__(self, block_line_list=[], source_line_list=[]):
|
||||
self.markers = []
|
||||
self.contents = []
|
||||
def __init__( self, block_line_list = [], source_line_list = [] ):
|
||||
self.markers = []
|
||||
self.contents = []
|
||||
self.source = source_line_list
|
||||
|
||||
marker = ""
|
||||
@ -503,62 +510,65 @@ class DocBlock:
|
||||
alphanum = string.letters + string.digits + "_"
|
||||
|
||||
for line in block_line_list:
|
||||
line2 = string.lstrip(line)
|
||||
l = len(line2)
|
||||
margin = len(line) - l
|
||||
|
||||
if l > 3 and line2[0] == '<':
|
||||
i = 1
|
||||
while i < l and line2[i] in alphanum: i = i+1
|
||||
if i < l and line2[i] == '>':
|
||||
if marker or content:
|
||||
self.add( marker, content )
|
||||
marker = line2[1:i]
|
||||
content = []
|
||||
line2 = string.lstrip(line2[i+1:])
|
||||
l = len(line2)
|
||||
line = " "*margin + line2
|
||||
|
||||
content.append(line)
|
||||
|
||||
if marker or content:
|
||||
self.add( marker, content )
|
||||
|
||||
|
||||
line2 = string.lstrip( line )
|
||||
l = len( line2 )
|
||||
margin = len( line ) - l
|
||||
|
||||
if l > 3 and line2[0] == '<':
|
||||
i = 1
|
||||
while i < l and line2[i] in alphanum:
|
||||
i = i + 1
|
||||
if i < l and line2[i] == '>':
|
||||
if marker or content:
|
||||
self.add( marker, content )
|
||||
marker = line2[1 : i]
|
||||
content = []
|
||||
line2 = string.lstrip( line2[i + 1 :] )
|
||||
l = len( line2 )
|
||||
line = " " * margin + line2
|
||||
|
||||
content.append( line )
|
||||
|
||||
if marker or content:
|
||||
self.add( marker, content )
|
||||
|
||||
|
||||
def add( self, marker, lines ):
|
||||
|
||||
# remove the first and last empty lines from the content list
|
||||
l = len(lines)
|
||||
if l > 0:
|
||||
i = 0
|
||||
while l > 0 and string.strip(lines[l-1]) == "": l = l-1
|
||||
while i < l and string.strip(lines[i]) == "": i = i+1
|
||||
lines = lines[i:l]
|
||||
l = len(lines)
|
||||
|
||||
# add a new marker only if its marker and its content list aren't empty
|
||||
if l > 0 and marker:
|
||||
self.markers.append(marker)
|
||||
self.contents.append(lines)
|
||||
# remove the first and last empty lines from the content list
|
||||
l = len( lines )
|
||||
if l > 0:
|
||||
i = 0
|
||||
while l > 0 and string.strip( lines[l - 1] ) == "":
|
||||
l = l - 1
|
||||
while i < l and string.strip( lines[i] ) == "":
|
||||
i = i + 1
|
||||
lines = lines[i : l]
|
||||
l = len( lines )
|
||||
|
||||
# add a new marker only if its marker and its content list aren't empty
|
||||
if l > 0 and marker:
|
||||
self.markers.append( marker )
|
||||
self.contents.append( lines )
|
||||
|
||||
def dump( self ):
|
||||
for i in range( len(self.markers) ):
|
||||
print "["+self.markers[i]+"]"
|
||||
for line in self.contents[i]:
|
||||
print "-- "+line
|
||||
for i in range( len( self.markers ) ):
|
||||
print "[" + self.markers[i] + "]"
|
||||
for line in self.contents[i]:
|
||||
print "-- " + line
|
||||
|
||||
def doc_contents(self):
|
||||
contents = []
|
||||
for item in self.contents:
|
||||
contents.append( DocContent(item) )
|
||||
return contents
|
||||
def doc_contents( self ):
|
||||
contents = []
|
||||
for item in self.contents:
|
||||
contents.append( DocContent( item ) )
|
||||
return contents
|
||||
|
||||
|
||||
def dump_doc_blocks( block_list ):
|
||||
for block in block_list:
|
||||
docblock = DocBlock(block)
|
||||
docblock.dump()
|
||||
print "<<------------------->>"
|
||||
docblock = DocBlock( block )
|
||||
docblock.dump()
|
||||
print "<<------------------->>"
|
||||
|
||||
|
||||
#
|
||||
@ -566,64 +576,68 @@ def dump_doc_blocks( block_list ):
|
||||
#
|
||||
def dump_single_content( block_list ):
|
||||
|
||||
block = block_list[0]
|
||||
docblock = DocBlock(block)
|
||||
block = block_list[0]
|
||||
docblock = DocBlock( block )
|
||||
|
||||
print "<block>"
|
||||
for i in range(len(docblock.markers)):
|
||||
marker = docblock.markers[i]
|
||||
contents = docblock.contents[i]
|
||||
|
||||
print "<marker "+marker+">"
|
||||
doccontent = DocContent( contents )
|
||||
for i in range( len( docblock.markers ) ):
|
||||
marker = docblock.markers[i]
|
||||
contents = docblock.contents[i]
|
||||
|
||||
print "<marker " + marker + ">"
|
||||
doccontent = DocContent( contents )
|
||||
|
||||
doccontent.dump()
|
||||
|
||||
print "</marker>"
|
||||
|
||||
doccontent.dump()
|
||||
|
||||
print "</marker>"
|
||||
|
||||
print "</block>"
|
||||
|
||||
|
||||
def dump_doc_contents( block_list ):
|
||||
|
||||
for block in block_list:
|
||||
docblock = DocBlock(block)
|
||||
print "<block>"
|
||||
|
||||
for i in range(len(docblock.markers)):
|
||||
print "<marker "+docblock.markers[i]+">"
|
||||
content = DocContent( docblock.contents[i] )
|
||||
content.dump()
|
||||
print "</marker>"
|
||||
print "</block>"
|
||||
docblock = DocBlock( block )
|
||||
print "<block>"
|
||||
|
||||
for i in range( len( docblock.markers ) ):
|
||||
print "<marker " + docblock.markers[i] + ">"
|
||||
content = DocContent( docblock.contents[i] )
|
||||
content.dump()
|
||||
print "</marker>"
|
||||
print "</block>"
|
||||
|
||||
|
||||
def dump_html_1( block_list ):
|
||||
|
||||
print html_header
|
||||
|
||||
types = [ 'Type', 'Struct', 'FuncType', 'Function', 'Constant', 'Enumeration' ]
|
||||
types = [ 'Type', 'Struct', 'FuncType', 'Function', 'Constant',
|
||||
'Enumeration' ]
|
||||
|
||||
for block in block_list:
|
||||
|
||||
docblock = DocBlock(block[0],block[1])
|
||||
docblock = DocBlock( block[0], block[1] )
|
||||
|
||||
if len(docblock.markers) == 0:
|
||||
if len( docblock.markers ) == 0:
|
||||
continue
|
||||
|
||||
print block_header
|
||||
|
||||
for i in range(len(docblock.markers)):
|
||||
for i in range( len( docblock.markers ) ):
|
||||
marker = docblock.markers[i]
|
||||
content = docblock.contents[i]
|
||||
dcontent = DocContent( content )
|
||||
|
||||
if marker=="Description":
|
||||
if marker == "Description":
|
||||
print "<ul><p>"
|
||||
dcontent.dump()
|
||||
print "</p></ul>"
|
||||
|
||||
elif marker in types:
|
||||
print "<h3><font color=blue>"+content[0]+"</font></h3>"
|
||||
print "<h3><font color=blue>" + content[0] + "</font></h3>"
|
||||
else:
|
||||
print "<h4>"+marker+"</h4>"
|
||||
print "<h4>" + marker + "</h4>"
|
||||
print "<ul><p>"
|
||||
dcontent.dump_html()
|
||||
print "</p></ul>"
|
||||
@ -634,27 +648,29 @@ def dump_html_1( block_list ):
|
||||
|
||||
# print source code
|
||||
lines = block[1]
|
||||
l = len(lines)-1
|
||||
while (l >= 0) and string.strip(lines[l])=="":
|
||||
l = l-1
|
||||
l = len( lines ) - 1
|
||||
while l >= 0 and string.strip( lines[l] ) == "":
|
||||
l = l - 1
|
||||
print source_header
|
||||
for line in lines[0:l+1]:
|
||||
for line in lines[0 : l + 1]:
|
||||
print line
|
||||
print source_footer
|
||||
|
||||
print html_footer
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
def main(argv):
|
||||
def main( argv ):
|
||||
"""main program loop"""
|
||||
print "extracting comment blocks from sources .."
|
||||
sys.stderr.write( "extracting comment blocks from sources...\n" )
|
||||
list = make_block_list()
|
||||
|
||||
dump_html_1( list )
|
||||
|
||||
|
||||
# If called from the command line
|
||||
if __name__=='__main__': main(sys.argv)
|
||||
if __name__ == '__main__':
|
||||
main( sys.argv )
|
||||
|
||||
|
||||
# eof
|
||||
|
||||
@ -325,6 +325,8 @@
|
||||
/* Because of 32-bit charcodes defined in Unicode (i.e., surrogates), */
|
||||
/* all character codes must be expressed as FT_Longs. */
|
||||
/* */
|
||||
/* Other encodings might be defined in the future. */
|
||||
/* */
|
||||
typedef enum FT_Encoding_
|
||||
{
|
||||
ft_encoding_none = 0,
|
||||
@ -343,8 +345,6 @@
|
||||
|
||||
ft_encoding_apple_roman = FT_MAKE_TAG( 'a', 'r', 'm', 'n' )
|
||||
|
||||
/* other encodings might be defined in the future */
|
||||
|
||||
} FT_Encoding;
|
||||
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user