On Wed, Feb 19, 2020 at 01:16:11PM +0000, Peter Maydell wrote:
[...]
> 3) we create a qemu-cpu-models.7 manpage, so the parts
> of Makefile that currently handle creating it from the
> texi need to be changed to do it from the rST instead.
> You can look at how we handle qemu-block-drivers.7
> for an example. Don't forget that you'll need to add
> a line to docs/system/conf.py to get Sphinx to build
> the manpage, as well as the makefile changes.
> You can check how the manpage renders with
> 'man -l /path/to/builddir/docs/interop/qemu-cpu-models.7'
Peter, how are you able to generate those *.7 `nroff` man pages? When I
do 'make sphinxbuild' from my build dir ($HOME/buld/qemu), I only see:
$> make sphinxdocs
[...]
make: Nothing to be done for 'sphinxdocs'.
$> ls -ls docs/system/ | awk '{print $10}';
genindex.html
index.html
objects.inv
qemu-block-drivers.html
qemu-cpu-models.html
search.html
searchindex.js
_static
No *.7 `nroff` files in docs/system/ nor in docs/interop/.
FWIW, I do have the below bit in docs/system/conf.py:
...
man_pages = [
('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',
['Fabrice Bellard and the QEMU Project developers'], 7)
]
...
[...]
--
/kashyap
