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 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 >
Does markdown support rendering into man pages? A similar alternative is asciidoc, which is used by git. -- error compiling committee.c: too many arguments to function
