clutter 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

data/vendor/local/share/gir-1.0/Json-1.0.gir

@@ -207,7 +207,7 @@ See also: json_array_add_element(), json_node_set_string()</doc>
 element at @index_ inside a #JsonArray</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a copy of the #JsonNode at the requested
-  index. Use json_node_free() when done.</doc>
+  index. Use json_node_unref() when done.</doc>
           <type name="Node" c:type="JsonNode*"/>
         </return-value>
         <parameters>
@@ -221,6 +221,25 @@ element at @index_ inside a #JsonArray</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="equal" c:identifier="json_array_equal" version="1.2">
+        <doc xml:space="preserve">Check whether @a and @b are equal #JsonArrays, meaning they have the same
+number of elements, and the values of elements in corresponding positions
+are equal.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @a and @b are equal; %FALSE otherwise</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="a" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON array</doc>
+            <type name="Array" c:type="gconstpointer"/>
+          </instance-parameter>
+          <parameter name="b" transfer-ownership="none">
+            <doc xml:space="preserve">another JSON array</doc>
+            <type name="Array" c:type="gconstpointer"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="foreach_element"
               c:identifier="json_array_foreach_element"
               version="0.8">
@@ -245,7 +264,10 @@ remove elements from the @array.</doc>
             <doc xml:space="preserve">the function to be called on each element</doc>
             <type name="ArrayForeach" c:type="JsonArrayForeach"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -454,6 +476,39 @@ See also: json_array_get_element(), json_node_get_string()</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="hash" c:identifier="json_array_hash" version="1.2">
+        <doc xml:space="preserve">Calculate a hash value for the given @key (a #JsonArray).
+
+The hash is calculated over the array and all its elements, recursively. If
+the array is immutable, this is a fast operation; otherwise, it scales
+proportionally with the length of the array.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">hash value for @key</doc>
+          <type name="guint" c:type="guint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="key" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON array to hash</doc>
+            <type name="Array" c:type="gconstpointer"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="is_immutable"
+              c:identifier="json_array_is_immutable"
+              version="1.2">
+        <doc xml:space="preserve">Check whether the given @array has been marked as immutable by calling
+json_array_seal() on it.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the @array is immutable</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="array" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonArray</doc>
+            <type name="Array" c:type="JsonArray*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="ref" c:identifier="json_array_ref">
         <doc xml:space="preserve">Increase by one the reference count of a #JsonArray.</doc>
         <return-value transfer-ownership="none">
@@ -485,6 +540,21 @@ resources.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="seal" c:identifier="json_array_seal" version="1.2">
+        <doc xml:space="preserve">Seals the #JsonArray, making it immutable to further changes. This will
+recursively seal all elements in the array too.
+
+If the @array is already immutable, this is a no-op.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="array" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonArray</doc>
+            <type name="Array" c:type="JsonArray*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="unref" c:identifier="json_array_unref">
         <doc xml:space="preserve">Decreases by one the reference count of a #JsonArray. If the
 reference count reaches zero, the array is destroyed and all
@@ -520,7 +590,11 @@ this function. It is safe to change the value of @element_node.</doc>
           <doc xml:space="preserve">a #JsonNode containing the value at @index_</doc>
           <type name="Node" c:type="JsonNode*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="3">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
           <doc xml:space="preserve">data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -528,10 +602,9 @@ this function. It is safe to change the value of @element_node.</doc>
     </callback>
     <callback name="BoxedDeserializeFunc"
               c:type="JsonBoxedDeserializeFunc"
-              version="0.10"
-              introspectable="0">
+              version="0.10">
       <doc xml:space="preserve">Deserializes the contents of the passed #JsonNode into a #GBoxed</doc>
-      <return-value>
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">the newly created boxed type</doc>
         <type name="gpointer" c:type="gpointer"/>
       </return-value>
@@ -551,7 +624,10 @@ this function. It is safe to change the value of @element_node.</doc>
         <type name="Node" c:type="JsonNode*"/>
       </return-value>
       <parameters>
-        <parameter name="boxed" transfer-ownership="none">
+        <parameter name="boxed"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">a #GBoxed</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
@@ -575,6 +651,16 @@ JSON tree and obtain the root #JsonNode.</doc>
           <type name="Builder" c:type="JsonBuilder*"/>
         </return-value>
       </constructor>
+      <constructor name="new_immutable"
+                   c:identifier="json_builder_new_immutable"
+                   version="1.2">
+        <doc xml:space="preserve">Creates a new #JsonBuilder instance with its #JsonBuilder:immutable property
+set to %TRUE to create immutable output trees.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #JsonBuilder</doc>
+          <type name="Builder" c:type="JsonBuilder*"/>
+        </return-value>
+      </constructor>
       <method name="add_boolean_value"
               c:identifier="json_builder_add_boolean_value">
         <doc xml:space="preserve">If called after json_builder_set_member_name(), sets @value as member of the
@@ -771,7 +857,7 @@ Cannot be called after json_builder_set_member_name().</doc>
 (ie: all opened objects, object members and arrays are being closed).</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the #JsonNode, or %NULL if the build is not complete.
-  Free the returned value with json_node_free().</doc>
+  Free the returned value with json_node_unref().</doc>
           <type name="Node" c:type="JsonNode*"/>
         </return-value>
         <parameters>
@@ -814,6 +900,16 @@ Can be called only if the call is associated to an object.</doc>
           </parameter>
         </parameters>
       </method>
+      <property name="immutable"
+                version="1.2"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether the #JsonNode tree built by the #JsonBuilder should be immutable
+when created. Making the output immutable on creation avoids the expense
+of traversing it to make it immutable later.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <field name="parent_instance" readable="0" private="1">
         <type name="GObject.Object" c:type="GObject"/>
       </field>
@@ -1149,11 +1245,11 @@ stream.</doc>
       <doc xml:space="preserve">Json major version component (e.g. 1 if %JSON_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MICRO_VERSION" value="4" c:type="JSON_MICRO_VERSION">
+    <constant name="MICRO_VERSION" value="0" c:type="JSON_MICRO_VERSION">
       <doc xml:space="preserve">Json micro version component (e.g. 3 if %JSON_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
-    <constant name="MINOR_VERSION" value="0" c:type="JSON_MINOR_VERSION">
+    <constant name="MINOR_VERSION" value="2" c:type="JSON_MINOR_VERSION">
       <doc xml:space="preserve">Json minor version component (e.g. 2 if %JSON_VERSION is 1.2.3)</doc>
       <type name="gint" c:type="gint"/>
     </constant>
@@ -1195,8 +1291,12 @@ and it's the equivalent of:
         </parameters>
       </constructor>
       <method name="copy" c:identifier="json_node_copy">
-        <doc xml:space="preserve">Copies @node. If the node contains complex data types then the reference
-count of the objects is increased.</doc>
+        <doc xml:space="preserve">Copies @node. If the node contains complex data types, their reference
+counts are increased, regardless of whether the node is mutable or
+immutable.
+
+The copy will be immutable if, and only if, @node is immutable. However,
+there should be no need to copy an immutable node.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">the copied #JsonNode</doc>
           <type name="Node" c:type="JsonNode*"/>
@@ -1251,6 +1351,26 @@ the returned object is increased.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="equal" c:identifier="json_node_equal" version="1.2">
+        <doc xml:space="preserve">Check whether @a and @b are equal #JsonNodes, meaning they have the same
+type and same values (checked recursively). Note that integer values are
+compared numerically, ignoring type, so a double value 4.0 is equal to the
+integer value 4.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @a and @b are equal; %FALSE otherwise</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="a" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON node</doc>
+            <type name="Node" c:type="gconstpointer"/>
+          </instance-parameter>
+          <parameter name="b" transfer-ownership="none">
+            <doc xml:space="preserve">another JSON node</doc>
+            <type name="Node" c:type="gconstpointer"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="free" c:identifier="json_node_free">
         <doc xml:space="preserve">Frees the resources allocated by @node.</doc>
         <return-value transfer-ownership="none">
@@ -1405,6 +1525,24 @@ using it, call g_value_unset() on the #GValue.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="hash" c:identifier="json_node_hash" version="1.2">
+        <doc xml:space="preserve">Calculate a hash value for the given @key (a #JsonNode).
+
+The hash is calculated over the node and its value, recursively. If the node
+is immutable, this is a fast operation; otherwise, it scales proportionally
+with the size of the node’s value (for example, with the number of members
+in the #JsonObject if this node contains an object).</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">hash value for @key</doc>
+          <type name="guint" c:type="guint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="key" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON node to hash</doc>
+            <type name="Node" c:type="gconstpointer"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="init" c:identifier="json_node_init" version="0.16">
         <doc xml:space="preserve">Initializes a @node to a specific @type.
 
@@ -1586,6 +1724,22 @@ the given type, and any data contained will be cleared.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="is_immutable"
+              c:identifier="json_node_is_immutable"
+              version="1.2">
+        <doc xml:space="preserve">Check whether the given @node has been marked as immutable by calling
+json_node_seal() on it.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the @node is immutable</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="node" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonNode</doc>
+            <type name="Node" c:type="JsonNode*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="is_null" c:identifier="json_node_is_null" version="0.8">
         <doc xml:space="preserve">Checks whether @node is a %JSON_NODE_NULL.
 
@@ -1602,8 +1756,40 @@ A %JSON_NODE_NULL node is not the same as a %NULL #JsonNode; a
           </instance-parameter>
         </parameters>
       </method>
+      <method name="ref" c:identifier="json_node_ref" version="1.2">
+        <doc xml:space="preserve">Increment the reference count of @node.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a pointer to @node</doc>
+          <type name="Node" c:type="JsonNode*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="node" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonNode</doc>
+            <type name="Node" c:type="JsonNode*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="seal" c:identifier="json_node_seal" version="1.2">
+        <doc xml:space="preserve">Seals the #JsonNode, making it immutable to further changes. In order to be
+sealed, the @node must have a type and value set. The value will be
+recursively sealed — if the node holds an object, that #JsonObject will be
+sealed, etc.
+
+If the @node is already immutable, this is a no-op.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="node" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonNode</doc>
+            <type name="Node" c:type="JsonNode*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="set_array" c:identifier="json_node_set_array">
-        <doc xml:space="preserve">Sets @array inside @node and increases the #JsonArray reference count</doc>
+        <doc xml:space="preserve">Sets @array inside @node and increases the #JsonArray reference count.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1620,7 +1806,9 @@ A %JSON_NODE_NULL node is not the same as a %NULL #JsonNode; a
       </method>
       <method name="set_boolean" c:identifier="json_node_set_boolean">
         <doc xml:space="preserve">Sets @value as the boolean content of the @node, replacing any existing
-content.</doc>
+content.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1637,7 +1825,9 @@ content.</doc>
       </method>
       <method name="set_double" c:identifier="json_node_set_double">
         <doc xml:space="preserve">Sets @value as the double content of the @node, replacing any existing
-content.</doc>
+content.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1654,7 +1844,9 @@ content.</doc>
       </method>
       <method name="set_int" c:identifier="json_node_set_int">
         <doc xml:space="preserve">Sets @value as the integer content of the @node, replacing any existing
-content.</doc>
+content.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1670,7 +1862,11 @@ content.</doc>
         </parameters>
       </method>
       <method name="set_object" c:identifier="json_node_set_object">
-        <doc xml:space="preserve">Sets @objects inside @node. The reference count of @object is increased.</doc>
+        <doc xml:space="preserve">Sets @objects inside @node. The reference count of @object is increased.
+
+If @object is %NULL, the node’s existing object is cleared.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1679,7 +1875,10 @@ content.</doc>
             <doc xml:space="preserve">a #JsonNode initialized to %JSON_NODE_OBJECT</doc>
             <type name="Node" c:type="JsonNode*"/>
           </instance-parameter>
-          <parameter name="object" transfer-ownership="none">
+          <parameter name="object"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #JsonObject</doc>
             <type name="Object" c:type="JsonObject*"/>
           </parameter>
@@ -1688,7 +1887,10 @@ content.</doc>
       <method name="set_parent"
               c:identifier="json_node_set_parent"
               version="0.8">
-        <doc xml:space="preserve">Sets the parent #JsonNode of @node</doc>
+        <doc xml:space="preserve">Sets the parent #JsonNode of @node.
+
+It is an error to call this with an immutable @parent. @node may be
+immutable.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1705,7 +1907,9 @@ content.</doc>
       </method>
       <method name="set_string" c:identifier="json_node_set_string">
         <doc xml:space="preserve">Sets @value as the string content of the @node, replacing any existing
-content.</doc>
+content.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1721,7 +1925,9 @@ content.</doc>
         </parameters>
       </method>
       <method name="set_value" c:identifier="json_node_set_value">
-        <doc xml:space="preserve">Sets @value inside @node. The passed #GValue is copied into the #JsonNode</doc>
+        <doc xml:space="preserve">Sets @value inside @node. The passed #GValue is copied into the #JsonNode.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1737,7 +1943,9 @@ content.</doc>
         </parameters>
       </method>
       <method name="take_array" c:identifier="json_node_take_array">
-        <doc xml:space="preserve">Sets @array into @node without increasing the #JsonArray reference count.</doc>
+        <doc xml:space="preserve">Sets @array into @node without increasing the #JsonArray reference count.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1753,7 +1961,9 @@ content.</doc>
         </parameters>
       </method>
       <method name="take_object" c:identifier="json_node_take_object">
-        <doc xml:space="preserve">Sets @object inside @node. The reference count of @object is not increased.</doc>
+        <doc xml:space="preserve">Sets @object inside @node. The reference count of @object is not increased.
+
+It is an error to call this on an immutable node.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -1782,6 +1992,19 @@ content.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="unref" c:identifier="json_node_unref" version="1.2">
+        <doc xml:space="preserve">Decrement the reference count of @node. If it reaches zero, the node is
+freed.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="node" transfer-ownership="full">
+            <doc xml:space="preserve">a #JsonNode</doc>
+            <type name="Node" c:type="JsonNode*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
     </record>
     <enumeration name="NodeType"
                  glib:type-name="JsonNodeType"
@@ -1862,7 +2085,7 @@ This function will return if the @object already contains a member
 inside a #JsonObject</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a copy of the node for the requested
-  object member or %NULL. Use json_node_free() when done.</doc>
+  object member or %NULL. Use json_node_unref() when done.</doc>
           <type name="Node" c:type="JsonNode*"/>
         </return-value>
         <parameters>
@@ -1876,6 +2099,24 @@ inside a #JsonObject</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="equal" c:identifier="json_object_equal" version="1.2">
+        <doc xml:space="preserve">Check whether @a and @b are equal #JsonObjects, meaning they have the same
+set of members, and the values of corresponding members are equal.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @a and @b are equal; %FALSE otherwise</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="a" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON object</doc>
+            <type name="Object" c:type="gconstpointer"/>
+          </instance-parameter>
+          <parameter name="b" transfer-ownership="none">
+            <doc xml:space="preserve">another JSON object</doc>
+            <type name="Object" c:type="gconstpointer"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="foreach_member"
               c:identifier="json_object_foreach_member"
               version="0.8">
@@ -1900,7 +2141,10 @@ remove members from the @object.</doc>
             <doc xml:space="preserve">the function to be called on each member</doc>
             <type name="ObjectForeach" c:type="JsonObjectForeach"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to be passed to the function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -2059,11 +2303,13 @@ See also: json_object_get_member()</doc>
               c:identifier="json_object_get_object_member"
               version="0.8">
         <doc xml:space="preserve">Convenience function that retrieves the object
-stored in @member_name of @object
+stored in @member_name of @object. It is an error to specify a @member_name
+which does not exist.
 
 See also: json_object_get_member()</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the object inside the object's member</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the object inside the object’s
+   member, or %NULL if the value for the member is `null`</doc>
           <type name="Object" c:type="JsonObject*"/>
         </return-value>
         <parameters>
@@ -2147,6 +2393,39 @@ See also: json_object_get_member()</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="hash" c:identifier="json_object_hash" version="1.2">
+        <doc xml:space="preserve">Calculate a hash value for the given @key (a #JsonObject).
+
+The hash is calculated over the object and all its members, recursively. If
+the object is immutable, this is a fast operation; otherwise, it scales
+proportionally with the number of members in the object.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">hash value for @key</doc>
+          <type name="guint" c:type="guint"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="key" transfer-ownership="none">
+            <doc xml:space="preserve">a JSON object to hash</doc>
+            <type name="Object" c:type="gconstpointer"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="is_immutable"
+              c:identifier="json_object_is_immutable"
+              version="1.2">
+        <doc xml:space="preserve">Check whether the given @object has been marked as immutable by calling
+json_object_seal() on it.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if the @object is immutable</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="object" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonObject</doc>
+            <type name="Object" c:type="JsonObject*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="ref" c:identifier="json_object_ref">
         <doc xml:space="preserve">Increase by one the reference count of a #JsonObject.</doc>
         <return-value transfer-ownership="none">
@@ -2177,6 +2456,21 @@ See also: json_object_get_member()</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="seal" c:identifier="json_object_seal" version="1.2">
+        <doc xml:space="preserve">Seals the #JsonObject, making it immutable to further changes. This will
+recursively seal all members of the object too.
+
+If the @object is already immutable, this is a no-op.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="object" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonObject</doc>
+            <type name="Object" c:type="JsonObject*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="set_array_member"
               c:identifier="json_object_set_array_member"
               version="0.8">
@@ -2413,12 +2707,107 @@ this function. It is safe to change the value of @member_node.</doc>
           <doc xml:space="preserve">a #JsonNode containing the @member_name value</doc>
           <type name="Node" c:type="JsonNode*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="3">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="3">
           <doc xml:space="preserve">data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
       </parameters>
     </callback>
+    <record name="ObjectIter" c:type="JsonObjectIter" version="1.2">
+      <doc xml:space="preserve">An iterator used to iterate over the members of a #JsonObject. This must
+be allocated on the stack and initialised using json_object_iter_init().
+The order in which members are returned by the iterator is undefined. The
+iterator is invalidated if its #JsonObject is modified during iteration.
+
+All the fields in the #JsonObjectIter structure are private and should
+never be accessed directly.</doc>
+      <field name="priv_pointer" readable="0" private="1">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="6">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+      <field name="priv_int" readable="0" private="1">
+        <array zero-terminated="0" c:type="int" fixed-size="2">
+          <type name="gint" c:type="int"/>
+        </array>
+      </field>
+      <field name="priv_boolean" readable="0" private="1">
+        <array zero-terminated="0" c:type="gboolean" fixed-size="1">
+          <type name="gboolean" c:type="gboolean"/>
+        </array>
+      </field>
+      <method name="init" c:identifier="json_object_iter_init" version="1.2">
+        <doc xml:space="preserve">Initialise the @iter and associate it with @object.
+
+|[&lt;!-- language="C" --&gt;
+JsonObjectIter iter;
+const gchar *member_name;
+JsonNode *member_node;
+
+json_object_iter_init (&amp;iter, some_object);
+while (json_object_iter_next (&amp;iter, &amp;member_name, &amp;member_node))
+  {
+    // Do something with @member_name and @member_node.
+  }
+]|</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">an uninitialised #JsonObjectIter</doc>
+            <type name="ObjectIter" c:type="JsonObjectIter*"/>
+          </instance-parameter>
+          <parameter name="object" transfer-ownership="none">
+            <doc xml:space="preserve">the #JsonObject to iterate over</doc>
+            <type name="Object" c:type="JsonObject*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="next" c:identifier="json_object_iter_next" version="1.2">
+        <doc xml:space="preserve">Advance @iter and retrieve the next member in the object. If the end of the
+object is reached, %FALSE is returned and @member_name and @member_node are
+set to invalid values. After that point, the @iter is invalid.
+
+The order in which members are returned by the iterator is undefined. The
+iterator is invalidated if its #JsonObject is modified during iteration.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @member_name and @member_node are valid; %FALSE if the end
+   of the object has been reached</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">a #JsonObjectIter</doc>
+            <type name="ObjectIter" c:type="JsonObjectIter*"/>
+          </instance-parameter>
+          <parameter name="member_name"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return
+   location for the member name, or %NULL to ignore</doc>
+            <type name="utf8" c:type="const gchar**"/>
+          </parameter>
+          <parameter name="member_node"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return
+   location for the member value, or %NULL to ignore</doc>
+            <type name="Node" c:type="JsonNode**"/>
+          </parameter>
+        </parameters>
+      </method>
+    </record>
     <class name="Parser"
            c:symbol-prefix="parser"
            c:type="JsonParser"
@@ -2438,6 +2827,16 @@ hierarchy using the data types API.</doc>
           <type name="Parser" c:type="JsonParser*"/>
         </return-value>
       </constructor>
+      <constructor name="new_immutable"
+                   c:identifier="json_parser_new_immutable"
+                   version="1.2">
+        <doc xml:space="preserve">Creates a new #JsonParser instance with its #JsonParser:immutable property
+set to %TRUE to create immutable output trees.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #JsonParser</doc>
+          <type name="Parser" c:type="JsonParser*"/>
+        </return-value>
+      </constructor>
       <virtual-method name="array_element">
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
@@ -2759,7 +3158,10 @@ of the operation.</doc>
             <doc xml:space="preserve">a #GAsyncReadyCallback to call when the request is satisfied</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the data to pass to @callback</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -2788,6 +3190,16 @@ json_parser_load_from_stream_async().</doc>
           </parameter>
         </parameters>
       </method>
+      <property name="immutable"
+                version="1.2"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether the #JsonNode tree built by the #JsonParser should be immutable
+when created. Making the output immutable on creation avoids the expense
+of traversing it to make it immutable later.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <field name="parent_instance" readable="0" private="1">
         <type name="GObject.Object" c:type="GObject"/>
       </field>
@@ -2839,7 +3251,10 @@ an error in a JSON stream.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <parameter name="error" transfer-ownership="none">
+          <parameter name="error"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a pointer to the #GError</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -3189,7 +3604,7 @@ matches it against the JSON tree pointed by @root.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a newly-created #JsonNode of type
   %JSON_NODE_ARRAY containing an array of matching #JsonNodes.
-  Use json_node_free() when done</doc>
+  Use json_node_unref() when done</doc>
           <type name="Node" c:type="JsonNode*"/>
         </return-value>
         <parameters>
@@ -3236,7 +3651,7 @@ returned wrapped in a #JsonNode.</doc>
         <return-value transfer-ownership="full">
           <doc xml:space="preserve">a newly-created #JsonNode of type
   %JSON_NODE_ARRAY containing an array of matching #JsonNodes.
-  Use json_node_free() when done</doc>
+  Use json_node_unref() when done</doc>
           <type name="Node" c:type="JsonNode*"/>
         </return-value>
         <parameters>
@@ -3594,7 +4009,21 @@ json_reader_end_element (reader);
 
 If @reader is not currently on an array or an object, or if the @index_ is
 bigger than the size of the array or the object, the #JsonReader will be
-put in an error state until json_reader_end_element() is called.</doc>
+put in an error state until json_reader_end_element() is called. This means
+that if used conditionally, json_reader_end_element() must be called on both
+code paths:
+
+|[
+if (!json_reader_read_element (reader, 1))
+  {
+    json_reader_end_element (reader);
+    g_set_error (error, …);
+    return FALSE;
+  }
+
+str_value = json_reader_get_string_value (reader);
+json_reader_end_element (reader);
+]|</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, and %FALSE otherwise</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -3639,7 +4068,20 @@ json_reader_end_member (reader);
 
 If @reader is not currently on an object, or if the @member_name is not
 defined in the object, the #JsonReader will be put in an error state until
-json_reader_end_member() is called.</doc>
+json_reader_end_member() is called. This means that if used conditionally,
+json_reader_end_member() must be called on both code paths:
+
+|[
+if (!json_reader_read_member (reader, "title"))
+  {
+    json_reader_end_member (reader);
+    g_set_error (error, …);
+    return FALSE;
+  }
+
+str_value = json_reader_get_string_value (reader);
+json_reader_end_member (reader);
+]|</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">%TRUE on success, and %FALSE otherwise</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -4345,7 +4787,7 @@ sequence.</doc>
         </callback>
       </field>
     </record>
-    <constant name="VERSION_S" value="1.0.4" c:type="JSON_VERSION_S">
+    <constant name="VERSION_S" value="1.2.0" c:type="JSON_VERSION_S">
       <doc xml:space="preserve">JSON-GLib version, encoded as a string, useful for printing and
 concatenation.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -4401,7 +4843,7 @@ returns %TRUE and it's undefined otherwise.</doc>
               c:identifier="json_boxed_deserialize"
               version="0.10">
       <doc xml:space="preserve">Deserializes @node into a #GBoxed of @gboxed_type</doc>
-      <return-value transfer-ownership="full">
+      <return-value transfer-ownership="full" nullable="1">
         <doc xml:space="preserve">the newly allocated #GBoxed. Use
   g_boxed_free() to release the resources allocated by this
   function</doc>
@@ -4483,7 +4925,10 @@ into a #JsonNode</doc>
           <doc xml:space="preserve">a boxed type</doc>
           <type name="GType" c:type="GType"/>
         </parameter>
-        <parameter name="boxed" transfer-ownership="none">
+        <parameter name="boxed"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">a pointer to a #GBoxed of type @gboxed_type</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
@@ -4522,6 +4967,26 @@ Note: the JSON data stream must be an object declaration.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="from_string"
+              c:identifier="json_from_string"
+              version="1.2"
+              throws="1">
+      <doc xml:space="preserve">Parses the string in @str and returns a #JsonNode representing
+the JSON tree.
+
+In case of parsing error, this function returns %NULL and sets
+@error appropriately.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">a #JsonNode, or %NULL</doc>
+        <type name="Node" c:type="JsonNode*"/>
+      </return-value>
+      <parameters>
+        <parameter name="str" transfer-ownership="none">
+          <doc xml:space="preserve">a valid UTF-8 string containing JSON data</doc>
+          <type name="utf8" c:type="const char*"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="gobject_deserialize"
               c:identifier="json_gobject_deserialize"
               version="0.10">
@@ -4583,7 +5048,7 @@ instance. Each member of the returned JSON object will
 map to a property of the #GObject</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">the newly created #JsonNode
-  of type %JSON_NODE_OBJECT. Use json_node_free() to free
+  of type %JSON_NODE_OBJECT. Use json_node_unref() to free
   the resources allocated by this function</doc>
         <type name="Node" c:type="JsonNode*"/>
       </return-value>
@@ -4784,5 +5249,80 @@ translate the compatible types into JSON native types.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="string_compare"
+              c:identifier="json_string_compare"
+              version="1.2">
+      <doc xml:space="preserve">Check whether @a and @b are equal UTF-8 JSON strings and return an ordering
+over them in strcmp() style.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">an integer less than zero if @a &lt; @b, equal to zero if @a == @b, and
+   greater than zero if @a &gt; @b</doc>
+        <type name="gint" c:type="gint"/>
+      </return-value>
+      <parameters>
+        <parameter name="a" transfer-ownership="none">
+          <doc xml:space="preserve">a JSON string</doc>
+          <type name="utf8" c:type="gconstpointer"/>
+        </parameter>
+        <parameter name="b" transfer-ownership="none">
+          <doc xml:space="preserve">another JSON string</doc>
+          <type name="utf8" c:type="gconstpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="string_equal"
+              c:identifier="json_string_equal"
+              version="1.2">
+      <doc xml:space="preserve">Check whether @a and @b are equal UTF-8 JSON strings.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">%TRUE if @a and @b are equal; %FALSE otherwise</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </return-value>
+      <parameters>
+        <parameter name="a" transfer-ownership="none">
+          <doc xml:space="preserve">a JSON string</doc>
+          <type name="utf8" c:type="gconstpointer"/>
+        </parameter>
+        <parameter name="b" transfer-ownership="none">
+          <doc xml:space="preserve">another JSON string</doc>
+          <type name="utf8" c:type="gconstpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="string_hash" c:identifier="json_string_hash" version="1.2">
+      <doc xml:space="preserve">Calculate a hash value for the given @key (a UTF-8 JSON string).
+
+Note: Member names are compared byte-wise, without applying any Unicode
+decomposition or normalisation. This is not explicitly mentioned in the JSON
+standard (ECMA-404), but is assumed.</doc>
+      <return-value transfer-ownership="none">
+        <doc xml:space="preserve">hash value for @key</doc>
+        <type name="guint" c:type="guint"/>
+      </return-value>
+      <parameters>
+        <parameter name="key" transfer-ownership="none">
+          <doc xml:space="preserve">a JSON string to hash</doc>
+          <type name="utf8" c:type="gconstpointer"/>
+        </parameter>
+      </parameters>
+    </function>
+    <function name="to_string" c:identifier="json_to_string" version="1.2">
+      <doc xml:space="preserve">Generates a stringified JSON representation of the contents of
+the passed @node.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">the string representation of the #JsonNode</doc>
+        <type name="utf8" c:type="char*"/>
+      </return-value>
+      <parameters>
+        <parameter name="node" transfer-ownership="none">
+          <doc xml:space="preserve">a #JsonNode</doc>
+          <type name="Node" c:type="JsonNode*"/>
+        </parameter>
+        <parameter name="pretty" transfer-ownership="none">
+          <doc xml:space="preserve">whether the output should be prettyfied for printing</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </parameter>
+      </parameters>
+    </function>
   </namespace>
 </repository>