Re: [Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-07-10 Thread Paolo Bonzini
On 10/07/2017 11:52, Stefan Hajnoczi wrote: > On Wed, Jul 05, 2017 at 06:08:58PM +0200, Paolo Bonzini wrote: >> On 22/06/2017 14:17, Stefan Hajnoczi wrote: >>> +@c man begin SYNOPSIS >>> +QEMU block driver reference manual >>> +@c man end >>> + >> >> I think this should be wrapped with @ignore /

Re: [Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-07-10 Thread Stefan Hajnoczi
On Wed, Jul 05, 2017 at 06:08:58PM +0200, Paolo Bonzini wrote: > On 22/06/2017 14:17, Stefan Hajnoczi wrote: > > +@c man begin SYNOPSIS > > +QEMU block driver reference manual > > +@c man end > > + > > I think this should be wrapped with @ignore / @end ignore. Otherwise > looks like a great idea.

Re: [Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-07-05 Thread Paolo Bonzini
On 22/06/2017 14:17, Stefan Hajnoczi wrote: > +@c man begin SYNOPSIS > +QEMU block driver reference manual > +@c man end > + I think this should be wrapped with @ignore / @end ignore. Otherwise looks like a great idea. Paolo

Re: [Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-07-05 Thread Stefan Hajnoczi
On Tue, Jun 27, 2017 at 10:20:10AM -0500, Eric Blake wrote: > Then again, much of your patch is just code motion, rather than new > documentation. So my comments are probably worth separate patches. Yes, they sound like good improvements to me but beyond the scope of this patch, which moves the e

Re: [Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-06-27 Thread Eric Blake
On 06/22/2017 07:17 AM, Stefan Hajnoczi wrote: > Block driver documentation is available in qemu-doc.html. It would be > convenient to have documentation for formats, protocols, and filter > drivers in a man page. > > Extract the relevant part of qemu-doc.html into a new file called > docs/qemu-b

[Qemu-devel] [PATCH] docs: add qemu-block-drivers(7) man page

2017-06-22 Thread Stefan Hajnoczi
Block driver documentation is available in qemu-doc.html. It would be convenient to have documentation for formats, protocols, and filter drivers in a man page. Extract the relevant part of qemu-doc.html into a new file called docs/qemu-block-drivers.texi. This file can also be built as a stand-