|
From: | Anthony Liguori |
Subject: | Re: [Qemu-devel] [PATCH] [RFC] Syncing documentation vs. -help vs. qemu_options table v2 |
Date: | Mon, 16 Mar 2009 14:38:39 -0500 |
User-agent: | Thunderbird 2.0.0.19 (X11/20090105) |
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.
[Prev in Thread] | Current Thread | [Next in Thread] |