Re: [Xen-devel] [PATCH] xl: use help table to describe command h

To:	Wei Yongjun <yjwei@xxxxxxxxxxxxxx>
Subject:	Re: [Xen-devel] [PATCH] xl: use help table to describe command help information
From:	Juergen Gross <juergen.gross@xxxxxxxxxxxxxx>
Date:	Mon, 10 May 2010 09:31:25 +0200
Cc:	"xen-devel@xxxxxxxxxxxxxxxxxxx" <xen-devel@xxxxxxxxxxxxxxxxxxx>
Delivery-date:	Mon, 10 May 2010 00:33:11 -0700
Dkim-signature:	v=1; a=rsa-sha256; c=simple/simple; d=ts.fujitsu.com; i=juergen.gross@xxxxxxxxxxxxxx; q=dns/txt; s=s1536b; t=1273476767; x=1305012767; h=message-id:date:from:mime-version:to:cc:subject: references:in-reply-to:content-transfer-encoding; z=Message-ID:=20<4BE7B64D.9070804@xxxxxxxxxxxxxx>\|Date:=20 Mon,=2010=20May=202010=2009:31:25=20+0200\|From:=20Juergen =20Gross=20<juergen.gross@xxxxxxxxxxxxxx>\|MIME-Version: =201.0\|To:=20Wei=20Yongjun=20<yjwei@xxxxxxxxxxxxxx>\|CC: =20"xen-devel@xxxxxxxxxxxxxxxxxxx"=20<xen-devel@xxxxxxxxx source.com>\|Subject:=20Re:=20[Xen-devel]=20[PATCH]=20xl: =20use=20help=20table=20to=20describe=20command=20help=0D =0A=20information\|References:=20<4BE7B0E3.5030604@xxxxxxx tsu.com>=20<4BE7B173.6000806@xxxxxxxxxxxxxx>\|In-Reply-To: =20<4BE7B173.6000806@xxxxxxxxxxxxxx> \|Content-Transfer-Encoding:=207bit; bh=zyD/yxMWNhJWKb0K+nfK1cKQVYFsdVgt66hNkwwMRjk=; b=hpVj2qKhPGA70Oavrttu4OShsGxm4QEAvqJfVTg2Kxh6BJNtH8Xs/a5t hDxXzGYZpLjZnzd6tEf5V0znXSoYYkALrMWeExc0Yjf82M5jvqn8JaEma O1SbhWsYNDBuznlGslL6foXV9uikZ5VH+PYrmxzbj+H420dbMgCThrqlr zB0iatbgXoqCnaQ7ir6w3KJsb6HTNag5/iy9Lm2whiDpV7AVg+1m6wOCk 1Q4iMkrhsb7nwrAIsjWA03B9S7KhV;
Domainkey-signature:	s=s1536a; d=ts.fujitsu.com; c=nofws; q=dns; h=X-SBRSScore:X-IronPort-AV:Received:X-IronPort-AV: Received:Received:Message-ID:Date:From:Organization: User-Agent:MIME-Version:To:CC:Subject:References: In-Reply-To:Content-Type:Content-Transfer-Encoding; b=rrxqkORQNCAeZI+6UOaWZgOplDM0GbTpOcrnWYwYuQVtRdxeGe1W6Bcn dAT6too110vPfaIwCmMYv+uhn8qYw/71o2a+XD4KL0qxwv7L2/3QCU91w 1SFS27CLEyjRlGRccUOlqVqsLwTXXrATGdQHUrSyFS9fAal1cPL5HQ9/K fNr0MP6W3ZdP23lKheTvsSS5Ar764ybEmKC4axyDOyqIWMST98mwwhgTl OjxWy4Mf/cv85VZfa4eGwg+sS48XK;
Envelope-to:	www-data@xxxxxxxxxxxxxxxxxxx
In-reply-to:	<4BE7B173.6000806@xxxxxxxxxxxxxx>
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/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=subscribe>
List-unsubscribe:	<http://lists.xensource.com/mailman/listinfo/xen-devel>, <mailto:xen-devel-request@lists.xensource.com?subject=unsubscribe>
Organization:	Fujitsu Technology Solutions
References:	<4BE7B0E3.5030604@xxxxxxxxxxxxxx> <4BE7B173.6000806@xxxxxxxxxxxxxx>
Sender:	xen-devel-bounces@xxxxxxxxxxxxxxxxxxx
User-agent:	Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.9) Gecko/20100411 Iceowl/1.0b1 Icedove/3.0.4

On 05/10/2010 09:10 AM, Wei Yongjun wrote:
> This patch generate a help table to describe command help
> information.

Wouldn't it be better to include the help information in the command table?
There you already have the command description which is part of the help text
as well.
Usage information should be another item in the table then.


Juergen

-- 
Juergen Gross                 Principal Developer Operating Systems
TSP ES&S SWE OS6                       Telephone: +49 (0) 89 3222 2967
Fujitsu Technology Solutions              e-mail: juergen.gross@xxxxxxxxxxxxxx
Domagkstr. 28                           Internet: ts.fujitsu.com
D-80807 Muenchen                 Company details: ts.fujitsu.com/imprint.html

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

WARNING - OLD ARCHIVES

xen-devel

Re: [Xen-devel] [PATCH] xl: use help table to describe command help info