diff --git a/Doc/tools/mkmodindex b/Doc/tools/mkmodindex index 893771e3146..16aa109e656 100755 --- a/Doc/tools/mkmodindex +++ b/Doc/tools/mkmodindex @@ -10,7 +10,8 @@ import sys _rx = re.compile( - '
([a-zA-Z_][a-zA-Z0-9_.]*)') + '
' + '([a-zA-Z_][a-zA-Z0-9_.]*(\s*\(.*\))?)') def main(): outputfile = "-" @@ -32,6 +33,7 @@ def main(): # nodes = [] seqno = 0 + has_plat_flag = 0 for ifn in args: if ifn == "-": ifp = sys.stdin @@ -47,14 +49,23 @@ def main(): if m: # This line specifies a module! basename, modname = m.group(1, 2) + has_plat_flag = has_plat_flag or m.group(3) linkfile = os.path.join(dirname, basename) - nodes.append(buildindex.Node('' % linkfile, - "%s" % modname, - seqno)) + nodes.append(buildindex.Node( + '' % linkfile, + "%s" % modname, + seqno)) seqno = seqno + 1 ifp.close() + # + # Generate all output: + # num_nodes = len(nodes) - html = HEAD + buildindex.process_nodes(nodes, columns, letters) + TAIL + # Here's the HTML generation: + parts = [HEAD, buildindex.process_nodes(nodes, columns, letters), TAIL] + if has_plat_flag: + parts.insert(1, PLAT_DISCUSS) + html = string.join(parts, '') program = os.path.basename(sys.argv[0]) if outputfile == "-": sys.stdout.write(html) @@ -97,6 +108,15 @@ HEAD = """\ Up: Python Documentation Index

+ +

Global Module Index

+ +""" + +PLAT_DISCUSS = """ +

Some module names are followed by an annotation indicating what +platform they are available on.

+ """ TAIL = """