Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-22 Thread Jon A. Cruz
On 12/19/2014 04:25 AM, Pekka Paalanen wrote: > On Fri, 12 Dec 2014 20:29:29 + > Daniel Stone wrote: > >> Hi, >> >> On Friday, December 12, 2014, Bill Spitzak wrote: >> ... >>> I would avoid the use of the term "double buffered". Possible alternative: >>> "The change does not happen until

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-19 Thread Pekka Paalanen
On Fri, 12 Dec 2014 20:29:29 + Daniel Stone wrote: > Hi, > > On Friday, December 12, 2014, Bill Spitzak wrote: > > > I think talking about a surface having multiple buffers is misleading. > > > > A wl_surface only knows about one buffer after commit: the last buffer > > attached to it. The

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-12 Thread Daniel Stone
Hi, On Friday, December 12, 2014, Bill Spitzak wrote: > I think talking about a surface having multiple buffers is misleading. > > A wl_surface only knows about one buffer after commit: the last buffer > attached to it. The wording being proposed here makes it sound like the > surface keeps trac

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-12 Thread Bill Spitzak
I think talking about a surface having multiple buffers is misleading. A wl_surface only knows about one buffer after commit: the last buffer attached to it. The wording being proposed here makes it sound like the surface keeps track of the previous buffer and expects or requires it to be used

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-12 Thread Giulio Camuffo
2014-12-12 21:37 GMT+02:00 Bryce Harrington : > On Thu, Dec 11, 2014 at 09:49:28AM +, Daniel Stone wrote: >> Hi, >> >> On Thursday, December 11, 2014, Giulio Camuffo >> wrote: >> >> > 2014-12-11 4:04 GMT+02:00 Bryce Harrington > > >: >> > > + A surface manages a rectangular grid of pixels

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-12 Thread Bryce Harrington
On Thu, Dec 11, 2014 at 09:49:28AM +, Daniel Stone wrote: > Hi, > > On Thursday, December 11, 2014, Giulio Camuffo > wrote: > > > 2014-12-11 4:04 GMT+02:00 Bryce Harrington > >: > > > + A surface manages a rectangular grid of pixels that clients create > > > + for displaying their

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-12 Thread Bryce Harrington
On Thu, Dec 11, 2014 at 10:28:25AM +0200, Giulio Camuffo wrote: > 2014-12-11 4:04 GMT+02:00 Bryce Harrington : > > > > Signed-off-by: Bryce Harrington > > --- > > doc/publican/sources/Protocol.xml | 20 +++- > > 1 file changed, 15 insertions(+), 5 deletions(-) > > > > diff --git

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-11 Thread Bryce Harrington
On Thu, Dec 11, 2014 at 09:49:28AM +, Daniel Stone wrote: > Hi, > > On Thursday, December 11, 2014, Giulio Camuffo > wrote: > > > 2014-12-11 4:04 GMT+02:00 Bryce Harrington > >: > > > + A surface manages a rectangular grid of pixels that clients create > > > + for displaying their

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-11 Thread Daniel Stone
Hi, On Thursday, December 11, 2014, Giulio Camuffo wrote: > 2014-12-11 4:04 GMT+02:00 Bryce Harrington >: > > + A surface manages a rectangular grid of pixels that clients create > > + for displaying their content to the screen. Clients don't know > > + the global position of th

Re: [PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-11 Thread Giulio Camuffo
2014-12-11 4:04 GMT+02:00 Bryce Harrington : > > Signed-off-by: Bryce Harrington > --- > doc/publican/sources/Protocol.xml | 20 +++- > 1 file changed, 15 insertions(+), 5 deletions(-) > > diff --git a/doc/publican/sources/Protocol.xml > b/doc/publican/sources/Protocol.xml > in

[PATCH wayland] doc: Fill in high level description for Surfaces

2014-12-10 Thread Bryce Harrington
Signed-off-by: Bryce Harrington --- doc/publican/sources/Protocol.xml | 20 +++- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/doc/publican/sources/Protocol.xml b/doc/publican/sources/Protocol.xml index b79b6be..2e48a7c 100644 --- a/doc/publican/sources/Protoc