From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([140.186.70.92]:35181) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQJJT-00060f-Hp for qemu-devel@nongnu.org; Tue, 15 Nov 2011 08:44:41 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RQJJP-0001uf-7w for qemu-devel@nongnu.org; Tue, 15 Nov 2011 08:44:35 -0500 Received: from e3.ny.us.ibm.com ([32.97.182.143]:47474) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RQJJP-0001ub-4h for qemu-devel@nongnu.org; Tue, 15 Nov 2011 08:44:31 -0500 Received: from /spool/local by e3.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 15 Nov 2011 08:44:29 -0500 Received: from d01av02.pok.ibm.com (d01av02.pok.ibm.com [9.56.224.216]) by d01relay07.pok.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id pAFDiQ2I3379312 for ; Tue, 15 Nov 2011 08:44:26 -0500 Received: from d01av02.pok.ibm.com (loopback [127.0.0.1]) by d01av02.pok.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id pAFDiQw9005569 for ; Tue, 15 Nov 2011 11:44:26 -0200 Message-ID: <4EC26CB8.5020508@us.ibm.com> Date: Tue, 15 Nov 2011 07:44:24 -0600 From: Anthony Liguori MIME-Version: 1.0 References: <1321310505-27845-1-git-send-email-aliguori@us.ibm.com> <4EC222A3.9010209@redhat.com> In-Reply-To: <4EC222A3.9010209@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 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