From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1LjIeB-0003FM-E3
	for qemu-devel@nongnu.org; Mon, 16 Mar 2009 15:38:51 -0400
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1LjIe6-0003EZ-6V
	for qemu-devel@nongnu.org; Mon, 16 Mar 2009 15:38:50 -0400
Received: from [199.232.76.173] (port=34759 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1LjIe6-0003EU-2L
	for qemu-devel@nongnu.org; Mon, 16 Mar 2009 15:38:46 -0400
Received: from rv-out-0708.google.com ([209.85.198.240]:43908)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <anthony@codemonkey.ws>) id 1LjIe5-0002iY-Oj
	for qemu-devel@nongnu.org; Mon, 16 Mar 2009 15:38:45 -0400
Received: by rv-out-0708.google.com with SMTP id k29so1434872rvb.22
	for <qemu-devel@nongnu.org>; Mon, 16 Mar 2009 12:38:43 -0700 (PDT)
Message-ID: <49BEAABF.6050908@codemonkey.ws>
Date: Mon, 16 Mar 2009 14:38:39 -0500
From: Anthony Liguori <anthony@codemonkey.ws>
MIME-Version: 1.0
Subject: Re: [Qemu-devel] [PATCH] [RFC] Syncing documentation vs. -help vs.
	qemu_options table v2
References: <f43fc5580903161223y2415f81cq5d4ec769ccc1396c@mail.gmail.com>
In-Reply-To: <f43fc5580903161223y2415f81cq5d4ec769ccc1396c@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Reply-To: qemu-devel@nongnu.org
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: qemu-devel@nongnu.org

Blue Swirl wrote:
> Hi,
>
> I converted all options to the new system. Because of problems with #
> and ' characters, I had to move from CPP to a Perl scripts. I'm sure
> any Perl expert worth their salt could compress the scripts much
> further. A comment token (HXCOMM?, deleted while parsing) would be
> nice, then there could be comments that describe the syntax and usage
> on top of options.hx.
>
> Comments? Objections?
>   

Adding a perl dependency is really painful for win32.  We could check in 
the resulting options.h but if we can find a way to do it with CPP, that 
would be much better.

Long term, I think there are better ways to generate the man page.  For 
instance, if we had a verbose help setting, we could make use of 
help2man.  But I think this is a step in the right direction (provided 
we can drop the perl dependency).

Regards,

Anthony Liguori

> A related idea: maybe the machine definition files should also enclose
> a mandatory TEXI description, leading to a generated list of machines
> and their devices for qemu-doc.texi.