From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:33005) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQKLY-0005CV-RA for qemu-devel@nongnu.org; Tue, 15 Nov 2011 09:50:54 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQKLX-0004v8-Fl for qemu-devel@nongnu.org; Tue, 15 Nov 2011 09:50:48 -0500 Received: from e6.ny.us.ibm.com ([32.97.182.146]:58847) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQKLX-0004ul-Bp for qemu-devel@nongnu.org; Tue, 15 Nov 2011 09:50:47 -0500 Received: from /spool/local by e6.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 15 Nov 2011 09:50:44 -0500 Received: from d01av03.pok.ibm.com (d01av03.pok.ibm.com [9.56.224.217]) by d01relay03.pok.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id pAFEnoOp225206 for ; Tue, 15 Nov 2011 09:49:50 -0500 Received: from d01av03.pok.ibm.com (loopback [127.0.0.1]) by d01av03.pok.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id pAFEnn7i018554 for ; Tue, 15 Nov 2011 12:49:49 -0200 Message-ID: <4EC27C0C.6050809@us.ibm.com> Date: Tue, 15 Nov 2011 08:49:48 -0600 From: Anthony Liguori MIME-Version: 1.0 References: <1321310505-27845-1-git-send-email-aliguori@us.ibm.com> <4EC222A3.9010209@redhat.com> <4EC26CB8.5020508@us.ibm.com> <4EC26E6E.4030805@redhat.com> In-Reply-To: <4EC26E6E.4030805@redhat.com> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [Qemu-devel] [PATCH 0/5] docs: convert specifications to markdown List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Avi Kivity Cc: qemu-devel@nongnu.org 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 >