doc: Remove Shared Object Cache section
authorTiago Vignatti <tiago.vignatti@intel.com>
Mon, 8 Oct 2012 15:39:59 +0000 (18:39 +0300)
committerKristian Høgsberg <krh@bitplanet.net>
Wed, 10 Oct 2012 02:45:45 +0000 (22:45 -0400)
We don't support anything like that yet.

Signed-off-by: Tiago Vignatti <tiago.vignatti@intel.com>
doc/Wayland/en_US/Protocol.xml

index 943dd3b..1c22e0e 100644 (file)
       </listitem>
     </itemizedlist>
   </section>
-  <section id="sect-Protocol-Shared-Object-Cache">
-    <title>Shared Object Cache</title>
-    <para>
-      Cache for sharing glyphs, icons, cursors across clients.  Lets clients
-      share identical objects.  The cache is a global object, advertised at
-      connect time.
-      <programlisting>
-        Interface:      cache
-        Requests:       upload(key, visual, bo, stride, width, height)
-        Events:                item(key, bo, x, y, stride)
-                        retire(bo)
-      </programlisting>
-    </para>
-    <para>
-      <itemizedlist>
-       <listitem>
-         <para>
-           Upload by passing a visual, bo, stride, width, height to the
-           cache.
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           Upload returns a bo name, stride, and x, y location of object in
-           the buffer.  Clients take a reference on the atlas bo.
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           Shared objects are refcounted, freed by client (when purging
-           glyphs from the local cache) or when a client exits.
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           Server can't delete individual items from an atlas, but it can
-           throw out an entire atlas bo if it becomes too sparse.  The server
-           sends out an <type>retire</type> event when this happens, and clients
-           must throw away any objects from that bo and reupload.  Between the
-           server dropping the atlas and the client receiving the retire event,
-           clients can still legally use the old atlas since they have a ref on
-           the bo.
-         </para>
-       </listitem>
-       <listitem>
-         <para>
-           cairo needs to hook into the glyph cache, and maybe also a way
-           to create a read-only surface based on an object form the cache
-           (icons).
-           <function>cairo_wayland_create_cached_surface(surface-data)</function>
-         </para>
-       </listitem>
-      </itemizedlist>
-    </para>
-  </section>
   <section id="sect-Protocol-Drag-and-Drop">
     <title>Drag and Drop</title>
     <para>