]>
git.ipfire.org Git - thirdparty/systemd.git/blob - make-man-rules.py
1 # -*- Mode: python; coding: utf-8; indent-tabs-mode: nil -*- */
3 # This file is part of systemd.
5 # Copyright 2013 Zbigniew Jędrzejewski-Szmek
7 # systemd is free software; you can redistribute it and/or modify it
8 # under the terms of the GNU Lesser General Public License as published by
9 # the Free Software Foundation; either version 2.1 of the License, or
10 # (at your option) any later version.
12 # systemd is distributed in the hope that it will be useful, but
13 # WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 # Lesser General Public License for more details.
17 # You should have received a copy of the GNU Lesser General Public License
18 # along with systemd; If not, see <http://www.gnu.org/licenses/>.
20 from __future__
import print_function
21 import xml
.etree
.ElementTree
as tree
44 # Do not edit. Generated by make-man-rules.py.
45 # Regenerate with 'make all update-man-list'.
55 HTML_ALIAS_RULE
= '''\
60 def man(page
, number
):
61 return 'man/{}.{}'.format(page
, number
)
63 def add_rules(rules
, name
):
64 xml
= tree
.parse(name
)
65 # print('parsing {}'.format(name), file=sys.stderr)
66 conditional
= xml
.getroot().get('conditional') or ''
67 rulegroup
= rules
[conditional
]
68 refmeta
= xml
.find('./refmeta')
69 title
= refmeta
.find('./refentrytitle').text
70 number
= refmeta
.find('./manvolnum').text
71 refnames
= xml
.findall('./refnamediv/refname')
72 target
= man(refnames
[0].text
, number
)
73 if title
!= refnames
[0].text
:
74 raise ValueError('refmeta and refnamediv disagree: ' + name
)
75 for refname
in refnames
:
76 assert all(refname
not in group
77 for group
in rules
.values()), "duplicate page name"
78 alias
= man(refname
.text
, number
)
79 rulegroup
[alias
] = target
80 # print('{} => {} [{}]'.format(alias, target, conditional), file=sys.stderr)
82 def create_rules(*xml_files
):
83 " {conditional => {alias-name => source-name}} "
84 rules
= collections
.defaultdict(dict)
85 for name
in xml_files
:
86 add_rules(rules
, name
)
90 return ' \\\n\t'.join(sorted(files
) or '#')
92 def make_makefile(rules
, cleanfiles
):
93 return HEADER
+ '\n'.join(
94 (CONDITIONAL
if conditional
else SECTION
).format(
95 manpages
=mjoin(set(rulegroup
.values())),
96 aliases
=mjoin(k
for k
,v
in rulegroup
.items() if k
!= v
),
97 rules
='\n'.join('{}: {}'.format(k
,v
)
98 for k
,v
in sorted(rulegroup
.items())
100 htmlrules
='\n'.join(HTML_ALIAS_RULE
.format(k
[:-2],v
[:-2])
101 for k
,v
in sorted(rulegroup
.items())
103 conditional
=conditional
)
104 for conditional
,rulegroup
in sorted(rules
.items())) + \
105 CLEANFILES
.format(cleanfiles
=mjoin(cleanfiles
))
107 if __name__
== '__main__':
108 sources
= set(sys
.argv
[1:])
109 basenames
= [os
.path
.basename(source
) for source
in sources
]
110 spares
= set([source
for source
in sources
111 if os
.path
.basename(source
) + '.in' in basenames
])
112 rules
= create_rules(*(sources
- spares
))
113 print(make_makefile(rules
, spares
), end
='')