Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-23 Thread Daniel P. Berrange
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 misu

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-23 Thread Paolo Bonzini
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 man

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-23 Thread Markus Armbruster
Paolo Bonzini writes: > On 22/09/2015 10:16, Markus Armbruster wrote: > >> John Snow writes: >> >>> "To build QEMU, you'd generally [some basic steps that have generally >>> worked for a long time], but for up-to-date authoritative information, >>> please do: >>> >>> mkdir path_to/build_dir >>>

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-22 Thread Paolo Bonzini
On 22/09/2015 10:16, Markus Armbruster wrote: >> "To build QEMU, you'd generally [some basic steps that have generally >> worked for a long time], but for up-to-date authoritative information, >> please do: >> >> mkdir path_to/build_dir >> cd path_to/build_dir >> ../../configure >> make qemu-doc.

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-22 Thread Markus Armbruster
John Snow writes: > On 09/17/2015 12:43 PM, Markus Armbruster wrote: >> "Daniel P. Berrange" writes: >> >>> On Thu, Sep 17, 2015 at 01:20:43PM +0100, Peter Maydell wrote: On 17 September 2015 at 13:05, Daniel P. Berrange wrote: > On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Ma

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-21 Thread John Snow
On 09/17/2015 12:43 PM, Markus Armbruster wrote: > "Daniel P. Berrange" writes: > >> On Thu, Sep 17, 2015 at 01:20:43PM +0100, Peter Maydell wrote: >>> On 17 September 2015 at 13:05, Daniel P. Berrange >>> wrote: On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Maydell wrote: > On 17

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-21 Thread John Snow
On 09/17/2015 07:03 AM, Daniel P. Berrange wrote: > The README file is usually the first thing consulted when a user > or developer obtains a copy of the QEMU source. The current QEMU > README is lacking immediately useful information and so not very > friendly for first time encounters. It eithe

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Markus Armbruster
"Daniel P. Berrange" writes: > On Thu, Sep 17, 2015 at 01:20:43PM +0100, Peter Maydell wrote: >> On 17 September 2015 at 13:05, Daniel P. Berrange >> wrote: >> > On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Maydell wrote: >> >> On 17 September 2015 at 12:03, Daniel P. Berrange >> >> wrote:

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Peter Maydell
On 17 September 2015 at 13:36, Daniel P. Berrange wrote: > How about splitting "Chapter 6 Compilation" out of the qemu-doc.texi > file into a standalone file, in a format that is friendly to read > without needing generating first. Perhaps using something like > Markdown[1] would be a suitable th

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Daniel P. Berrange
On Thu, Sep 17, 2015 at 01:20:43PM +0100, Peter Maydell wrote: > On 17 September 2015 at 13:05, Daniel P. Berrange wrote: > > On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Maydell wrote: > >> On 17 September 2015 at 12:03, Daniel P. Berrange > >> wrote: > > > >> > +Building > >> > + >

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Peter Maydell
On 17 September 2015 at 13:05, Daniel P. Berrange wrote: > On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Maydell wrote: >> On 17 September 2015 at 12:03, Daniel P. Berrange >> wrote: > >> > +Building >> > + >> > + >> > +QEMU is multi-platform software intended to be buildable on all mo

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Daniel P. Berrange
On Thu, Sep 17, 2015 at 12:32:56PM +0100, Peter Maydell wrote: > On 17 September 2015 at 12:03, Daniel P. Berrange wrote: > > The README file is usually the first thing consulted when a user > > or developer obtains a copy of the QEMU source. The current QEMU > > README is lacking immediately usef

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Paolo Bonzini
On 17/09/2015 13:03, Daniel P. Berrange wrote: > + > +Licensing > += > + > + - QEMU as a whole is released under the GNU General Public License, > version 2. > + > + - Parts of QEMU have specific licenses which are compatible with the GNU > +General Public License, version 2. Hence

Re: [Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Peter Maydell
On 17 September 2015 at 12:03, Daniel P. Berrange wrote: > The README file is usually the first thing consulted when a user > or developer obtains a copy of the QEMU source. The current QEMU > README is lacking immediately useful information and so not very > friendly for first time encounters. It

[Qemu-devel] [PATCH] README: fill out some useful quickstart information

2015-09-17 Thread Daniel P. Berrange
The README file is usually the first thing consulted when a user or developer obtains a copy of the QEMU source. The current QEMU README is lacking immediately useful information and so not very friendly for first time encounters. It either redirects users to qemu-doc.html (which does not exist unt