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

[Anthony Liguori <aliguori@us.ibm.com>]

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 there are tools that can convert it
>> to relatively simple HTML.  That means we can build a make infrastructure that
>> generates a nice set of static web pages.
>>
>> The syntax is also more human friendly than mediawiki syntax.
>>
>> To see what the stylized version of this looks like, check out:
>>
>>    https://github.com/aliguori/qemu/tree/markdown/docs/specs
>>
>>
>
> 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 also 
converted qemu-doc.texi to a bunch of separate markdown files[1].

The info is fairly out of date.  I'll try to get patches out RSN so that we can 
all take a pass at trying to modernize some of the sections before the release.

[1] https://github.com/aliguori/qemu/tree/markdown/docs/manual

Regards,

Anthony Liguori