Re: [Qemu-devel] building rst docs with sphinx

2019-01-29 Thread Cole Robinson
On 1/28/19 9:18 PM, Stefan Hajnoczi wrote: On Thu, Jan 24, 2019 at 06:56:09PM +, Peter Maydell wrote: (1) configure: My thought is that we should just make sphinx-build a requirement for the existing --enable-docs switch (as texinfo and pod2man are currently). The disadvantage is that we won

Re: [Qemu-devel] building rst docs with sphinx

2019-01-29 Thread Daniel P . Berrangé
On Thu, Jan 24, 2019 at 06:56:09PM +, Peter Maydell wrote: > I had another look this afternoon at building our rST docs > with sphinx-build. In particular, we currently have some > docs in rst format, but we're not building them into HTML > or shipping them. (Predictably, this means a few error

Re: [Qemu-devel] building rst docs with sphinx

2019-01-29 Thread Peter Maydell
On Tue, 29 Jan 2019 at 10:36, Daniel P. Berrangé wrote: > On Thu, Jan 24, 2019 at 06:56:09PM +, Peter Maydell wrote: > > (1) configure: My thought is that we should just make > > sphinx-build a requirement for the existing --enable-docs > > switch (as texinfo and pod2man are currently). The >

Re: [Qemu-devel] building rst docs with sphinx

2019-01-28 Thread Stefan Hajnoczi
On Thu, Jan 24, 2019 at 06:56:09PM +, Peter Maydell wrote: > (1) configure: My thought is that we should just make > sphinx-build a requirement for the existing --enable-docs > switch (as texinfo and pod2man are currently). The > disadvantage is that we won't support a "build the half > of the

Re: [Qemu-devel] building rst docs with sphinx

2019-01-25 Thread Peter Maydell
On Thu, 24 Jan 2019 at 21:54, Philippe Mathieu-Daudé wrote: > > Hi Peter, > > On 1/24/19 7:56 PM, Peter Maydell wrote: > > I had another look this afternoon at building our rST docs > > with sphinx-build. In particular, we currently have some > > docs in rst format, but we're not building them int

Re: [Qemu-devel] building rst docs with sphinx

2019-01-24 Thread Philippe Mathieu-Daudé
Hi Peter, On 1/24/19 7:56 PM, Peter Maydell wrote: > I had another look this afternoon at building our rST docs > with sphinx-build. In particular, we currently have some > docs in rst format, but we're not building them into HTML > or shipping them. (Predictably, this means a few errors and > war

[Qemu-devel] building rst docs with sphinx

2019-01-24 Thread Peter Maydell
I had another look this afternoon at building our rST docs with sphinx-build. In particular, we currently have some docs in rst format, but we're not building them into HTML or shipping them. (Predictably, this means a few errors and warnings have crept in...) I had a play about with adding some m