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
