From: Ian Douglas Scott <idscott@system76.com>
Date: Wed, 13 Jul 2022 04:23:55 +0000 (-0700)
Subject: Document which type are nullable, and wire format for null value
X-Git-Tag: upstream/1.22.0~43
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=60827b862e4f0ef2b5117df30494a7f5918dd8b1;p=platform%2Fupstream%2Fwayland.git

Document which type are nullable, and wire format for null value

Signed-off-by: Ian Douglas Scott <idscott@system76.com>
---

diff --git a/doc/publican/sources/Protocol.xml b/doc/publican/sources/Protocol.xml
index 580cecb..57d8835 100644
--- a/doc/publican/sources/Protocol.xml
+++ b/doc/publican/sources/Protocol.xml
@@ -151,7 +151,8 @@
 	    <para>
 	      Starts with an unsigned 32-bit length (including null terminator),
 	      followed by the string contents, including terminating null byte,
-	      then padding to a 32-bit boundary.
+	      then padding to a 32-bit boundary. A null value is represented
+	      with a length of 0.
 	    </para>
 	  </listitem>
 	</varlistentry>
@@ -159,7 +160,7 @@
 	  <term>object</term>
 	  <listitem>
 	    <para>
-	      32-bit object ID.
+	      32-bit object ID. A null value is represented with an ID of 0.
 	    </para>
 	  </listitem>
 	</varlistentry>
diff --git a/src/wayland-util.h b/src/wayland-util.h
index 18c512e..4d59231 100644
--- a/src/wayland-util.h
+++ b/src/wayland-util.h
@@ -118,7 +118,7 @@ struct wl_object;
  * * `n`: new_id
  * * `a`: array
  * * `h`: fd
- * * `?`: following argument is nullable
+ * * `?`: following argument (`o` or `s`) is nullable
  *
  * While demarshaling primitive arguments is straightforward, when demarshaling
  * messages containing `object` or `new_id` arguments, the protocol