Generate the qemu.1 manpage using Sphinx; we do this with a new top-level rst source file which is just the skeleton of the manpage and which includes .rst.inc fragments where it needs to incorporate sections from the larger HTML manuals. Signed-off-by: Peter Maydell <peter.maydell@linaro.org> Reviewed-by: Alex Bennée <alex.bennee@linaro.org> Tested-by: Alex Bennée <alex.bennee@linaro.org> Message-id: 20200228153619.9906-30-peter.maydell@linaro.org
		
			
				
	
	
		
			29 lines
		
	
	
		
			1017 B
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			29 lines
		
	
	
		
			1017 B
		
	
	
	
		
			Python
		
	
	
	
	
	
# -*- coding: utf-8 -*-
 | 
						|
#
 | 
						|
# QEMU documentation build configuration file for the 'system' manual.
 | 
						|
#
 | 
						|
# This includes the top level conf file and then makes any necessary tweaks.
 | 
						|
import sys
 | 
						|
import os
 | 
						|
 | 
						|
qemu_docdir = os.path.abspath("..")
 | 
						|
parent_config = os.path.join(qemu_docdir, "conf.py")
 | 
						|
exec(compile(open(parent_config, "rb").read(), parent_config, 'exec'))
 | 
						|
 | 
						|
# This slightly misuses the 'description', but is the best way to get
 | 
						|
# the manual title to appear in the sidebar.
 | 
						|
html_theme_options['description'] = u'System Emulation User''s Guide'
 | 
						|
 | 
						|
# One entry per manual page. List of tuples
 | 
						|
# (source start file, name, description, authors, manual section).
 | 
						|
man_pages = [
 | 
						|
    ('qemu-manpage', 'qemu', u'QEMU User Documentation',
 | 
						|
     ['Fabrice Bellard'], 1),
 | 
						|
    ('qemu-block-drivers', 'qemu-block-drivers',
 | 
						|
     u'QEMU block drivers reference',
 | 
						|
     ['Fabrice Bellard and the QEMU Project developers'], 7),
 | 
						|
    ('qemu-cpu-models', 'qemu-cpu-models',
 | 
						|
     u'QEMU CPU Models',
 | 
						|
     ['The QEMU Project developers'], 7)
 | 
						|
]
 |