[PATCH wayland 1/4] doc: Improve Wire Format section

Kristian Høgsberg hoegsberg at gmail.com
Tue Oct 9 19:44:08 PDT 2012


On Mon, Oct 08, 2012 at 06:39:57PM +0300, Tiago Vignatti wrote:
> Fixed the wayland socket name and added documentation for fixed format.

Thanks, this and the other three doc fixes applied.

Kristian

> Signed-off-by: Tiago Vignatti <tiago.vignatti at intel.com>
> ---
>  doc/Wayland/en_US/Protocol.xml |   22 +++++++++++++++++-----
>  1 file changed, 17 insertions(+), 5 deletions(-)
> 
> diff --git a/doc/Wayland/en_US/Protocol.xml b/doc/Wayland/en_US/Protocol.xml
> index 9a7db53..8927837 100644
> --- a/doc/Wayland/en_US/Protocol.xml
> +++ b/doc/Wayland/en_US/Protocol.xml
> @@ -59,9 +59,10 @@
>    <section id="sect-Protocol-Wire-Format">
>      <title>Wire Format</title>
>      <para>
> -      The protocol is sent over a UNIX domain stream socket.  Currently, the
> -      endpoint is named <systemitem class="service">\wayland</systemitem>,
> -      but it is subject to change.  The protocol is message-based.  A
> +      The protocol is sent over a UNIX domain stream socket, where the endpoint
> +      usually is named <systemitem class="service">wayland-0</systemitem>
> +      (although it can be changed via <emphasis>WAYLAND_DISPLAY</emphasis>
> +      in the environment).  The protocol is message-based.  A
>        message sent by a client to the server is called request.  A message
>        from the server to a client is called event.  Every message is
>        structured as 32-bit words, values are represented in the host's
> @@ -102,12 +103,23 @@
>  	  </listitem>
>  	</varlistentry>
>  	<varlistentry>
> +	  <term>fixed</term>
> +	  <listitem>
> +	    <para>
> +	      Signed 24.8 decimal numbers. It is a signed decimal type which
> +	      offers a sign bit, 23 bits of integer precision and 8 bits of
> +	      decimal precision. This is exposed as an opaque struct with
> +	      conversion helpers to and from double and int on the C API side.
> +	    </para>
> +	  </listitem>
> +	</varlistentry>
> +	<varlistentry>
>  	  <term>string</term>
>  	  <listitem>
>  	    <para>
>  	      Starts with an unsigned 32-bit length, followed by the
> -	      string contents, including terminating NUL byte, then padding to a
> -	      32-bit boundary.
> +	      string contents, including terminating null byte, then padding
> +	      to a 32-bit boundary.
>  	    </para>
>  	  </listitem>
>  	</varlistentry>
> -- 
> 1.7.9.5
> 
> _______________________________________________
> wayland-devel mailing list
> wayland-devel at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/wayland-devel


More information about the wayland-devel mailing list