]>
Commit | Line | Data |
---|---|---|
81c58355 | 1 | #!/usr/bin/env python3 |
6e866b33 | 2 | # SPDX-License-Identifier: LGPL-2.1+ |
fb183854 MP |
3 | |
4 | from __future__ import print_function | |
5 | import collections | |
6 | import sys | |
7 | import os.path | |
81c58355 | 8 | import pprint |
f5e65279 | 9 | from xml_helper import xml_parse |
81c58355 | 10 | |
fb183854 | 11 | def man(page, number): |
f5e65279 | 12 | return '{}.{}'.format(page, number) |
fb183854 MP |
13 | |
14 | def xml(file): | |
f5e65279 | 15 | return os.path.basename(file) |
fb183854 MP |
16 | |
17 | def add_rules(rules, name): | |
18 | xml = xml_parse(name) | |
19 | # print('parsing {}'.format(name), file=sys.stderr) | |
20 | if xml.getroot().tag != 'refentry': | |
21 | return | |
22 | conditional = xml.getroot().get('conditional') or '' | |
23 | rulegroup = rules[conditional] | |
24 | refmeta = xml.find('./refmeta') | |
25 | title = refmeta.find('./refentrytitle').text | |
26 | number = refmeta.find('./manvolnum').text | |
27 | refnames = xml.findall('./refnamediv/refname') | |
28 | target = man(refnames[0].text, number) | |
29 | if title != refnames[0].text: | |
30 | raise ValueError('refmeta and refnamediv disagree: ' + name) | |
31 | for refname in refnames: | |
32 | assert all(refname not in group | |
33 | for group in rules.values()), "duplicate page name" | |
34 | alias = man(refname.text, number) | |
35 | rulegroup[alias] = target | |
36 | # print('{} => {} [{}]'.format(alias, target, conditional), file=sys.stderr) | |
37 | ||
38 | def create_rules(xml_files): | |
39 | " {conditional => {alias-name => source-name}} " | |
40 | rules = collections.defaultdict(dict) | |
41 | for name in xml_files: | |
42 | try: | |
43 | add_rules(rules, name) | |
44 | except Exception: | |
45 | print("Failed to process", name, file=sys.stderr) | |
46 | raise | |
47 | return rules | |
48 | ||
49 | def mjoin(files): | |
50 | return ' \\\n\t'.join(sorted(files) or '#') | |
51 | ||
81c58355 MB |
52 | MESON_HEADER = '''\ |
53 | # Do not edit. Generated by make-man-rules.py. | |
54 | manpages = [''' | |
55 | ||
56 | MESON_FOOTER = '''\ | |
57 | ] | |
58 | # Really, do not edit.''' | |
59 | ||
60 | def make_mesonfile(rules, dist_files): | |
61 | # reformat rules as | |
62 | # grouped = [ [name, section, [alias...], condition], ...] | |
63 | # | |
64 | # but first create a dictionary like | |
65 | # lists = { (name, condition) => [alias...] | |
66 | grouped = collections.defaultdict(list) | |
67 | for condition, items in rules.items(): | |
68 | for alias, name in items.items(): | |
69 | group = grouped[(name, condition)] | |
70 | if name != alias: | |
71 | group.append(alias) | |
72 | ||
73 | lines = [ [p[0][:-2], p[0][-1], sorted(a[:-2] for a in aliases), p[1]] | |
74 | for p, aliases in sorted(grouped.items()) ] | |
75 | return '\n'.join((MESON_HEADER, pprint.pformat(lines)[1:-1], MESON_FOOTER)) | |
76 | ||
fb183854 | 77 | if __name__ == '__main__': |
f5e65279 | 78 | pages = sys.argv[1:] |
81c58355 MB |
79 | |
80 | rules = create_rules(pages) | |
81 | dist_files = (xml(file) for file in pages | |
fb183854 MP |
82 | if not file.endswith(".directives.xml") and |
83 | not file.endswith(".index.xml")) | |
f5e65279 | 84 | print(make_mesonfile(rules, dist_files)) |