[ovs-dev] [RFC 1/2] doc: Reduce duplication in 'man_pages'
Stephen Finucane
stephen at that.guru
Thu May 11 01:32:18 UTC 2017
All these entries are going to be roughly the same, with only two key
differences. Clarify things by focusing on those differences.
Signed-off-by: Stephen Finucane <stephen at that.guru>
---
Documentation/conf.py | 18 +++++++++++-------
1 file changed, 11 insertions(+), 7 deletions(-)
diff --git a/Documentation/conf.py b/Documentation/conf.py
index 6555747..d70ee6b 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -112,11 +112,15 @@ html_static_path = ['_static']
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
-man_pages = [
- ('ref/ovs-test.8', 'ovs-test',
- u'Check Linux drivers for performance, vlan and L3 tunneling problems',
- [author], 8),
- ('ref/ovs-vlan-test.8', 'ovs-vlan-test',
- u'Check Linux drivers for problems with vlan traffic',
- [author], 8)
+_man_pages = [
+ ('ovs-test.8',
+ u'Check Linux drivers for performance, vlan and L3 tunneling problems'),
+ ('ovs-vlan-test.8',
+ u'Check Linux drivers for problems with vlan traffic'),
]
+
+# Generate list of (path, name, description, [author, ...], section)
+man_pages = [
+ ('ref/%s' % filename, filename.split('.', 1)[0],
+ description, [author], filename.split('.', 1)[1])
+ for filename, description in _man_pages]
--
2.9.3
More information about the dev
mailing list