From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:47530) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zeh2R-0001CU-Do for qemu-devel@nongnu.org; Wed, 23 Sep 2015 06:12:36 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Zeh2O-0003tB-0j for qemu-devel@nongnu.org; Wed, 23 Sep 2015 06:12:35 -0400 Received: from mx1.redhat.com ([209.132.183.28]:44143) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Zeh2N-0003t2-SH for qemu-devel@nongnu.org; Wed, 23 Sep 2015 06:12:31 -0400 Date: Wed, 23 Sep 2015 11:12:27 +0100 From: "Daniel P. Berrange" Message-ID: <20150923101227.GW15421@redhat.com> References: <20150917120538.GF24971@redhat.com> <20150917123627.GH24971@redhat.com> <87a8slc7yh.fsf@blackfin.pond.sub.org> <56005942.3080301@redhat.com> <871tdqrhqq.fsf@blackfin.pond.sub.org> <5601B6DD.5070508@redhat.com> <8737y5a2dt.fsf@blackfin.pond.sub.org> <56027828.2090003@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <56027828.2090003@redhat.com> Subject: Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information Reply-To: "Daniel P. Berrange" List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Paolo Bonzini Cc: Peter Maydell , John Snow , Markus Armbruster , QEMU Developers On Wed, Sep 23, 2015 at 12:00:08PM +0200, Paolo Bonzini wrote: > > > On 23/09/2015 11:52, Markus Armbruster wrote: > > > I don't think this is necessary. We should remove duplicate information > > > from qemu-doc.texi, developer documentation doesn't belong in manuals. > > > > Just to avoid misunderstandings: I wouldn't object to splitting > > qemu-doc.texi into a user manual and developer documentation. > > That really boils down to moving chapter 6 somewhere else; everything > else is user documentation. I think we should start with Dan's patch, > and then integrate it with any missing information from chapter 6. With GNU autotools you get a generic INSTALL file which describe the way you use configure to build. I'd suggest we just move chapter 6 to be an INSTALL file in plain text, and just have the README file point people in that direction. Keep qemu-doc.texi as purely the runtime usage manual Regards, Daniel -- |: http://berrange.com -o- http://www.flickr.com/photos/dberrange/ :| |: http://libvirt.org -o- http://virt-manager.org :| |: http://autobuild.org -o- http://search.cpan.org/~danberr/ :| |: http://entangle-photo.org -o- http://live.gnome.org/gtk-vnc :|