From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1NaxNI-0002Ur-1L
	for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:23:28 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1NaxNC-0002QW-Jb
	for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:23:26 -0500
Received: from [199.232.76.173] (port=38998 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1NaxNC-0002QO-C2
	for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:23:22 -0500
Received: from mail-px0-f189.google.com ([209.85.216.189]:36220)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <scottt.tw@gmail.com>) id 1NaxNC-0005sd-3m
	for qemu-devel@nongnu.org; Fri, 29 Jan 2010 15:23:22 -0500
Received: by pxi27 with SMTP id 27so1782743pxi.4
	for <qemu-devel@nongnu.org>; Fri, 29 Jan 2010 12:23:21 -0800 (PST)
MIME-Version: 1.0
In-Reply-To: <4B633A80.100@codemonkey.ws>
References: <4B633A80.100@codemonkey.ws>
Date: Sat, 30 Jan 2010 04:23:20 +0800
Message-ID: <ef2f888d1001291223o2f060df2lf4258a00a993d50b@mail.gmail.com>
Subject: Re: [Qemu-devel] [RFC] wiki.qemu.org
From: Scott Tsai <scottt.tw@gmail.com>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
List-Id: qemu-devel.nongnu.org
List-Unsubscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Anthony Liguori <anthony@codemonkey.ws>
Cc: qemu-devel <qemu-devel@nongnu.org>

On Sat, Jan 30, 2010 at 3:44 AM, Anthony Liguori <anthony@codemonkey.ws> wr=
ote:
> Hi,
>
> I've been (slowly) working to convert qemu.org to a wiki in order to allo=
w
> more community participation in the website. =C2=A0I've finally got a sit=
e setup
> and to my liking with all of the www.qemu.org content migrated.
>
> Before doing the switch, I need to figure out what to do with the current
> texi documentation. =C2=A0I think it makes sense to move qemu-doc.texi to=
 a wiki
> page and remove it from the source repository. =C2=A0The other option wou=
ld be to
> link to it as an external page and keep it within revision control.
>
> Does anyone have strong opinions one way or another?

To keep the code and documentation in sync, I suggest keeping the
portion generated from
qemu-img-cmds.hx, qemu-monitor.hx and qemu-options.hx in texinfo
format under revision control.
This encourages updating the documentation in the same patch that adds
new options and monitor commands.

The "QEMU System emulator for non PC targets" section in qemu-doc.texi
seems rather qemu version dependent as well? If true, moving this
information to a wiki risks the documentation not matching the qemu
version installed on users' machines.