Re: [Qemu-devel] GSoC project: API Documentation Generation links and comments

2019-09-03 Thread Peter Maydell
On Tue, 27 Aug 2019 at 22:01, John Snow wrote: > > > > On 8/27/19 4:56 PM, Peter Maydell wrote: > > On Tue, 27 Aug 2019 at 21:52, John Snow wrote: > >> - For theming, I'm a fan of the RTD theme, because I think it makes the > >> TOC tree stand out better and makes for nicer browsing than the defa

Re: [Qemu-devel] GSoC project: API Documentation Generation links and comments

2019-08-27 Thread John Snow
On 8/27/19 4:56 PM, Peter Maydell wrote: > On Tue, 27 Aug 2019 at 21:52, John Snow wrote: >> - For theming, I'm a fan of the RTD theme, because I think it makes the >> TOC tree stand out better and makes for nicer browsing than the default >> alabaster theme. Maybe when there's a better over-ar

Re: [Qemu-devel] GSoC project: API Documentation Generation links and comments

2019-08-27 Thread Peter Maydell
On Tue, 27 Aug 2019 at 21:52, John Snow wrote: > - For theming, I'm a fan of the RTD theme, because I think it makes the > TOC tree stand out better and makes for nicer browsing than the default > alabaster theme. Maybe when there's a better over-arching TOC laid out > with better organization we

Re: [Qemu-devel] GSoC project: API Documentation Generation links and comments

2019-08-27 Thread John Snow
On 8/26/19 2:51 PM, Gabriel Barreto wrote: > I've uploaded to my github repository¹ the work done so far. Using > Peter's patches as a starting point, we were able to generate > kernel-docs documentation for some of QEMU's APIs. After studying the > available options, we found a nice solution to

[Qemu-devel] GSoC project: API Documentation Generation links and comments

2019-08-26 Thread Gabriel Barreto
I've uploaded to my github repository¹ the work done so far. Using Peter's patches as a starting point, we were able to generate kernel-docs documentation for some of QEMU's APIs. After studying the available options, we found a nice solution to publish the documentation online and keep it updated,