[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2 1/2] docs: Convert qemu-cpu-models.texi to rST
From: |
Kashyap Chamarthy |
Subject: |
Re: [PATCH v2 1/2] docs: Convert qemu-cpu-models.texi to rST |
Date: |
Wed, 19 Feb 2020 17:40:07 +0100 |
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
Re: [PATCH v2 0/2] This small series does two things:, no-reply, 2020/02/19
qemu-cpu-models: Convert to rST; document other MSR bits [Was: Re: [PATCH v2 0/2] This small series does two things:], Kashyap Chamarthy, 2020/02/19