diff --git a/doc/publican/sources/Protocol.xml b/doc/publican/sources/Protocol.xml index 5f3e852..477063b 100644 --- a/doc/publican/sources/Protocol.xml +++ b/doc/publican/sources/Protocol.xml @@ -282,9 +282,16 @@
Surfaces - Surfaces are created by the client. - Clients don't know the global position of their surfaces, and - cannot access other clients surfaces. + 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 their surfaces, and cannot access other + clients' surfaces. + + + Once the client has finished writing pixels, it 'commits' the + buffer; this permits the compositor to access the buffer and read + the pixels. When the compositor is finished, it releases the + buffer back to the client. See for the protocol