From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:4830:134:3::10]:33782)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mst@redhat.com>) id 1ZjEb5-0005dI-VJ
	for qemu-devel@nongnu.org; Mon, 05 Oct 2015 18:51:08 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mst@redhat.com>) id 1ZjEb0-0001sM-NC
	for qemu-devel@nongnu.org; Mon, 05 Oct 2015 18:51:07 -0400
Received: from mx1.redhat.com ([209.132.183.28]:44922)
	by eggs.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mst@redhat.com>) id 1ZjEb0-0001s5-If
	for qemu-devel@nongnu.org; Mon, 05 Oct 2015 18:51:02 -0400
Date: Tue, 6 Oct 2015 01:50:57 +0300
From: "Michael S. Tsirkin" <mst@redhat.com>
Message-ID: <20151006015015-mutt-send-email-mst@redhat.com>
References: <1442253680-8657-1-git-send-email-lvivier@redhat.com>
	<56127913.1090301@redhat.com>
	<20151006000149-mutt-send-email-mst@redhat.com>
	<5612F3F8.7010803@redhat.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <5612F3F8.7010803@redhat.com>
Subject: Re: [Qemu-devel] [PATCH v5 0/2] Improve -help
List-Id: <qemu-devel.nongnu.org>
List-Unsubscribe: <https://lists.nongnu.org/mailman/options/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.nongnu.org/archive/html/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <https://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: Laurent Vivier <lvivier@redhat.com>
Cc: marcandre.lureau@gmail.com, qemu-devel@nongnu.org, Paolo Bonzini <pbonzini@redhat.com>

On Tue, Oct 06, 2015 at 12:04:40AM +0200, Laurent Vivier wrote:
> 
> 
> On 05/10/2015 23:08, Michael S. Tsirkin wrote:
> > On Mon, Oct 05, 2015 at 03:20:19PM +0200, Laurent Vivier wrote:
> >> no more comments, it should mean it's ok ?
> >>
> >> Can someone merge this or just say "stop this, I don't want that"...
> >>
> >> Laurent
> > 
> > I'm afraid as a first step, we need to bring some order into -help.
> 
> I agree with your comments, but the aim of this series is not to change
> the content, only the container.

That's my point, with content as it is, changing the container
makes things worse not better IMHO.

> It will be easy to add sections once this done.
> 
> > I also suspect that a good place to start doing that is the man page.
> 
> Man page and help are generated from qemu-options.hx, so improving one
> is also
> improving the other, but I think I'm not the good guy to rewrite a man
> page... I'm a mechanic, not a writer :)
> 
> Thanks,
> Laurent