1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
#!/usr/bin/env python3
#
# kconfig2wiki - Kconfig to MediaWiki converter for
# https://www.coreboot.org/coreboot_Options
# based on http://landley.net/kdocs/make/menuconfig2html.py
#
# SPDX-License-Identifier: GPL-2.0-only
import glob
helplen = 0
extra_chapters = 0
##
## Remove quotes from Kconfig string options
##
def zapquotes(str):
if str[0]=='"': str = str[1:str.rfind('"')]
return str
##
## Escape HTML special characters
##
def htmlescape(str):
return str.strip().replace("&","&").replace("<","<").replace(">",">")
##
## Process Kconfig file
##
def readfile(filename):
import sys
global helplen
source=filename.replace("src/","").replace("/Kconfig","").replace("Kconfig","toplevel")
try:
lines = open(filename).read().split("\n")
except IOError:
sys.stderr.write("File %s missing\n" % filename)
return
config = None
description = None
configtype = None
for i in lines:
if helplen:
i = i.expandtabs()
if not len(i) or i[:helplen].isspace():
sys.stdout.write("%s<br />\n" % htmlescape(i))
continue
else:
helplen = 0
sys.stdout.write("</td></tr>\n")
words = i.strip().split(None,1)
if not len(words): continue
if words[0] in ("config", "menuconfig"):
config = words[1]
description = ""
elif words[0] in ("bool", "boolean", "tristate", "string", "hex", "int"):
configtype = htmlescape(zapquotes(words[0]))
if len(words)>1: description = htmlescape(zapquotes(words[1]))
elif words[0]=="prompt":
description = htmlescape(zapquotes(words[1]))
elif words[0] in ("help", "---help---"):
sys.stdout.write("<tr bgcolor=\"#eeeeee\">\n")
sys.stdout.write("<td>%s</td><td>%s</td><td>%s</td><td>%s</td><td>\n" % (config,source,configtype,description) )
helplen = len(i[:i.find(words[0])].expandtabs())
elif words[0] == "comment":
sys.stdout.write("<tr bgcolor=\"#eeeeee\">\n")
sys.stdout.write("<td></td><td>%s</td><td>(comment)</td><td></td><td>%s</td></tr>\n" % (source, htmlescape(zapquotes(words[1]))))
elif words[0]=="menu":
if len(words)>1:
temp = htmlescape(zapquotes(words[1]))
sys.stdout.write("<tr bgcolor=\"#6699dd\">\n")
sys.stdout.write("<td colspan=5>Menu: %s</td></tr>\n" % temp)
elif words[0] == "endmenu":
sys.stdout.write("\n")
elif words[0] == "source":
fn=zapquotes(words[1])
for name in glob.glob(fn):
readfile(name)
elif words[0] in ("default","depends", "select", "if", "endif", "#"): pass
#else: sys.stderr.write("unknown: %s\n" % i)
if helplen: sys.stdout.write("</td></tr>\n")
def main():
import sys, time
if len(sys.argv)!=3:
sys.stderr.write("Usage: kconfig2wiki kconfigfile version\n")
sys.exit(1)
sys.stdout.write("This is an automatically generated list of '''coreboot compile-time options'''.\n")
sys.stdout.write("\nLast update: %s\n" % sys.argv[2])
sys.stdout.write("<table border=\"0\" style=\"font-size: smaller\">\n");
sys.stdout.write("<tr bgcolor=\"#6699dd\">\n")
sys.stdout.write("<td align=\"left\">Option</td>\n")
sys.stdout.write("<td align=\"left\">Source</td>\n")
sys.stdout.write("<td align=\"left\">Format</td>\n")
sys.stdout.write("<td align=\"left\">Short Description</td>\n")
sys.stdout.write("<td align=\"left\">Description</td></tr>\n")
readfile(sys.argv[1])
sys.stdout.write("</table>\n")
if __name__ == "__main__":
main()
|
