Xen 
 
Home About Xen.org Xen Xen Summit Wiki Mailing List Bug Tracker Xen Downloads
 
   
 

xen-devel

Re: [Xen-devel] Re: [Fwd: [Xen-changelog] Fix Jerone Young's xenstat / x

To: xen-devel@xxxxxxxxxxxxxxxxxxx
Subject: Re: [Xen-devel] Re: [Fwd: [Xen-changelog] Fix Jerone Young's xenstat / xenstore patch:]
From: Mark Williamson <mark.williamson@xxxxxxxxxxxx>
Date: Fri, 28 Oct 2005 00:41:29 +0100
Cc: Daniel Stekloff <dsteklof@xxxxxxxxxx>, Ewan Mellor <ewan@xxxxxxxxxxxxx>, Jerone Young <jyoung5@xxxxxxxxxx>, Josh Triplett <josh@xxxxxxxxxxxxxxx>
Delivery-date: Thu, 27 Oct 2005 23:39:52 +0000
Envelope-to: www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to: <20051027222425.GA23146@xxxxxxxxxxxxxxxxxxxxxx>
List-help: <mailto:xen-devel-request@lists.xensource.com?subject=help>
List-id: Xen developer discussion <xen-devel.lists.xensource.com>
List-post: <mailto:xen-devel@lists.xensource.com>
List-subscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=subscribe>
List-unsubscribe: <http://lists.xensource.com/cgi-bin/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=unsubscribe>
References: <1130429095.9330.6.camel@xxxxxxxxxxxxxxxxxxxxxxxxxxxx> <1130433106.9330.28.camel@xxxxxxxxxxxxxxxxxxxxxxxxxxxx> <20051027222425.GA23146@xxxxxxxxxxxxxxxxxxxxxx>
Sender: xen-devel-bounces@xxxxxxxxxxxxxxxxxxx
User-agent: KMail/1.8.3
> As far as I know, those references to man pages are big fat lies, and it
> would be very useful if you could write some.  I think that the command
> list in xm/main.py is pretty much up to date, so that's a good starting
> point, but it's worth checking them, obviously.

*even* nicer would be to have a Python script that groks through main.py and 
*generates* an up-to-date man page based on some template text, adding the 
help text for the current commands.

Non-live documentation tends to get broken very quickly, so anything that can 
be semi-automatically rebuilt is a definite plus.

Cheers,
Mark

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxx
http://lists.xensource.com/xen-devel