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

[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
> > 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.

I was thinking of doing a2x for the man pages (which is more or less what git 
does).

The man pages are generated by qemu-doc.texi so I think I'm going to have to 
strip out the extracted info, but leave enough in qemu-doc.texi so that we can 
keep generating the man pages.  Once we clean up the user docs a bit, we can 
convert the man pages too.

Regards,

Anthony Liguori

>