[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