Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Anthony Liguori
On 11/15/2011 12:06 PM, Stefan Weil wrote: Am 15.11.2011 14:44, schrieb Anthony Liguori: Markdown is nice for separated specs and README files, but is it also possible to create a complete printed manual from all markdown files? I think high quality information beats pretty formatting any day.

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Stefan Weil
Am 15.11.2011 14:44, schrieb Anthony Liguori: On 11/15/2011 02:28 AM, Avi Kivity wrote: On 11/15/2011 12:41 AM, Anthony Liguori wrote: Right now our specs are written in psuedo-wiki syntax. This series converts them to markdown. markdown is a simple markup format that's gaining in popularity

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Stefano Stabellini
On Tue, 15 Nov 2011, Alex Bradbury wrote: > On 15 November 2011 13:51, Avi Kivity wrote: > > Does markdown support rendering into man pages? > > You can do this via pandoc: > http://johnmacfarlane.net/pandoc/ Actually we are having the very same issue on xen right now: we have a manual written

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Anthony Liguori
On 11/15/2011 07:51 AM, Avi Kivity wrote: On 11/15/2011 03:44 PM, Anthony Liguori wrote: Nice. Suggest you enable rename detection, to make patches like these easier to read (not that it truly matters in the particular case). I haven't figured out yet how to make this sane to merge, but I've

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Alex Bradbury
On 15 November 2011 13:51, Avi Kivity wrote: > Does markdown support rendering into man pages? You can do this via pandoc: http://johnmacfarlane.net/pandoc/ Alex

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Avi Kivity
On 11/15/2011 03:44 PM, Anthony Liguori wrote: > On 11/15/2011 02:28 AM, Avi Kivity wrote: >> On 11/15/2011 12:41 AM, Anthony Liguori wrote: >>> Right now our specs are written in psuedo-wiki syntax. This series >>> converts >>> them to markdown. markdown is a simple markup format that's gaining

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Anthony Liguori
On 11/15/2011 02:28 AM, Avi Kivity wrote: On 11/15/2011 12:41 AM, Anthony Liguori wrote: Right now our specs are written in psuedo-wiki syntax. This series converts them to markdown. markdown is a simple markup format that's gaining in popularity. The big advantage of using markdown is that t

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-15 Thread Avi Kivity
On 11/15/2011 12:41 AM, Anthony Liguori wrote: > Right now our specs are written in psuedo-wiki syntax. This series converts > them to markdown. markdown is a simple markup format that's gaining in > popularity. > > The big advantage of using markdown is that there are tools that can convert > i

Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-14 Thread Stefan Weil
Am 14.11.2011 23:41, schrieb Anthony Liguori: Right now our specs are written in psuedo-wiki syntax. This series converts them to markdown. markdown is a simple markup format that's gaining in popularity. The big advantage of using markdown is that there are tools that can convert it to relati

[Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown

2011-11-14 Thread Anthony Liguori
Right now our specs are written in psuedo-wiki syntax. This series converts them to markdown. markdown is a simple markup format that's gaining in popularity. The big advantage of using markdown is that there are tools that can convert it to relatively simple HTML. That means we can build a mak