RubyGems - pango - Versions diffs - 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32 - Mend

pango 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

Files changed (351) hide show

data/vendor/local/lib/libpangowin32-1.0.dll.a CHANGED

Binary file

data/vendor/local/lib/libpangowin32-1.0.la CHANGED

@@ -1,5 +1,5 @@
 # libpangowin32-1.0.la - a libtool library file
-# Generated by libtool (GNU libtool) 2.4.2
+# Generated by libtool (GNU libtool) 2.4.6
 #
 # Please DO NOT delete this file!
 # It is necessary for linking the library.
@@ -13,19 +13,19 @@ library_names='libpangowin32-1.0.dll.a'
 # The name of the static archive.
 old_library=''
-# Linker flags that can not go in dependency_libs.
+# Linker flags that cannot go in dependency_libs.
 inherited_linker_flags=' -pthread'
 # Libraries that this one depends upon.
-dependency_libs=' -R/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib -L/home/vagrant/rcairo.win32/vendor/local/lib -L/home/vagrant/ruby-gnome2.win32/pango/vendor/local/lib /home/vagrant/ruby-gnome2.win32/pango/vendor/local/lib/libpango-1.0.la -L/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/../lib /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/../lib/libffi.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libgmodule-2.0.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libiconv.la -lgdi32'
+dependency_libs=' -R/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib -L/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib -L/home/vagrant/rcairo.win32/vendor/local/lib -L/home/vagrant/ruby-gnome2.win32/pango/vendor/local/lib /home/vagrant/ruby-gnome2.win32/pango/vendor/local/lib/libpango-1.0.la -L/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/../lib /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libgobject-2.0.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/../lib/libffi.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libgthread-2.0.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libglib-2.0.la -lws2_32 -lole32 -lwinmm -lshlwapi /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libpcre.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libintl.la /home/vagrant/ruby-gnome2.win32/glib2/vendor/local/lib/libiconv.la -lgdi32 -lusp10'
 # Names of additional weak libraries provided by this library
 weak_library_names=''
 # Version information for libpangowin32-1.0.
-current=3600
-age=3600
-revision=8
+current=4000
+age=4000
+revision=0
 # Is this an already installed library?
 installed=yes

data/vendor/local/lib/pkgconfig/harfbuzz-icu.pc CHANGED

@@ -5,7 +5,7 @@ includedir=/home/vagrant/ruby-gnome2.win32/pango/vendor/local/include
 Name: harfbuzz
 Description: HarfBuzz text shaping library ICU integration
-Version: 1.0.3
+Version: 1.2.4
 Requires: harfbuzz
 Requires.private: icu-uc

data/vendor/local/lib/pkgconfig/harfbuzz.pc CHANGED

@@ -5,9 +5,9 @@ includedir=/home/vagrant/ruby-gnome2.win32/pango/vendor/local/include
 Name: harfbuzz
 Description: HarfBuzz text shaping library
-Version: 1.0.3
+Version: 1.2.4
 Libs: -L${libdir} -lharfbuzz
-Libs.private:
+Libs.private:
 Requires.private: glib-2.0 >= 2.16
 Cflags: -I${includedir}/harfbuzz

data/vendor/local/lib/pkgconfig/icu-i18n.pc CHANGED

@@ -17,22 +17,22 @@ baselibs = -lpthread -lm
 #sbindir = ${exec_prefix}/sbin
 #mandir = ${datarootdir}/man
 #sysconfdir = ${prefix}/etc
-UNICODE_VERSION=7.0
+UNICODE_VERSION=8.0
 ICUPREFIX=icu
 ICULIBSUFFIX=
 LIBICU=lib${ICUPREFIX}
 #SHAREDLIBCFLAGS=-fPIC
-pkglibdir=${libdir}/icu${ICULIBSUFFIX}/55.1
-#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/55.1
-ICUDATA_NAME = icudt55l
+pkglibdir=${libdir}/icu${ICULIBSUFFIX}/57.1
+#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/57.1
+ICUDATA_NAME = icudt57l
 #ICUPKGDATA_DIR=${exec_prefix}/lib
 #ICUDATA_DIR=${pkgdatadir}
 ICUDESC=International Components for Unicode
-Version: 55.1
+Version: 57.1
 Cflags: -I${includedir}
 # end of icu.pc.in
 Description: International Components for Unicode: Internationalization library
 Name: icu-i18n
 Requires: icu-uc
-Libs: -licuin55
+Libs: -licuin57

data/vendor/local/lib/pkgconfig/icu-io.pc CHANGED

@@ -17,22 +17,22 @@ baselibs = -lpthread -lm
 #sbindir = ${exec_prefix}/sbin
 #mandir = ${datarootdir}/man
 #sysconfdir = ${prefix}/etc
-UNICODE_VERSION=7.0
+UNICODE_VERSION=8.0
 ICUPREFIX=icu
 ICULIBSUFFIX=
 LIBICU=lib${ICUPREFIX}
 #SHAREDLIBCFLAGS=-fPIC
-pkglibdir=${libdir}/icu${ICULIBSUFFIX}/55.1
-#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/55.1
-ICUDATA_NAME = icudt55l
+pkglibdir=${libdir}/icu${ICULIBSUFFIX}/57.1
+#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/57.1
+ICUDATA_NAME = icudt57l
 #ICUPKGDATA_DIR=${exec_prefix}/lib
 #ICUDATA_DIR=${pkgdatadir}
 ICUDESC=International Components for Unicode
-Version: 55.1
+Version: 57.1
 Cflags: -I${includedir}
 # end of icu.pc.in
 Description: International Components for Unicode: Stream and I/O Library
 Name: icu-io
 Requires: icu-i18n
-Libs: -licuio55
+Libs: -licuio57

data/vendor/local/lib/pkgconfig/icu-le.pc CHANGED

@@ -17,22 +17,22 @@ baselibs = -lpthread -lm
 #sbindir = ${exec_prefix}/sbin
 #mandir = ${datarootdir}/man
 #sysconfdir = ${prefix}/etc
-UNICODE_VERSION=7.0
+UNICODE_VERSION=8.0
 ICUPREFIX=icu
 ICULIBSUFFIX=
 LIBICU=lib${ICUPREFIX}
 #SHAREDLIBCFLAGS=-fPIC
-pkglibdir=${libdir}/icu${ICULIBSUFFIX}/55.1
-#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/55.1
-ICUDATA_NAME = icudt55l
+pkglibdir=${libdir}/icu${ICULIBSUFFIX}/57.1
+#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/57.1
+ICUDATA_NAME = icudt57l
 #ICUPKGDATA_DIR=${exec_prefix}/lib
 #ICUDATA_DIR=${pkgdatadir}
 ICUDESC=International Components for Unicode
-Version: 55.1
+Version: 57.1
 Cflags: -I${includedir}
 # end of icu.pc.in
 Description: International Components for Unicode: Layout library
 Name: icu-le
 Requires: icu-uc
-Libs: -licule55
+Libs: -licule57

data/vendor/local/lib/pkgconfig/icu-lx.pc CHANGED

@@ -17,22 +17,22 @@ baselibs = -lpthread -lm
 #sbindir = ${exec_prefix}/sbin
 #mandir = ${datarootdir}/man
 #sysconfdir = ${prefix}/etc
-UNICODE_VERSION=7.0
+UNICODE_VERSION=8.0
 ICUPREFIX=icu
 ICULIBSUFFIX=
 LIBICU=lib${ICUPREFIX}
 #SHAREDLIBCFLAGS=-fPIC
-pkglibdir=${libdir}/icu${ICULIBSUFFIX}/55.1
-#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/55.1
-ICUDATA_NAME = icudt55l
+pkglibdir=${libdir}/icu${ICULIBSUFFIX}/57.1
+#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/57.1
+ICUDATA_NAME = icudt57l
 #ICUPKGDATA_DIR=${exec_prefix}/lib
 #ICUDATA_DIR=${pkgdatadir}
 ICUDESC=International Components for Unicode
-Version: 55.1
+Version: 57.1
 Cflags: -I${includedir}
 # end of icu.pc.in
 Description: International Components for Unicode: Paragraph Layout library
 Name: icu-lx
 Requires: icu-le
-Libs: -liculx55
+Libs: -liculx57

data/vendor/local/lib/pkgconfig/icu-uc.pc CHANGED

@@ -17,22 +17,22 @@ baselibs = -lpthread -lm
 #sbindir = ${exec_prefix}/sbin
 #mandir = ${datarootdir}/man
 #sysconfdir = ${prefix}/etc
-UNICODE_VERSION=7.0
+UNICODE_VERSION=8.0
 ICUPREFIX=icu
 ICULIBSUFFIX=
 LIBICU=lib${ICUPREFIX}
 #SHAREDLIBCFLAGS=-fPIC
-pkglibdir=${libdir}/icu${ICULIBSUFFIX}/55.1
-#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/55.1
-ICUDATA_NAME = icudt55l
+pkglibdir=${libdir}/icu${ICULIBSUFFIX}/57.1
+#pkgdatadir=${datadir}/icu${ICULIBSUFFIX}/57.1
+ICUDATA_NAME = icudt57l
 #ICUPKGDATA_DIR=${exec_prefix}/lib
 #ICUDATA_DIR=${pkgdatadir}
 ICUDESC=International Components for Unicode
-Version: 55.1
+Version: 57.1
 Cflags: -I${includedir}
 # end of icu.pc.in
 Description: International Components for Unicode: Common and Data libraries
 Name: icu-uc
-Libs: -L${libdir} -licuuc55 -licudt55
+Libs: -L${libdir} -licuuc57 -licudt57
 Libs.private: ${baselibs}

data/vendor/local/lib/pkgconfig/pango.pc CHANGED

@@ -3,12 +3,10 @@ exec_prefix=${prefix}
 libdir=${exec_prefix}/lib
 includedir=${prefix}/include
-pango_module_version=1.8.0
 Name: Pango
 Description: Internationalized text handling
-Version: 1.36.8
+Version: 1.40.0
 Requires: glib-2.0 gobject-2.0
-Requires.private: gmodule-no-export-2.0
-Libs: -L${libdir} -lpango-1.0 -lm
+Libs: -L${libdir} -lpango-1.0
+Libs.private: -lm
 Cflags: -I${includedir}/pango-1.0

data/vendor/local/lib/pkgconfig/pangocairo.pc CHANGED

@@ -5,7 +5,8 @@ includedir=${prefix}/include
 Name: Pango Cairo
 Description: Cairo rendering support for Pango
-Version: 1.36.8
-Requires: pango cairo  pangoft2 pangowin32
+Version: 1.40.0
+Requires: pango cairo
+Requires.private:  pangoft2 pangowin32
 Libs: -L${libdir} -lpangocairo-1.0
 Cflags: -I${includedir}/pango-1.0

data/vendor/local/lib/pkgconfig/pangoft2.pc CHANGED

@@ -5,7 +5,7 @@ includedir=${prefix}/include
 Name: Pango FT2 and Pango Fc
 Description: Freetype 2.0 and fontconfig font support for Pango
-Version: 1.36.8
+Version: 1.40.0
 Requires: pango freetype2 fontconfig
 Requires.private: harfbuzz
 Libs: -L${libdir} -lpangoft2-1.0

data/vendor/local/lib/pkgconfig/pangowin32.pc CHANGED

@@ -5,7 +5,8 @@ includedir=${prefix}/include
 Name: Pango Win32
 Description: Win32 GDI font support for Pango
-Version: 1.36.8
+Version: 1.40.0
 Requires: pango
-Libs: -L${libdir} -lpangowin32-1.0 -lgdi32
+Libs: -L${libdir} -lpangowin32-1.0
+Libs.private: -lgdi32 -lusp10
 Cflags: -I${includedir}/pango-1.0

data/vendor/local/share/gir-1.0/Pango-1.0.gir CHANGED

@@ -189,16 +189,18 @@ are colors.</doc>
         <type name="Color" c:type="PangoColor"/>
       </field>
     </record>
-    <callback name="AttrDataCopyFunc"
-              c:type="PangoAttrDataCopyFunc"
-              introspectable="0">
+    <callback name="AttrDataCopyFunc" c:type="PangoAttrDataCopyFunc">
       <doc xml:space="preserve">Type of a function that can duplicate user data for an attribute.</doc>
-      <return-value>
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">new copy of @user_data.</doc>
         <type name="gpointer" c:type="gpointer"/>
       </return-value>
       <parameters>
-        <parameter name="user_data" transfer-ownership="none" closure="0">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="0">
           <doc xml:space="preserve">user data to copy</doc>
           <type name="gpointer" c:type="gconstpointer"/>
         </parameter>
@@ -216,7 +218,11 @@ filtering, %FALSE otherwise.</doc>
           <doc xml:space="preserve">a Pango attribute</doc>
           <type name="Attribute" c:type="PangoAttribute*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="1">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="1">
           <doc xml:space="preserve">user data passed to the function</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -264,6 +270,37 @@ and size simultaneously.</doc>
         </parameters>
       </function>
     </record>
+    <record name="AttrFontFeatures"
+            c:type="PangoAttrFontFeatures"
+            version="1.38">
+      <doc xml:space="preserve">The #PangoAttrFontFeatures structure is used to represent OpenType
+font features as an attribute.</doc>
+      <field name="attr" writable="1">
+        <doc xml:space="preserve">the common portion of the attribute</doc>
+        <type name="Attribute" c:type="PangoAttribute"/>
+      </field>
+      <field name="features" writable="1">
+        <doc xml:space="preserve">the featues, as a string in CSS syntax</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </field>
+      <function name="new"
+                c:identifier="pango_attr_font_features_new"
+                version="1.38"
+                introspectable="0">
+        <doc xml:space="preserve">Create a new font features tag attribute.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">the newly allocated #PangoAttribute,
+              which should be freed with pango_attribute_destroy().</doc>
+          <type name="Attribute" c:type="PangoAttribute*"/>
+        </return-value>
+        <parameters>
+          <parameter name="features" transfer-ownership="none">
+            <doc xml:space="preserve">a string with OpenType font features, in CSS syntax</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </function>
+    </record>
     <record name="AttrInt" c:type="PangoAttrInt">
       <doc xml:space="preserve">The #PangoAttrInt structure is used to represent attributes with
 an integer or enumeration value.</doc>
@@ -320,10 +357,10 @@ attributes currently in effect can be queried.</doc>
 location. When multiple attributes of the same type overlap,
 the attribute whose range starts closest to the current location
 is used.</doc>
-        <return-value>
-          <doc xml:space="preserve">the current attribute of the given type, or %NULL if
-              no attribute of that type applies to the current
-              location.</doc>
+        <return-value nullable="1">
+          <doc xml:space="preserve">the current attribute of the given type,
+              or %NULL if no attribute of that type applies to the
+              current location.</doc>
           <type name="Attribute" c:type="PangoAttribute*"/>
         </return-value>
         <parameters>
@@ -523,7 +560,7 @@ since it never removes or combines existing attributes.</doc>
       </method>
       <method name="copy" c:identifier="pango_attr_list_copy">
         <doc xml:space="preserve">Copy @list and return an identical new list.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the newly allocated #PangoAttrList, with a
               reference count of one, which should
               be freed with pango_attr_list_unref().
@@ -531,7 +568,10 @@ since it never removes or combines existing attributes.</doc>
           <type name="AttrList" c:type="PangoAttrList*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="list" transfer-ownership="none">
+          <instance-parameter name="list"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoAttrList, may be %NULL</doc>
             <type name="AttrList" c:type="PangoAttrList*"/>
           </instance-parameter>
@@ -543,9 +583,9 @@ since it never removes or combines existing attributes.</doc>
         <doc xml:space="preserve">Given a #PangoAttrList and callback function, removes any elements
 of @list for which @func returns %TRUE and inserts them into
 a new list.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the new #PangoAttrList or %NULL if
- no attributes of the given types were found.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the new #PangoAttrList or
+ %NULL if no attributes of the given types were found.</doc>
           <type name="AttrList" c:type="PangoAttrList*"/>
         </return-value>
         <parameters>
@@ -561,7 +601,10 @@ a new list.</doc>
        if an attribute should be filtered out.</doc>
             <type name="AttrFilterFunc" c:type="PangoAttrFilterFunc"/>
           </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 @func</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -630,7 +673,10 @@ be inserted before all other attributes with a matching
           <type name="AttrList" c:type="PangoAttrList*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="list" transfer-ownership="none">
+          <instance-parameter name="list"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoAttrList, may be %NULL</doc>
             <type name="AttrList" c:type="PangoAttrList*"/>
           </instance-parameter>
@@ -679,7 +725,10 @@ it contains.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="list" transfer-ownership="none">
+          <instance-parameter name="list"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoAttrList, may be %NULL</doc>
             <type name="AttrList" c:type="PangoAttrList*"/>
           </instance-parameter>
@@ -705,7 +754,7 @@ impose shape restrictions.</doc>
         <doc xml:space="preserve">user data set (see pango_attr_shape_new_with_data())</doc>
         <type name="gpointer" c:type="gpointer"/>
       </field>
-      <field name="copy_func" introspectable="0" writable="1">
+      <field name="copy_func" writable="1">
         <doc xml:space="preserve">copy function for the user data</doc>
         <type name="AttrDataCopyFunc" c:type="PangoAttrDataCopyFunc"/>
       </field>
@@ -757,7 +806,10 @@ rendering the glyph.</doc>
             <doc xml:space="preserve">logical rectangle to assign to each character</doc>
             <type name="Rectangle" c:type="const PangoRectangle*"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data pointer</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -997,6 +1049,24 @@ attribute is listed in parentheses after the description.</doc>
               glib:nick="gravity-hint">
         <doc xml:space="preserve">gravity hint (#PangoAttrInt)</doc>
       </member>
+      <member name="font_features"
+              value="23"
+              c:identifier="PANGO_ATTR_FONT_FEATURES"
+              glib:nick="font-features">
+        <doc xml:space="preserve">OpenType font features (#PangoAttrString). Since 1.38</doc>
+      </member>
+      <member name="foreground_alpha"
+              value="24"
+              c:identifier="PANGO_ATTR_FOREGROUND_ALPHA"
+              glib:nick="foreground-alpha">
+        <doc xml:space="preserve">foreground alpha (#PangoAttrInt). Since 1.38</doc>
+      </member>
+      <member name="background_alpha"
+              value="25"
+              c:identifier="PANGO_ATTR_BACKGROUND_ALPHA"
+              glib:nick="background-alpha">
+        <doc xml:space="preserve">background alpha (#PangoAttrInt). Since 1.38</doc>
+      </member>
       <function name="get_name"
                 c:identifier="pango_attr_type_get_name"
                 version="1.22">
@@ -1005,9 +1075,9 @@ pango_attr_type_register().
 The returned value is an interned string (see g_intern_string() for what
 that means) that should not be modified or freed.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the type ID name (which may be %NULL), or %NULL if @type is
-a built-in Pango attribute type or invalid.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the type ID name (which may be %NULL), or
+%NULL if @type is a built-in Pango attribute type or invalid.</doc>
           <type name="utf8" c:type="const char*"/>
         </return-value>
         <parameters>
@@ -1287,14 +1357,17 @@ represent a color in an uncalibrated RGB color-space.</doc>
 pango_color_free(). Primarily used by language bindings,
 not that useful otherwise (since colors can just be copied
 by assignment in C).</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoColor, which should
-              be freed with pango_color_free(), or %NULL
-              if @src was %NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoColor, which
+              should be freed with pango_color_free(), or %NULL if
+              @src was %NULL.</doc>
           <type name="Color" c:type="PangoColor*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="src" transfer-ownership="none">
+          <instance-parameter name="src"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">color to copy, may be %NULL</doc>
             <type name="Color" c:type="const PangoColor*"/>
           </instance-parameter>
@@ -1306,7 +1379,10 @@ by assignment in C).</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="color" transfer-ownership="none">
+          <instance-parameter name="color"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">an allocated #PangoColor, may be %NULL</doc>
             <type name="Color" c:type="PangoColor*"/>
           </instance-parameter>
@@ -1327,8 +1403,12 @@ forms is '&amp;num;fff' '&amp;num;ffffff' '&amp;num;fffffffff' and '&amp;num;fff
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
-          <instance-parameter name="color" transfer-ownership="none">
-            <doc xml:space="preserve">a #PangoColor structure in which to store the result, or %NULL</doc>
+          <instance-parameter name="color"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #PangoColor structure in which to store the
+  result, or %NULL</doc>
             <type name="Color" c:type="PangoColor*"/>
           </instance-parameter>
           <parameter name="spec" transfer-ownership="none">
@@ -1517,11 +1597,10 @@ pango_context_set_gravity_hint() for details.</doc>
               version="1.6">
         <doc xml:space="preserve">Gets the transformation matrix that will be applied when
 rendering with this context. See pango_context_set_matrix().</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the matrix, or %NULL if no matrix has been set
- (which is the same as the identity matrix). The returned
- matrix is owned by Pango and must not be modified or
- freed.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the matrix, or %NULL if no matrix has
+ been set (which is the same as the identity matrix). The returned
+ matrix is owned by Pango and must not be modified or freed.</doc>
           <type name="Matrix" c:type="const PangoMatrix*"/>
         </return-value>
         <parameters>
@@ -1632,9 +1711,9 @@ is only useful when implementing objects that need update when their
       <method name="load_font" c:identifier="pango_context_load_font">
         <doc xml:space="preserve">Loads the font in one of the fontmaps in the context
 that is the closest match for @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFont that
-         was loaded, or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoFont
+         that was loaded, or %NULL if no font matched.</doc>
           <type name="Font" c:type="PangoFont*"/>
         </return-value>
         <parameters>
@@ -1651,9 +1730,9 @@ that is the closest match for @desc.</doc>
       <method name="load_fontset" c:identifier="pango_context_load_fontset">
         <doc xml:space="preserve">Load a set of fonts in the context that can be used to render
 a font matching @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFontset loaded,
-         or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated
+         #PangoFontset loaded, or %NULL if no font matched.</doc>
           <type name="Fontset" c:type="PangoFontset*"/>
         </return-value>
         <parameters>
@@ -1958,9 +2037,9 @@ If the result is zero, free the coverage and all associated memory.</doc>
                 introspectable="0">
         <doc xml:space="preserve">Convert data generated from pango_coverage_to_bytes() back
 to a #PangoCoverage</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a newly allocated #PangoCoverage, or
-              %NULL if the data was invalid.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a newly allocated
+              #PangoCoverage, or %NULL if the data was invalid.</doc>
           <type name="Coverage" c:type="PangoCoverage*"/>
         </return-value>
         <parameters>
@@ -2092,14 +2171,18 @@ vertical text is handled in Pango.</doc>
     </enumeration>
     <constant name="ENGINE_TYPE_LANG"
               value="PangoEngineLang"
-              c:type="PANGO_ENGINE_TYPE_LANG">
+              c:type="PANGO_ENGINE_TYPE_LANG"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">A string constant defining the engine type for language engines.
 These engines derive from #PangoEngineLang.</doc>
       <type name="utf8" c:type="gchar*"/>
     </constant>
     <constant name="ENGINE_TYPE_SHAPE"
               value="PangoEngineShape"
-              c:type="PANGO_ENGINE_TYPE_SHAPE">
+              c:type="PANGO_ENGINE_TYPE_SHAPE"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">A string constant defining the engine type for shaping engines.
 These engines derive from #PangoEngineShape.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -2141,6 +2224,8 @@ with an ellipsis.</doc>
     <class name="Engine"
            c:symbol-prefix="engine"
            c:type="PangoEngine"
+           deprecated="1"
+           deprecated-version="1.38"
            parent="GObject.Object"
            abstract="1"
            glib:type-name="PangoEngine"
@@ -2154,13 +2239,18 @@ script specific engines. It has no functionality by itself.</doc>
     </class>
     <record name="EngineClass"
             c:type="PangoEngineClass"
-            glib:is-gtype-struct-for="Engine">
+            glib:is-gtype-struct-for="Engine"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">Class structure for #PangoEngine</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="GObject.ObjectClass" c:type="GObjectClass"/>
       </field>
     </record>
-    <record name="EngineInfo" c:type="PangoEngineInfo">
+    <record name="EngineInfo"
+            c:type="PangoEngineInfo"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">The #PangoEngineInfo structure contains information about a particular
 engine. It contains the following fields:</doc>
       <field name="id" writable="1">
@@ -2187,6 +2277,8 @@ engine. It contains the following fields:</doc>
     <class name="EngineLang"
            c:symbol-prefix="engine_lang"
            c:type="PangoEngineLang"
+           deprecated="1"
+           deprecated-version="1.38"
            parent="Engine"
            abstract="1"
            glib:type-name="PangoEngineLang"
@@ -2229,7 +2321,9 @@ lookups needed for that language.</doc>
     </class>
     <record name="EngineLangClass"
             c:type="PangoEngineLangClass"
-            glib:is-gtype-struct-for="EngineLang">
+            glib:is-gtype-struct-for="EngineLang"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">Class structure for #PangoEngineLang</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="EngineClass" c:type="PangoEngineClass"/>
@@ -2262,7 +2356,10 @@ lookups needed for that language.</doc>
         </callback>
       </field>
     </record>
-    <record name="EngineScriptInfo" c:type="PangoEngineScriptInfo">
+    <record name="EngineScriptInfo"
+            c:type="PangoEngineScriptInfo"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">The #PangoEngineScriptInfo structure contains
 information about how the shaper covers a particular script.</doc>
       <field name="script" writable="1">
@@ -2286,6 +2383,8 @@ languages for this range.</doc>
     <class name="EngineShape"
            c:symbol-prefix="engine_shape"
            c:type="PangoEngineShape"
+           deprecated="1"
+           deprecated-version="1.38"
            parent="Engine"
            abstract="1"
            glib:type-name="PangoEngineShape"
@@ -2355,7 +2454,9 @@ for Fontconfig-based backends.</doc>
     </class>
     <record name="EngineShapeClass"
             c:type="PangoEngineShapeClass"
-            glib:is-gtype-struct-for="EngineShape">
+            glib:is-gtype-struct-for="EngineShape"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">Class structure for #PangoEngineShape</doc>
       <field name="parent_class" readable="0" private="1">
         <type name="EngineClass" c:type="PangoEngineClass"/>
@@ -2539,13 +2640,16 @@ map that are still alive.  In that case this function will return %NULL.
 It is the responsibility of the user to ensure that the font map is kept
 alive.  In most uses this is not an issue as a #PangoContext holds
 a reference to the font map.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #PangoFontMap for the font, or %NULL
-              if @font is %NULL.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #PangoFontMap for the
+              font, or %NULL if @font is %NULL.</doc>
           <type name="FontMap" c:type="PangoFontMap*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont, or %NULL</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2566,7 +2670,10 @@ output variables and returns.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2610,7 +2717,10 @@ output variables and returns.</doc>
           <type name="FontMetrics" c:type="PangoFontMetrics*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2712,13 +2822,16 @@ map that are still alive.  In that case this function will return %NULL.
 It is the responsibility of the user to ensure that the font map is kept
 alive.  In most uses this is not an issue as a #PangoContext holds
 a reference to the font map.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #PangoFontMap for the font, or %NULL
-              if @font is %NULL.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #PangoFontMap for the
+              font, or %NULL if @font is %NULL.</doc>
           <type name="FontMap" c:type="PangoFontMap*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont, or %NULL</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2740,7 +2853,10 @@ output variables and returns.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2784,7 +2900,10 @@ output variables and returns.</doc>
           <type name="FontMetrics" c:type="PangoFontMetrics*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="font" transfer-ownership="none">
+          <instance-parameter name="font"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFont</doc>
             <type name="Font" c:type="PangoFont*"/>
           </instance-parameter>
@@ -2867,7 +2986,10 @@ output variables and returns.</doc>
             <type name="none" c:type="void"/>
           </return-value>
           <parameters>
-            <parameter name="font" transfer-ownership="none">
+            <parameter name="font"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">a #PangoFont</doc>
               <type name="Font" c:type="PangoFont*"/>
             </parameter>
@@ -2906,7 +3028,10 @@ output variables and returns.</doc>
             <type name="FontMetrics" c:type="PangoFontMetrics*"/>
           </return-value>
           <parameters>
-            <parameter name="font" transfer-ownership="none">
+            <parameter name="font"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">a #PangoFont</doc>
               <type name="Font" c:type="PangoFont*"/>
             </parameter>
@@ -2923,13 +3048,16 @@ output variables and returns.</doc>
       </field>
       <field name="get_font_map">
         <callback name="get_font_map">
-          <return-value transfer-ownership="none">
-            <doc xml:space="preserve">the #PangoFontMap for the font, or %NULL
-              if @font is %NULL.</doc>
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">the #PangoFontMap for the
+              font, or %NULL if @font is %NULL.</doc>
             <type name="FontMap" c:type="PangoFontMap*"/>
           </return-value>
           <parameters>
-            <parameter name="font" transfer-ownership="none">
+            <parameter name="font"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">a #PangoFont, or %NULL</doc>
               <type name="Font" c:type="PangoFont*"/>
             </parameter>
@@ -3017,14 +3145,18 @@ Note that @old_match must match @desc.</doc>
       </method>
       <method name="copy" c:identifier="pango_font_description_copy">
         <doc xml:space="preserve">Make a copy of a #PangoFontDescription.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFontDescription, which should
-              be freed with pango_font_description_free(), or %NULL
-              if @desc was %NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated
+              #PangoFontDescription, which should be freed with
+              pango_font_description_free(), or %NULL if @desc was
+              %NULL.</doc>
           <type name="FontDescription" c:type="PangoFontDescription*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="desc" transfer-ownership="none">
+          <instance-parameter name="desc"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFontDescription, may be %NULL</doc>
             <type name="FontDescription" c:type="const PangoFontDescription*"/>
           </instance-parameter>
@@ -3036,14 +3168,18 @@ Note that @old_match must match @desc.</doc>
 of the family name and other allocated fields. The result can only
 be used until @desc is modified or freed. This is meant to be used
 when the copy is only needed temporarily.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFontDescription, which should
-              be freed with pango_font_description_free(), or %NULL
-              if @desc was %NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated
+              #PangoFontDescription, which should be freed with
+              pango_font_description_free(), or %NULL if @desc was
+              %NULL.</doc>
           <type name="FontDescription" c:type="PangoFontDescription*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="desc" transfer-ownership="none">
+          <instance-parameter name="desc"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFontDescription, may be %NULL</doc>
             <type name="FontDescription" c:type="const PangoFontDescription*"/>
           </instance-parameter>
@@ -3077,7 +3213,10 @@ being loaded, but still compare %FALSE.)</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="desc" transfer-ownership="none">
+          <instance-parameter name="desc"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFontDescription, may be %NULL</doc>
             <type name="FontDescription" c:type="PangoFontDescription*"/>
           </instance-parameter>
@@ -3087,10 +3226,11 @@ being loaded, but still compare %FALSE.)</doc>
               c:identifier="pango_font_description_get_family">
         <doc xml:space="preserve">Gets the family name field of a font description. See
 pango_font_description_set_family().</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the family name field for the font description, or
-              %NULL if not previously set.  This has the same life-time
-              as the font description itself and should not be freed.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the family name field for the font
+              description, or %NULL if not previously set.  This
+              has the same life-time as the font description itself
+              and should not be freed.</doc>
           <type name="utf8" c:type="const char*"/>
         </return-value>
         <parameters>
@@ -3556,7 +3696,7 @@ fields will get back to their default values.</doc>
         <doc xml:space="preserve">Creates a new font description from a string representation in the
 form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a
 comma separated list of families optionally terminated by a comma,
-STYLE_OPTIONS is a whitespace separated list of words where each WORD
+STYLE_OPTIONS is a whitespace separated list of words where each word
 describes one of style, variant, weight, stretch, or gravity, and SIZE
 is a decimal number (size in points) or optionally followed by the
 unit modifier "px" for absolute size. Any one of the options may
@@ -3654,10 +3794,13 @@ are in Pango units and are sorted in ascending order.</doc>
           <parameter name="sizes"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
-            <doc xml:space="preserve">location to store a pointer
-        to an array of int. This array should be freed with
-        g_free().</doc>
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">
+        location to store a pointer to an array of int. This array
+        should be freed with g_free().</doc>
             <array length="1" zero-terminated="0" c:type="int**">
               <type name="gint" c:type="int*"/>
             </array>
@@ -3741,10 +3884,13 @@ are in Pango units and are sorted in ascending order.</doc>
           <parameter name="sizes"
                      direction="out"
                      caller-allocates="0"
-                     transfer-ownership="full">
-            <doc xml:space="preserve">location to store a pointer
-        to an array of int. This array should be freed with
-        g_free().</doc>
+                     transfer-ownership="full"
+                     nullable="1"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">
+        location to store a pointer to an array of int. This array
+        should be freed with g_free().</doc>
             <array length="1" zero-terminated="0" c:type="int**">
               <type name="gint" c:type="int*"/>
             </array>
@@ -3812,10 +3958,13 @@ are in Pango units and are sorted in ascending order.</doc>
             <parameter name="sizes"
                        direction="out"
                        caller-allocates="0"
-                       transfer-ownership="full">
-              <doc xml:space="preserve">location to store a pointer
-        to an array of int. This array should be freed with
-        g_free().</doc>
+                       transfer-ownership="full"
+                       nullable="1"
+                       optional="1"
+                       allow-none="1">
+              <doc xml:space="preserve">
+        location to store a pointer to an array of int. This array
+        should be freed with g_free().</doc>
               <array length="2" zero-terminated="0" c:type="int**">
                 <type name="gint" c:type="int*"/>
               </array>
@@ -4208,9 +4357,9 @@ in #PangoContext.</doc>
       </virtual-method>
       <virtual-method name="load_font" invoker="load_font">
         <doc xml:space="preserve">Load the font in the fontmap that is the closest match for @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFont loaded,
-         or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoFont
+         loaded, or %NULL if no font matched.</doc>
           <type name="Font" c:type="PangoFont*"/>
         </return-value>
         <parameters>
@@ -4231,9 +4380,9 @@ in #PangoContext.</doc>
       <virtual-method name="load_fontset" invoker="load_fontset">
         <doc xml:space="preserve">Load a set of fonts in the fontmap that can be used to render
 a font matching @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFontset
-         loaded, or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated
+         #PangoFontset loaded, or %NULL if no font matched.</doc>
           <type name="Fontset" c:type="PangoFontset*"/>
         </return-value>
         <parameters>
@@ -4325,7 +4474,9 @@ in #PangoContext.</doc>
       </method>
       <method name="get_shape_engine_type"
               c:identifier="pango_font_map_get_shape_engine_type"
-              version="1.4">
+              version="1.4"
+              deprecated="1"
+              deprecated-version="1.38">
         <doc xml:space="preserve">Returns the render ID for shape engines for this fontmap.
 See the &lt;structfield&gt;render_type&lt;/structfield&gt; field of
 #PangoEngineInfo.</doc>
@@ -4373,9 +4524,9 @@ See the &lt;structfield&gt;render_type&lt;/structfield&gt; field of
       </method>
       <method name="load_font" c:identifier="pango_font_map_load_font">
         <doc xml:space="preserve">Load the font in the fontmap that is the closest match for @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFont loaded,
-         or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoFont
+         loaded, or %NULL if no font matched.</doc>
           <type name="Font" c:type="PangoFont*"/>
         </return-value>
         <parameters>
@@ -4396,9 +4547,9 @@ See the &lt;structfield&gt;render_type&lt;/structfield&gt; field of
       <method name="load_fontset" c:identifier="pango_font_map_load_fontset">
         <doc xml:space="preserve">Load a set of fonts in the fontmap that can be used to render
 a font matching @desc.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoFontset
-         loaded, or %NULL if no font matched.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated
+         #PangoFontset loaded, or %NULL if no font matched.</doc>
           <type name="Fontset" c:type="PangoFontset*"/>
         </return-value>
         <parameters>
@@ -4435,9 +4586,9 @@ a particular #PangoFontMap implementation.</doc>
       </field>
       <field name="load_font">
         <callback name="load_font">
-          <return-value transfer-ownership="full">
-            <doc xml:space="preserve">the newly allocated #PangoFont loaded,
-         or %NULL if no font matched.</doc>
+          <return-value transfer-ownership="full" nullable="1">
+            <doc xml:space="preserve">the newly allocated #PangoFont
+         loaded, or %NULL if no font matched.</doc>
             <type name="Font" c:type="PangoFont*"/>
           </return-value>
           <parameters>
@@ -4491,9 +4642,9 @@ a particular #PangoFontMap implementation.</doc>
       </field>
       <field name="load_fontset">
         <callback name="load_fontset">
-          <return-value transfer-ownership="full">
-            <doc xml:space="preserve">the newly allocated #PangoFontset
-         loaded, or %NULL if no font matched.</doc>
+          <return-value transfer-ownership="full" nullable="1">
+            <doc xml:space="preserve">the newly allocated
+         #PangoFontset loaded, or %NULL if no font matched.</doc>
             <type name="Fontset" c:type="PangoFontset*"/>
           </return-value>
           <parameters>
@@ -4623,31 +4774,31 @@ for a font (possibly restricted to a script). The fields of this
 structure are private to implementations of a font backend. See
 the documentation of the corresponding getters for documentation
 of their meaning.</doc>
-      <field name="ref_count" writable="1">
+      <field name="ref_count" readable="0" private="1">
         <type name="guint" c:type="guint"/>
       </field>
-      <field name="ascent" writable="1">
+      <field name="ascent" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="descent" writable="1">
+      <field name="descent" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="approximate_char_width" writable="1">
+      <field name="approximate_char_width" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="approximate_digit_width" writable="1">
+      <field name="approximate_digit_width" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="underline_position" writable="1">
+      <field name="underline_position" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="underline_thickness" writable="1">
+      <field name="underline_thickness" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="strikethrough_position" writable="1">
+      <field name="strikethrough_position" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
-      <field name="strikethrough_thickness" writable="1">
+      <field name="strikethrough_thickness" readable="0" private="1">
         <type name="gint" c:type="int"/>
       </field>
       <constructor name="new" c:identifier="pango_font_metrics_new">
@@ -4798,12 +4949,15 @@ negative.</doc>
       </method>
       <method name="ref" c:identifier="pango_font_metrics_ref">
         <doc xml:space="preserve">Increase the reference count of a font metrics structure by one.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">@metrics</doc>
           <type name="FontMetrics" c:type="PangoFontMetrics*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="metrics" transfer-ownership="none">
+          <instance-parameter name="metrics"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFontMetrics structure, may be %NULL</doc>
             <type name="FontMetrics" c:type="PangoFontMetrics*"/>
           </instance-parameter>
@@ -4817,7 +4971,10 @@ memory.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="metrics" transfer-ownership="none">
+          <instance-parameter name="metrics"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoFontMetrics structure, may be %NULL</doc>
             <type name="FontMetrics" c:type="PangoFontMetrics*"/>
           </instance-parameter>
@@ -4856,7 +5013,10 @@ each one. If @func returns %TRUE, that stops the iteration.</doc>
             <doc xml:space="preserve">Callback function</doc>
             <type name="FontsetForeachFunc" c:type="PangoFontsetForeachFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to the callback function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4925,7 +5085,10 @@ each one. If @func returns %TRUE, that stops the iteration.</doc>
             <doc xml:space="preserve">Callback function</doc>
             <type name="FontsetForeachFunc" c:type="PangoFontsetForeachFunc"/>
           </parameter>
-          <parameter name="data" transfer-ownership="none">
+          <parameter name="data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">data to pass to the callback function</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -5041,7 +5204,10 @@ a particular #PangoFontset implementation.</doc>
               <type name="FontsetForeachFunc"
                     c:type="PangoFontsetForeachFunc"/>
             </parameter>
-            <parameter name="data" transfer-ownership="none">
+            <parameter name="data"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
               <doc xml:space="preserve">data to pass to the callback function</doc>
               <type name="gpointer" c:type="gpointer"/>
             </parameter>
@@ -5095,7 +5261,11 @@ the fonts in a fontset.</doc>
           <doc xml:space="preserve">a font from @fontset</doc>
           <type name="Font" c:type="PangoFont*"/>
         </parameter>
-        <parameter name="user_data" transfer-ownership="none" closure="2">
+        <parameter name="user_data"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1"
+                   closure="2">
           <doc xml:space="preserve">callback data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -5233,9 +5403,11 @@ As an example of the usage of #PangoGlyphItem, the results
 of shaping text with #PangoLayout is a list of #PangoLayoutLine,
 each of which contains a list of #PangoGlyphItem.</doc>
       <field name="item" writable="1">
+        <doc xml:space="preserve">corresponding #PangoItem.</doc>
         <type name="Item" c:type="PangoItem*"/>
       </field>
       <field name="glyphs" writable="1">
+        <doc xml:space="preserve">corresponding #PangoGlyphString.</doc>
         <type name="GlyphString" c:type="PangoGlyphString*"/>
       </field>
       <method name="apply_attrs"
@@ -5283,14 +5455,17 @@ as one of the elements in the list.</doc>
       </method>
       <method name="copy" c:identifier="pango_glyph_item_copy" version="1.20">
         <doc xml:space="preserve">Make a deep copy of an existing #PangoGlyphItem structure.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the newly allocated #PangoGlyphItem, which should
               be freed with pango_glyph_item_free(), or %NULL
               if @orig was %NULL.</doc>
           <type name="GlyphItem" c:type="PangoGlyphItem*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="orig" transfer-ownership="none">
+          <instance-parameter name="orig"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphItem, may be %NULL</doc>
             <type name="GlyphItem" c:type="PangoGlyphItem*"/>
           </instance-parameter>
@@ -5302,7 +5477,10 @@ as one of the elements in the list.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="glyph_item" transfer-ownership="none">
+          <instance-parameter name="glyph_item"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphItem, may be %NULL</doc>
             <type name="GlyphItem" c:type="PangoGlyphItem*"/>
           </instance-parameter>
@@ -5481,14 +5659,17 @@ None of the members of a #PangoGlyphItemIter should be modified manually.</doc>
               c:identifier="pango_glyph_item_iter_copy"
               version="1.22">
         <doc xml:space="preserve">Make a shallow copy of an existing #PangoGlyphItemIter structure.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">the newly allocated #PangoGlyphItemIter, which should
               be freed with pango_glyph_item_iter_free(), or %NULL
               if @orig was %NULL.</doc>
           <type name="GlyphItemIter" c:type="PangoGlyphItemIter*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="orig" transfer-ownership="none">
+          <instance-parameter name="orig"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphItemIter, may be %NULL</doc>
             <type name="GlyphItemIter" c:type="PangoGlyphItemIter*"/>
           </instance-parameter>
@@ -5502,7 +5683,10 @@ None of the members of a #PangoGlyphItemIter should be modified manually.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="iter" transfer-ownership="none">
+          <instance-parameter name="iter"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphItemIter, may be %NULL</doc>
             <type name="GlyphItemIter" c:type="PangoGlyphItemIter*"/>
           </instance-parameter>
@@ -5603,12 +5787,19 @@ of glyphs with geometry and visual attribute information.
 The storage for the glyph information is owned
 by the structure which simplifies memory management.</doc>
       <field name="num_glyphs" writable="1">
+        <doc xml:space="preserve">number of the glyphs in this glyph string.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="glyphs" writable="1">
-        <type name="GlyphInfo" c:type="PangoGlyphInfo*"/>
+        <doc xml:space="preserve">array of glyph information
+         for the glyph string.</doc>
+        <array length="0" zero-terminated="0" c:type="PangoGlyphInfo*">
+          <type name="GlyphInfo" c:type="PangoGlyphInfo"/>
+        </array>
       </field>
       <field name="log_clusters" writable="1">
+        <doc xml:space="preserve">logical cluster info, indexed by the byte index
+               within the text corresponding to the glyph string.</doc>
         <type name="gint" c:type="gint*"/>
       </field>
       <field name="space" readable="0" private="1">
@@ -5624,14 +5815,17 @@ by the structure which simplifies memory management.</doc>
       </constructor>
       <method name="copy" c:identifier="pango_glyph_string_copy">
         <doc xml:space="preserve">Copy a glyph string and associated storage.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoGlyphString, which
-              should be freed with pango_glyph_string_free(),
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoGlyphString,
+              which should be freed with pango_glyph_string_free(),
               or %NULL if @string was %NULL.</doc>
           <type name="GlyphString" c:type="PangoGlyphString*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="string" transfer-ownership="none">
+          <instance-parameter name="string"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphString, may be %NULL</doc>
             <type name="GlyphString" c:type="PangoGlyphString*"/>
           </instance-parameter>
@@ -5705,19 +5899,23 @@ glyph string).</doc>
           <parameter name="ink_rect"
                      direction="out"
                      caller-allocates="1"
-                     transfer-ownership="none">
-            <doc xml:space="preserve">rectangle used to store the
-           extents of the glyph string range as drawn or %NULL to
-           indicate that the result is not needed.</doc>
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">rectangle used to
+           store the extents of the glyph string range as drawn or
+           %NULL to indicate that the result is not needed.</doc>
             <type name="Rectangle" c:type="PangoRectangle*"/>
           </parameter>
           <parameter name="logical_rect"
                      direction="out"
                      caller-allocates="1"
-                     transfer-ownership="none">
-            <doc xml:space="preserve">rectangle used to store the
-           logical extents of the glyph string range or %NULL to
-           indicate that the result is not needed.</doc>
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">rectangle used to
+           store the logical extents of the glyph string range or
+           %NULL to indicate that the result is not needed.</doc>
             <type name="Rectangle" c:type="PangoRectangle*"/>
           </parameter>
         </parameters>
@@ -5728,7 +5926,10 @@ glyph string).</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="string" transfer-ownership="none">
+          <instance-parameter name="string"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoGlyphString, may be %NULL</doc>
             <type name="GlyphString" c:type="PangoGlyphString*"/>
           </instance-parameter>
@@ -5968,7 +6169,10 @@ in a #PangoMatrix.</doc>
           <type name="Gravity" c:type="PangoGravity"/>
         </return-value>
         <parameters>
-          <parameter name="matrix" transfer-ownership="none">
+          <parameter name="matrix"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </parameter>
@@ -6098,7 +6302,10 @@ respects the line progression.  This means, Latin and Arabic will take
 opposite gravities and both flow top-to-bottom for example.</doc>
       </member>
     </enumeration>
-    <record name="IncludedModule" c:type="PangoIncludedModule">
+    <record name="IncludedModule"
+            c:type="PangoIncludedModule"
+            deprecated="1"
+            deprecated-version="1.38">
       <doc xml:space="preserve">The #PangoIncludedModule structure for a statically linked module
 contains the functions that would otherwise be loaded from a dynamically
 loaded module.</doc>
@@ -6156,15 +6363,19 @@ loaded module.</doc>
             c:symbol-prefix="item">
       <doc xml:space="preserve">The #PangoItem structure stores information about a segment of text.</doc>
       <field name="offset" writable="1">
+        <doc xml:space="preserve">byte offset of the start of this item in text.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="length" writable="1">
+        <doc xml:space="preserve">length of this item in bytes.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="num_chars" writable="1">
+        <doc xml:space="preserve">number of Unicode characters in the item.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="analysis" writable="1">
+        <doc xml:space="preserve">analysis results for the item.</doc>
         <type name="Analysis" c:type="PangoAnalysis"/>
       </field>
       <constructor name="new" c:identifier="pango_item_new">
@@ -6177,14 +6388,17 @@ loaded module.</doc>
       </constructor>
       <method name="copy" c:identifier="pango_item_copy">
         <doc xml:space="preserve">Copy an existing #PangoItem structure.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoItem, which should
-              be freed with pango_item_free(), or %NULL if
-              @item was NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoItem, which
+              should be freed with pango_item_free(), or %NULL if
+              @item was %NULL.</doc>
           <type name="Item" c:type="PangoItem*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="item" transfer-ownership="none">
+          <instance-parameter name="item"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoItem, may be %NULL</doc>
             <type name="Item" c:type="PangoItem*"/>
           </instance-parameter>
@@ -6196,7 +6410,10 @@ loaded module.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="item" transfer-ownership="none">
+          <instance-parameter name="item"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoItem, may be %NULL</doc>
             <type name="Item" c:type="PangoItem*"/>
           </instance-parameter>
@@ -6270,7 +6487,10 @@ pango_language_get_sample_string (pango_language_from_string ("xx"))
           <type name="utf8" c:type="const char*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="language" transfer-ownership="none">
+          <instance-parameter name="language"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoLanguage, or %NULL</doc>
             <type name="Language" c:type="PangoLanguage*"/>
           </instance-parameter>
@@ -6297,13 +6517,13 @@ though, except that it is positive if the return value is not
 The pango_language_includes_script() function uses this function
 internally.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">An array of #PangoScript
-values, with the number of entries in the array stored in
-@num_scripts, or %NULL if Pango does not have any information about
-this particular language tag (also the case if @language is %NULL).
-The returned array is owned by Pango and should not be modified or
-freed.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">An array of
+#PangoScript values, with the number of entries in the array stored
+in @num_scripts, or %NULL if Pango does not have any information
+about this particular language tag (also the case if @language is
+%NULL).  The returned array is owned by Pango and should not be
+modified or freed.</doc>
           <array length="0" zero-terminated="0" c:type="PangoScript*">
             <type name="Script" c:type="PangoScript"/>
           </array>
@@ -6351,7 +6571,10 @@ to write @language or if nothing is known about @language
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
-          <instance-parameter name="language" transfer-ownership="none">
+          <instance-parameter name="language"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoLanguage, or %NULL</doc>
             <type name="Language" c:type="PangoLanguage*"/>
           </instance-parameter>
@@ -6372,7 +6595,10 @@ in the tag is '-'.</doc>
           <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
-          <instance-parameter name="language" transfer-ownership="none">
+          <instance-parameter name="language"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a language tag (see pango_language_from_string()),
            %NULL is allowed and matches nothing but '*'</doc>
             <type name="Language" c:type="PangoLanguage*"/>
@@ -6412,7 +6638,7 @@ than letters and '-'.
 Use pango_language_get_default() if you want to get the #PangoLanguage for
 the current locale of the process.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">an opaque pointer to a
               #PangoLanguage structure, or %NULL if @language was
               %NULL.  The returned pointer will be valid forever
@@ -6740,11 +6966,11 @@ coordinates begin at the top left corner of the layout.</doc>
               c:identifier="pango_layout_get_font_description"
               version="1.8">
         <doc xml:space="preserve">Gets the font description for the layout, if any.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a pointer to the layout's font description,
- or %NULL if the font description from the layout's
- context is inherited. This value is owned by the layout
- and must not be modified or freed.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">a pointer to the layout's font
+ description, or %NULL if the font description from the layout's
+ context is inherited. This value is owned by the layout and must
+ not be modified or freed.</doc>
           <type name="FontDescription" c:type="const PangoFontDescription*"/>
         </return-value>
         <parameters>
@@ -6818,11 +7044,12 @@ width of the layout.</doc>
 Use the faster pango_layout_get_line_readonly() if you do not plan
 to modify the contents of the line (glyphs, glyph widths, etc.).</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the requested #PangoLayoutLine, or %NULL if the
-              index is out of range. This layout line can
-              be ref'ed and retained, but will become invalid
-              if changes are made to the #PangoLayout.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the requested
+              #PangoLayoutLine, or %NULL if the index is out of
+              range. This layout line can be ref'ed and retained,
+              but will become invalid if changes are made to the
+              #PangoLayout.</doc>
           <type name="LayoutLine" c:type="PangoLayoutLine*"/>
         </return-value>
         <parameters>
@@ -6858,12 +7085,12 @@ to modify the contents of the line (glyphs, glyph widths, etc.).</doc>
 This is a faster alternative to pango_layout_get_line(),
 but the user is not expected
 to modify the contents of the line (glyphs, glyph widths, etc.).</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the requested #PangoLayoutLine, or %NULL if the
-              index is out of range. This layout line can
-              be ref'ed and retained, but will become invalid
-              if changes are made to the #PangoLayout.
-              No changes should be made to the line.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the requested
+              #PangoLayoutLine, or %NULL if the index is out of
+              range. This layout line can be ref'ed and retained,
+              but will become invalid if changes are made to the
+              #PangoLayout.  No changes should be made to the line.</doc>
           <type name="LayoutLine" c:type="PangoLayoutLine*"/>
         </return-value>
         <parameters>
@@ -7155,8 +7382,9 @@ is simply a convenience function around pango_layout_get_extents().</doc>
 #PangoTabArray has been set, then the default tabs are in use
 and %NULL is returned. Default tabs are every 8 spaces.
 The return value should be freed with pango_tab_array_free().</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a copy of the tabs for this layout, or %NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a copy of the tabs for this layout, or
+%NULL.</doc>
           <type name="TabArray" c:type="PangoTabArray*"/>
         </return-value>
         <parameters>
@@ -7249,7 +7477,7 @@ were actually wrapped.</doc>
           </parameter>
           <parameter name="trailing" transfer-ownership="none">
             <doc xml:space="preserve">an integer indicating the edge of the grapheme to retrieve the
-            position of. If 0, the trailing edge of the grapheme, if &gt; 0,
+            position of. If &gt; 0, the trailing edge of the grapheme, if 0,
             the leading of the grapheme.</doc>
             <type name="gboolean" c:type="gboolean"/>
           </parameter>
@@ -7382,9 +7610,9 @@ to form a single grapheme.</doc>
             <type name="gint" c:type="int"/>
           </parameter>
           <parameter name="old_trailing" transfer-ownership="none">
-            <doc xml:space="preserve">if 0, the cursor was at the trailing edge of the
+            <doc xml:space="preserve">if 0, the cursor was at the leading edge of the
                grapheme indicated by @old_index, if &gt; 0, the cursor
-               was at the leading edge.</doc>
+               was at the trailing edge.</doc>
             <type name="gint" c:type="int"/>
           </parameter>
           <parameter name="direction" transfer-ownership="none">
@@ -7826,7 +8054,7 @@ index to the character at that logical position. If the
 Y position is not inside the layout, the closest position is chosen
 (the position will be clamped inside the layout). If the
 X position is not within the layout, then the start or the
-end of the line is chosen as  described for pango_layout_xy_to_index().
+end of the line is chosen as described for pango_layout_line_x_to_index().
 If either the X or Y positions were not inside the layout, then the
 function returns %FALSE; on an exact hit, it returns %TRUE.</doc>
         <return-value transfer-ownership="none">
@@ -7862,7 +8090,7 @@ function returns %FALSE; on an exact hit, it returns %TRUE.</doc>
             <doc xml:space="preserve">location to store a integer indicating where
             in the grapheme the user clicked. It will either
             be zero, or the number of characters in the
-            grapheme. 0 represents the trailing edge of the grapheme.</doc>
+            grapheme. 0 represents the leading edge of the grapheme.</doc>
             <type name="gint" c:type="int*"/>
           </parameter>
         </parameters>
@@ -7899,14 +8127,17 @@ has no user-visible fields.</doc>
       </method>
       <method name="copy" c:identifier="pango_layout_iter_copy" version="1.20">
         <doc xml:space="preserve">Copies a #PangoLayoutIter.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoLayoutIter, which should
-              be freed with pango_layout_iter_free(), or %NULL if
-              @iter was %NULL.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoLayoutIter,
+              which should be freed with pango_layout_iter_free(),
+              or %NULL if @iter was %NULL.</doc>
           <type name="LayoutIter" c:type="PangoLayoutIter*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="iter" transfer-ownership="none">
+          <instance-parameter name="iter"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoLayoutIter, may be %NULL</doc>
             <type name="LayoutIter" c:type="PangoLayoutIter*"/>
           </instance-parameter>
@@ -7918,7 +8149,10 @@ has no user-visible fields.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="iter" transfer-ownership="none">
+          <instance-parameter name="iter"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoLayoutIter, may be %NULL</doc>
             <type name="LayoutIter" c:type="PangoLayoutIter*"/>
           </instance-parameter>
@@ -8178,7 +8412,7 @@ at least one run, even lines consisting of only a newline.
 Use the faster pango_layout_iter_get_run_readonly() if you do not plan
 to modify the contents of the run (glyphs, glyph widths, etc.).</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the current run.</doc>
           <type name="LayoutRun" c:type="PangoLayoutRun*"/>
         </return-value>
@@ -8232,8 +8466,9 @@ at least one run, even lines consisting of only a newline.
 This is a faster alternative to pango_layout_iter_get_run(),
 but the user is not expected
 to modify the contents of the run (glyphs, glyph widths, etc.).</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the current run, that should not be modified.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the current run, that
+should not be modified.</doc>
           <type name="LayoutRun" c:type="PangoLayoutRun*"/>
         </return-value>
         <parameters>
@@ -8315,6 +8550,7 @@ parent #PangoLayout are modified.
 Routines for rendering PangoLayout objects are provided in
 code specific to each rendering system.</doc>
       <field name="layout" writable="1">
+        <doc xml:space="preserve">the layout this line belongs to, might be %NULL</doc>
         <type name="Layout" c:type="PangoLayout*"/>
       </field>
       <field name="start_index" writable="1">
@@ -8326,6 +8562,8 @@ code specific to each rendering system.</doc>
         <type name="gint" c:type="gint"/>
       </field>
       <field name="runs" writable="1">
+        <doc xml:space="preserve">list of runs in the
+       line, from left to right</doc>
         <type name="GLib.SList" c:type="GSList*">
           <type name="gpointer" c:type="gpointer"/>
         </type>
@@ -8500,7 +8738,10 @@ layout, not with respect to the line.</doc>
           <type name="LayoutLine" c:type="PangoLayoutLine*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="line" transfer-ownership="none">
+          <instance-parameter name="line"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoLayoutLine, may be %NULL</doc>
             <type name="LayoutLine" c:type="PangoLayoutLine*"/>
           </instance-parameter>
@@ -8657,18 +8898,14 @@ Boundaries&lt;/ulink&gt; semantics. (Since: 1.22)</doc>
       </field>
     </record>
     <record name="Map" c:type="PangoMap" disguised="1">
-      <doc xml:space="preserve">A #PangoMap structure can be used to determine the engine to
-use for each character.</doc>
       <method name="get_engine"
               c:identifier="pango_map_get_engine"
-              introspectable="0">
-        <doc xml:space="preserve">Returns the best engine listed in the map for a given script</doc>
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.38">
+        <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
         <return-value>
-          <doc xml:space="preserve">the best engine, if one is listed for the script,
-   or %NULL. The lookup may cause the engine to be loaded;
-   once an engine is loaded, it won't be unloaded. If multiple
-   engines are exact for the script, the choice of which is
-   returned is arbitrary.</doc>
+          <doc xml:space="preserve">%NULL.</doc>
           <type name="Engine" c:type="PangoEngine*"/>
         </return-value>
         <parameters>
@@ -8685,11 +8922,10 @@ use for each character.</doc>
       <method name="get_engines"
               c:identifier="pango_map_get_engines"
               version="1.4"
-              introspectable="0">
-        <doc xml:space="preserve">Finds engines in the map that handle the given script. The returned
-lists should be freed with g_slist_free, but the engines in the
-lists are owned by GLib and will be kept around permanently, so
-they should not be unref'ed.</doc>
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.38">
+        <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -8720,9 +8956,6 @@ they should not be unref'ed.</doc>
       </method>
     </record>
     <record name="MapEntry" c:type="PangoMapEntry" disguised="1">
-      <doc xml:space="preserve">A #PangoMapEntry contains information about the engine that should be used
-for the codepoint to which this entry belongs and also whether the engine
-matches the language tag for this entry's map exactly or just approximately.</doc>
     </record>
     <record name="Matrix"
             c:type="PangoMatrix"
@@ -8782,14 +9015,17 @@ given by @new_matrix then applying the original transformation.</doc>
       </method>
       <method name="copy" c:identifier="pango_matrix_copy" version="1.6">
         <doc xml:space="preserve">Copies a #PangoMatrix.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">the newly allocated #PangoMatrix, which should
-              be freed with pango_matrix_free(), or %NULL if
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the newly allocated #PangoMatrix, which
+              should be freed with pango_matrix_free(), or %NULL if
               @matrix was %NULL.</doc>
           <type name="Matrix" c:type="PangoMatrix*"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, may be %NULL</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </instance-parameter>
@@ -8801,7 +9037,10 @@ given by @new_matrix then applying the original transformation.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, may be %NULL</doc>
             <type name="Matrix" c:type="PangoMatrix*"/>
           </instance-parameter>
@@ -8812,7 +9051,8 @@ given by @new_matrix then applying the original transformation.</doc>
               version="1.12">
         <doc xml:space="preserve">Returns the scale factor of a matrix on the height of the font.
 That is, the scale factor in the direction perpendicular to the
-vector that the X coordinate is mapped to.</doc>
+vector that the X coordinate is mapped to.  If the scale in the X
+coordinate is needed as well, use pango_matrix_get_font_scale_factors().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">the scale factor of @matrix on the height of the font,
 or 1.0 if @matrix is %NULL.</doc>
@@ -8828,6 +9068,46 @@ or 1.0 if @matrix is %NULL.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_font_scale_factors"
+              c:identifier="pango_matrix_get_font_scale_factors"
+              version="1.38">
+        <doc xml:space="preserve">Calculates the scale factor of a matrix on the width and height of the font.
+That is, @xscale is the scale factor in the direction of the X coordinate,
+and @yscale is the scale factor in the direction perpendicular to the
+vector that the X coordinate is mapped to.
+Note that output numbers will always be non-negative.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #PangoMatrix, or %NULL</doc>
+            <type name="Matrix" c:type="const PangoMatrix*"/>
+          </instance-parameter>
+          <parameter name="xscale"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">output scale factor in the x direction, or %NULL</doc>
+            <type name="gdouble" c:type="double*"/>
+          </parameter>
+          <parameter name="yscale"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">output scale factor perpendicular to the x direction, or %NULL</doc>
+            <type name="gdouble" c:type="double*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="rotate" c:identifier="pango_matrix_rotate" version="1.6">
         <doc xml:space="preserve">Changes the transformation represented by @matrix to be the
 transformation given by first rotating by @degrees degrees
@@ -8890,7 +9170,10 @@ to (@x2,@y2) then (@x1+@dx1,@y1+@dy1) will transform to
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, or %NULL</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </instance-parameter>
@@ -8928,7 +9211,10 @@ using pango_extents_to_pixels()'s first argument.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, or %NULL</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </instance-parameter>
@@ -8951,7 +9237,10 @@ using pango_extents_to_pixels()'s first argument.</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, or %NULL</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </instance-parameter>
@@ -8996,7 +9285,10 @@ example).</doc>
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
-          <instance-parameter name="matrix" transfer-ownership="none">
+          <instance-parameter name="matrix"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
             <doc xml:space="preserve">a #PangoMatrix, or %NULL</doc>
             <type name="Matrix" c:type="const PangoMatrix*"/>
           </instance-parameter>
@@ -9038,7 +9330,9 @@ then applying the original transformation.</doc>
     </record>
     <constant name="RENDER_TYPE_NONE"
               value="PangoRenderNone"
-              c:type="PANGO_RENDER_TYPE_NONE">
+              c:type="PANGO_RENDER_TYPE_NONE"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">A string constant defining the render type
 for engines that are not rendering-system specific.</doc>
       <type name="utf8" c:type="gchar*"/>
@@ -9725,14 +10019,35 @@ using the given #PangoRenderer; coordinates are in device space.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_alpha"
+              c:identifier="pango_renderer_get_alpha"
+              version="1.38">
+        <doc xml:space="preserve">Gets the current alpha for the specified part.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the alpha for the specified part,
+  or 0 if it hasn't been set and should be
+  inherited from the environment.</doc>
+          <type name="guint16" c:type="guint16"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="renderer" transfer-ownership="none">
+            <doc xml:space="preserve">a #PangoRenderer</doc>
+            <type name="Renderer" c:type="PangoRenderer*"/>
+          </instance-parameter>
+          <parameter name="part" transfer-ownership="none">
+            <doc xml:space="preserve">the part to get the alpha for</doc>
+            <type name="RenderPart" c:type="PangoRenderPart"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_color"
               c:identifier="pango_renderer_get_color"
               version="1.8">
         <doc xml:space="preserve">Gets the current rendering color for the specified part.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the color for the specified part, or
- %NULL if it hasn't been set and should be inherited from the
- environment.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the color for the
+  specified part, or %NULL if it hasn't been set and should be
+  inherited from the environment.</doc>
           <type name="Color" c:type="PangoColor*"/>
         </return-value>
         <parameters>
@@ -9755,9 +10070,9 @@ methods, like in its draw_shape&lt;!----&gt;() for example.
 The returned layout should not be modified while still being
 rendered.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the layout, or %NULL if no layout is being
- rendered using @renderer at this time.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the layout, or %NULL if
+ no layout is being rendered using @renderer at this time.</doc>
           <type name="Layout" c:type="PangoLayout*"/>
         </return-value>
         <parameters>
@@ -9776,9 +10091,9 @@ methods, like in its draw_shape&lt;!----&gt;() for example.
 The returned layout line should not be modified while still being
 rendered.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the layout line, or %NULL if no
-  layout line is being rendered using @renderer at this time.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the layout line, or %NULL
+  if no layout line is being rendered using @renderer at this time.</doc>
           <type name="LayoutLine" c:type="PangoLayoutLine*"/>
         </return-value>
         <parameters>
@@ -9793,11 +10108,10 @@ rendered.</doc>
               version="1.8">
         <doc xml:space="preserve">Gets the transformation matrix that will be applied when
 rendering. See pango_renderer_set_matrix().</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the matrix, or %NULL if no matrix has been set
- (which is the same as the identity matrix). The returned
- matrix is owned by Pango and must not be modified or
- freed.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the matrix, or %NULL if no matrix has
+ been set (which is the same as the identity matrix). The returned
+ matrix is owned by Pango and must not be modified or freed.</doc>
           <type name="Matrix" c:type="const PangoMatrix*"/>
         </return-value>
         <parameters>
@@ -9837,10 +10151,35 @@ changes to colors. (See pango_renderer_set_color())</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="set_alpha"
+              c:identifier="pango_renderer_set_alpha"
+              version="1.38">
+        <doc xml:space="preserve">Sets the alpha for part of the rendering.
+Note that the alpha may only be used if a color is
+specified for @part as well.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="renderer" transfer-ownership="none">
+            <doc xml:space="preserve">a #PangoRenderer</doc>
+            <type name="Renderer" c:type="PangoRenderer*"/>
+          </instance-parameter>
+          <parameter name="part" transfer-ownership="none">
+            <doc xml:space="preserve">the part to set the alpha for</doc>
+            <type name="RenderPart" c:type="PangoRenderPart"/>
+          </parameter>
+          <parameter name="alpha" transfer-ownership="none">
+            <doc xml:space="preserve">an alpha value between 1 and 65536, or 0 to unset the alpha</doc>
+            <type name="guint16" c:type="guint16"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_color"
               c:identifier="pango_renderer_set_color"
               version="1.8">
-        <doc xml:space="preserve">Sets the color for part of the rendering.</doc>
+        <doc xml:space="preserve">Sets the color for part of the rendering.
+Also see pango_renderer_set_alpha().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -9897,8 +10236,9 @@ changes to colors. (See pango_renderer_set_color())</doc>
         <type name="gint" c:type="int"/>
       </field>
       <field name="matrix">
-        <doc xml:space="preserve">the current transformation matrix for the Renderer; may
-   be %NULL, which should be treated the same as the identity matrix.</doc>
+        <doc xml:space="preserve">the current transformation matrix for
+   the Renderer; may be %NULL, which should be treated the
+   same as the identity matrix.</doc>
         <type name="Matrix" c:type="PangoMatrix*"/>
       </field>
       <field name="priv" readable="0" private="1">
@@ -10769,6 +11109,180 @@ base glyph to which it is attached</doc>
               glib:nick="takri">
         <doc xml:space="preserve">Takri. Since: 1.32</doc>
       </member>
+      <member name="bassa_vah"
+              value="88"
+              c:identifier="PANGO_SCRIPT_BASSA_VAH"
+              glib:nick="bassa-vah">
+        <doc xml:space="preserve">Bassa. Since: 1.40</doc>
+      </member>
+      <member name="caucasian_albanian"
+              value="89"
+              c:identifier="PANGO_SCRIPT_CAUCASIAN_ALBANIAN"
+              glib:nick="caucasian-albanian">
+        <doc xml:space="preserve">Caucasian Albanian. Since: 1.40</doc>
+      </member>
+      <member name="duployan"
+              value="90"
+              c:identifier="PANGO_SCRIPT_DUPLOYAN"
+              glib:nick="duployan">
+        <doc xml:space="preserve">Duployan. Since: 1.40</doc>
+      </member>
+      <member name="elbasan"
+              value="91"
+              c:identifier="PANGO_SCRIPT_ELBASAN"
+              glib:nick="elbasan">
+        <doc xml:space="preserve">Elbasan. Since: 1.40</doc>
+      </member>
+      <member name="grantha"
+              value="92"
+              c:identifier="PANGO_SCRIPT_GRANTHA"
+              glib:nick="grantha">
+        <doc xml:space="preserve">Grantha. Since: 1.40</doc>
+      </member>
+      <member name="khojki"
+              value="93"
+              c:identifier="PANGO_SCRIPT_KHOJKI"
+              glib:nick="khojki">
+        <doc xml:space="preserve">Kjohki. Since: 1.40</doc>
+      </member>
+      <member name="khudawadi"
+              value="94"
+              c:identifier="PANGO_SCRIPT_KHUDAWADI"
+              glib:nick="khudawadi">
+        <doc xml:space="preserve">Khudawadi, Sindhi. Since: 1.40</doc>
+      </member>
+      <member name="linear_a"
+              value="95"
+              c:identifier="PANGO_SCRIPT_LINEAR_A"
+              glib:nick="linear-a">
+        <doc xml:space="preserve">Linear A. Since: 1.40</doc>
+      </member>
+      <member name="mahajani"
+              value="96"
+              c:identifier="PANGO_SCRIPT_MAHAJANI"
+              glib:nick="mahajani">
+        <doc xml:space="preserve">Mahajani. Since: 1.40</doc>
+      </member>
+      <member name="manichaean"
+              value="97"
+              c:identifier="PANGO_SCRIPT_MANICHAEAN"
+              glib:nick="manichaean">
+        <doc xml:space="preserve">Manichaean. Since: 1.40</doc>
+      </member>
+      <member name="mende_kikakui"
+              value="98"
+              c:identifier="PANGO_SCRIPT_MENDE_KIKAKUI"
+              glib:nick="mende-kikakui">
+        <doc xml:space="preserve">Mende Kikakui. Since: 1.40</doc>
+      </member>
+      <member name="modi"
+              value="99"
+              c:identifier="PANGO_SCRIPT_MODI"
+              glib:nick="modi">
+        <doc xml:space="preserve">Modi. Since: 1.40</doc>
+      </member>
+      <member name="mro"
+              value="100"
+              c:identifier="PANGO_SCRIPT_MRO"
+              glib:nick="mro">
+        <doc xml:space="preserve">Mro. Since: 1.40</doc>
+      </member>
+      <member name="nabataean"
+              value="101"
+              c:identifier="PANGO_SCRIPT_NABATAEAN"
+              glib:nick="nabataean">
+        <doc xml:space="preserve">Nabataean. Since: 1.40</doc>
+      </member>
+      <member name="old_north_arabian"
+              value="102"
+              c:identifier="PANGO_SCRIPT_OLD_NORTH_ARABIAN"
+              glib:nick="old-north-arabian">
+        <doc xml:space="preserve">Old North Arabian. Since: 1.40</doc>
+      </member>
+      <member name="old_permic"
+              value="103"
+              c:identifier="PANGO_SCRIPT_OLD_PERMIC"
+              glib:nick="old-permic">
+        <doc xml:space="preserve">Old Permic. Since: 1.40</doc>
+      </member>
+      <member name="pahawh_hmong"
+              value="104"
+              c:identifier="PANGO_SCRIPT_PAHAWH_HMONG"
+              glib:nick="pahawh-hmong">
+        <doc xml:space="preserve">Pahawh Hmong. Since: 1.40</doc>
+      </member>
+      <member name="palmyrene"
+              value="105"
+              c:identifier="PANGO_SCRIPT_PALMYRENE"
+              glib:nick="palmyrene">
+        <doc xml:space="preserve">Palmyrene. Since: 1.40</doc>
+      </member>
+      <member name="pau_cin_hau"
+              value="106"
+              c:identifier="PANGO_SCRIPT_PAU_CIN_HAU"
+              glib:nick="pau-cin-hau">
+        <doc xml:space="preserve">Pau Cin Hau. Since: 1.40</doc>
+      </member>
+      <member name="psalter_pahlavi"
+              value="107"
+              c:identifier="PANGO_SCRIPT_PSALTER_PAHLAVI"
+              glib:nick="psalter-pahlavi">
+        <doc xml:space="preserve">Psalter Pahlavi. Since: 1.40</doc>
+      </member>
+      <member name="siddham"
+              value="108"
+              c:identifier="PANGO_SCRIPT_SIDDHAM"
+              glib:nick="siddham">
+        <doc xml:space="preserve">Siddham. Since: 1.40</doc>
+      </member>
+      <member name="tirhuta"
+              value="109"
+              c:identifier="PANGO_SCRIPT_TIRHUTA"
+              glib:nick="tirhuta">
+        <doc xml:space="preserve">Tirhuta. Since: 1.40</doc>
+      </member>
+      <member name="warang_citi"
+              value="110"
+              c:identifier="PANGO_SCRIPT_WARANG_CITI"
+              glib:nick="warang-citi">
+        <doc xml:space="preserve">Warang Citi. Since: 1.40</doc>
+      </member>
+      <member name="ahom"
+              value="111"
+              c:identifier="PANGO_SCRIPT_AHOM"
+              glib:nick="ahom">
+        <doc xml:space="preserve">Ahom. Since: 1.40</doc>
+      </member>
+      <member name="anatolian_hieroglyphs"
+              value="112"
+              c:identifier="PANGO_SCRIPT_ANATOLIAN_HIEROGLYPHS"
+              glib:nick="anatolian-hieroglyphs">
+        <doc xml:space="preserve">Anatolian Hieroglyphs. Since: 1.40</doc>
+      </member>
+      <member name="hatran"
+              value="113"
+              c:identifier="PANGO_SCRIPT_HATRAN"
+              glib:nick="hatran">
+        <doc xml:space="preserve">Hatran. Since: 1.40</doc>
+      </member>
+      <member name="multani"
+              value="114"
+              c:identifier="PANGO_SCRIPT_MULTANI"
+              glib:nick="multani">
+        <doc xml:space="preserve">Multani. Since: 1.40</doc>
+      </member>
+      <member name="old_hungarian"
+              value="115"
+              c:identifier="PANGO_SCRIPT_OLD_HUNGARIAN"
+              glib:nick="old-hungarian">
+        <doc xml:space="preserve">Old Hungarian. Since: 1.40</doc>
+      </member>
+      <member name="signwriting"
+              value="116"
+              c:identifier="PANGO_SCRIPT_SIGNWRITING"
+              glib:nick="signwriting">
+        <doc xml:space="preserve">Signwriting. Since: 1.40</doc>
+      </member>
       <function name="for_unichar"
                 c:identifier="pango_script_for_unichar"
                 version="1.4">
@@ -10823,7 +11337,7 @@ instead of Arabic (ar) when a segment of Arabic text is found
 in an otherwise non-Arabic text.  The same trick can be used to
 choose a default language for %PANGO_SCRIPT_HAN when setting
 context language is not feasible.</doc>
-        <return-value transfer-ownership="full">
+        <return-value transfer-ownership="full" nullable="1">
           <doc xml:space="preserve">a #PangoLanguage that is representative
 of the script, or %NULL if no such language exists.</doc>
           <type name="Language" c:type="PangoLanguage*"/>
@@ -10926,8 +11440,8 @@ is returned.</doc>
                 version="1.4"
                 introspectable="0">
         <doc xml:space="preserve">Create a new #PangoScriptIter, used to break a string of
-Unicode into runs by text. No copy is made of @text, so
-the caller needs to make sure it remains valid until
+Unicode text into runs by Unicode script. No copy is made of
+@text, so the caller needs to make sure it remains valid until
 the iterator is freed with pango_script_iter_free().</doc>
         <return-value>
           <doc xml:space="preserve">the new script iterator, initialized
@@ -11455,6 +11969,23 @@ value ranging from 100 to 1000, but there are some predefined values:</doc>
 enough space for a full word.</doc>
       </member>
     </enumeration>
+    <function name="attr_background_alpha_new"
+              c:identifier="pango_attr_background_alpha_new"
+              version="1.38"
+              introspectable="0">
+      <doc xml:space="preserve">Create a new background alpha attribute.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">the new allocated #PangoAttribute,
+              which should be freed with pango_attribute_destroy().</doc>
+        <type name="Attribute" c:type="PangoAttribute*"/>
+      </return-value>
+      <parameters>
+        <parameter name="alpha" transfer-ownership="none">
+          <doc xml:space="preserve">the alpha value, between 1 and 65536</doc>
+          <type name="guint16" c:type="guint16"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="attr_background_new"
               c:identifier="pango_attr_background_new"
               introspectable="0">
@@ -11518,6 +12049,23 @@ text.</doc>
         </parameter>
       </parameters>
     </function>
+    <function name="attr_foreground_alpha_new"
+              c:identifier="pango_attr_foreground_alpha_new"
+              version="1.38"
+              introspectable="0">
+      <doc xml:space="preserve">Create a new foreground alpha attribute.</doc>
+      <return-value transfer-ownership="full">
+        <doc xml:space="preserve">the new allocated #PangoAttribute,
+              which should be freed with pango_attribute_destroy().</doc>
+        <type name="Attribute" c:type="PangoAttribute*"/>
+      </return-value>
+      <parameters>
+        <parameter name="alpha" transfer-ownership="none">
+          <doc xml:space="preserve">the alpha value, between 1 and 65536</doc>
+          <type name="guint16" c:type="guint16"/>
+        </parameter>
+      </parameters>
+    </function>
     <function name="attr_foreground_new"
               c:identifier="pango_attr_foreground_new"
               introspectable="0">
@@ -11712,9 +12260,9 @@ pango_attr_type_register().
 The returned value is an interned string (see g_intern_string() for what
 that means) that should not be modified or freed.</doc>
-      <return-value transfer-ownership="none">
-        <doc xml:space="preserve">the type ID name (which may be %NULL), or %NULL if @type is
-a built-in Pango attribute type or invalid.</doc>
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">the type ID name (which may be %NULL), or
+%NULL if @type is a built-in Pango attribute type or invalid.</doc>
         <type name="utf8" c:type="const char*"/>
       </return-value>
       <parameters>
@@ -11869,13 +12417,13 @@ purposes you may want to use pango_get_log_attrs().</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="config_key_get" c:identifier="pango_config_key_get">
-      <doc xml:space="preserve">Looks up a key in the Pango config database
-(pseudo-win.ini style, read from $sysconfdir/pango/pangorc,
- $XDG_CONFIG_HOME/pango/pangorc, and getenv (PANGO_RC_FILE).)</doc>
+    <function name="config_key_get"
+              c:identifier="pango_config_key_get"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the value, if found, otherwise %NULL. The value is a
-newly-allocated string and must be freed with g_free().</doc>
+        <doc xml:space="preserve">%NULL</doc>
         <type name="utf8" c:type="char*"/>
       </return-value>
       <parameters>
@@ -11886,12 +12434,12 @@ newly-allocated string and must be freed with g_free().</doc>
       </parameters>
     </function>
     <function name="config_key_get_system"
-              c:identifier="pango_config_key_get_system">
-      <doc xml:space="preserve">Looks up a key, consulting only the Pango system config database
-in $sysconfdir/pango/pangorc.</doc>
+              c:identifier="pango_config_key_get_system"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
       <return-value transfer-ownership="full">
-        <doc xml:space="preserve">the value, if found, otherwise %NULL. The value is a
-newly-allocated string and must be freed with g_free().</doc>
+        <doc xml:space="preserve">%NULL</doc>
         <type name="utf8" c:type="char*"/>
       </return-value>
       <parameters>
@@ -11921,7 +12469,10 @@ simply use pango_get_log_attrs().</doc>
           <doc xml:space="preserve">length of text in bytes (may be -1 if @text is nul-terminated)</doc>
           <type name="gint" c:type="int"/>
         </parameter>
-        <parameter name="analysis" transfer-ownership="none">
+        <parameter name="analysis"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">a #PangoAnalysis for the @text</doc>
           <type name="Analysis" c:type="PangoAnalysis*"/>
         </parameter>
@@ -11994,12 +12545,14 @@ If no such character is found, then %PANGO_DIRECTION_NEUTRAL is returned.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="find_map" c:identifier="pango_find_map" introspectable="0">
-      <doc xml:space="preserve">Locate a #PangoMap for a particular engine type and render
-type. The resulting map can be used to determine the engine
-for each character.</doc>
+    <function name="find_map"
+              c:identifier="pango_find_map"
+              introspectable="0"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
       <return-value>
-        <doc xml:space="preserve">the suitable #PangoMap.</doc>
+        <doc xml:space="preserve">%NULL.</doc>
         <type name="Map" c:type="PangoMap*"/>
       </return-value>
       <parameters>
@@ -12065,7 +12618,7 @@ off the end).</doc>
       <doc xml:space="preserve">Creates a new font description from a string representation in the
 form "[FAMILY-LIST] [STYLE-OPTIONS] [SIZE]", where FAMILY-LIST is a
 comma separated list of families optionally terminated by a comma,
-STYLE_OPTIONS is a whitespace separated list of words where each WORD
+STYLE_OPTIONS is a whitespace separated list of words where each word
 describes one of style, variant, weight, stretch, or gravity, and SIZE
 is a decimal number (size in points) or optionally followed by the
 unit modifier "px" for absolute size. Any one of the options may
@@ -12086,11 +12639,11 @@ description will be set to 0.</doc>
       </parameters>
     </function>
     <function name="get_lib_subdirectory"
-              c:identifier="pango_get_lib_subdirectory">
-      <doc xml:space="preserve">On Unix, returns the name of the "pango" subdirectory of LIBDIR
-(which is set at compile time). On Windows, returns the lib\pango
-subdirectory of the Pango installation directory (which is deduced
-at run time from the DLL's location).</doc>
+              c:identifier="pango_get_lib_subdirectory"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Returns the name of the "pango" subdirectory of LIBDIR
+(which is set at compile time).</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the Pango lib directory. The returned string should
 not be freed.</doc>
@@ -12162,11 +12715,11 @@ filled in, %FALSE otherwise</doc>
       </parameters>
     </function>
     <function name="get_sysconf_subdirectory"
-              c:identifier="pango_get_sysconf_subdirectory">
-      <doc xml:space="preserve">On Unix, returns the name of the "pango" subdirectory of SYSCONFDIR
-(which is set at compile time). On Windows, returns the etc\pango
-subdirectory of the Pango installation directory (which is deduced
-at run time from the DLL's location).</doc>
+              c:identifier="pango_get_sysconf_subdirectory"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Returns the name of the "pango" subdirectory of SYSCONFDIR
+(which is set at compile time).</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">the Pango sysconf directory. The returned string should
 not be freed.</doc>
@@ -12185,7 +12738,10 @@ in a #PangoMatrix.</doc>
         <type name="Gravity" c:type="PangoGravity"/>
       </return-value>
       <parameters>
-        <parameter name="matrix" transfer-ownership="none">
+        <parameter name="matrix"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">a #PangoMatrix</doc>
           <type name="Matrix" c:type="const PangoMatrix*"/>
         </parameter>
@@ -12420,7 +12976,7 @@ than letters and '-'.
 Use pango_language_get_default() if you want to get the #PangoLanguage for
 the current locale of the process.</doc>
-      <return-value transfer-ownership="none">
+      <return-value transfer-ownership="none" nullable="1">
         <doc xml:space="preserve">an opaque pointer to a
               #PangoLanguage structure, or %NULL if @language was
               %NULL.  The returned pointer will be valid forever
@@ -12620,11 +13176,11 @@ destroyed with g_markup_parse_context_free().</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="module_register" c:identifier="pango_module_register">
-      <doc xml:space="preserve">Registers a statically linked module with Pango. The
-#PangoIncludedModule structure that is passed in contains the
-functions that would otherwise be loaded from a dynamically loaded
-module.</doc>
+    <function name="module_register"
+              c:identifier="pango_module_register"
+              deprecated="1"
+              deprecated-version="1.38">
+      <doc xml:space="preserve">Do not use.  Does not do anything.</doc>
       <return-value transfer-ownership="none">
         <type name="none" c:type="void"/>
       </return-value>
@@ -12635,7 +13191,11 @@ module.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="parse_enum" c:identifier="pango_parse_enum" version="1.16">
+    <function name="parse_enum"
+              c:identifier="pango_parse_enum"
+              version="1.16"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Parses an enum type and stores the result in @value.
 If @str does not match the nick name of any of the possible values for the
@@ -12889,7 +13449,10 @@ of rounding.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="read_line" c:identifier="pango_read_line">
+    <function name="read_line"
+              c:identifier="pango_read_line"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Reads an entire line from a file into a buffer. Lines may
 be delimited with '\n', '\r', '\n\r', or '\r\n'. The delimiter
 is not written into the buffer. Text after a '#' character is treated as
@@ -12904,7 +13467,10 @@ unmodified.</doc>
         <type name="gint" c:type="gint"/>
       </return-value>
       <parameters>
-        <parameter name="stream" transfer-ownership="none">
+        <parameter name="stream"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">a stdio stream</doc>
           <type name="gpointer" c:type="FILE*"/>
         </parameter>
@@ -12941,7 +13507,10 @@ The original list is unmodified.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="scan_int" c:identifier="pango_scan_int">
+    <function name="scan_int"
+              c:identifier="pango_scan_int"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Scans an integer.
 Leading white space is skipped.</doc>
       <return-value transfer-ownership="none">
@@ -12965,7 +13534,10 @@ Leading white space is skipped.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="scan_string" c:identifier="pango_scan_string">
+    <function name="scan_string"
+              c:identifier="pango_scan_string"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Scans a string into a #GString buffer. The string may either
 be a sequence of non-white-space characters, or a quoted
 string with '"'. Instead a quoted string, '\"' represents
@@ -12991,7 +13563,10 @@ a literal quote. Leading white space outside of quotes is skipped.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="scan_word" c:identifier="pango_scan_word">
+    <function name="scan_word"
+              c:identifier="pango_scan_word"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Scans a word into a #GString buffer. A word consists
 of [A-Za-z_] followed by zero or more [A-Za-z_0-9]
 Leading white space is skipped.</doc>
@@ -13072,7 +13647,7 @@ instead of Arabic (ar) when a segment of Arabic text is found
 in an otherwise non-Arabic text.  The same trick can be used to
 choose a default language for %PANGO_SCRIPT_HAN when setting
 context language is not feasible.</doc>
-      <return-value transfer-ownership="full">
+      <return-value transfer-ownership="full" nullable="1">
         <doc xml:space="preserve">a #PangoLanguage that is representative
 of the script, or %NULL if no such language exists.</doc>
         <type name="Language" c:type="PangoLanguage*"/>
@@ -13159,7 +13734,10 @@ text of which @item_text is part of, provide the broader text as
         </parameter>
       </parameters>
     </function>
-    <function name="skip_space" c:identifier="pango_skip_space">
+    <function name="skip_space"
+              c:identifier="pango_skip_space"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Skips 0 or more characters of white space.</doc>
       <return-value transfer-ownership="none">
         <doc xml:space="preserve">%FALSE if skipping the white space leaves
@@ -13176,7 +13754,10 @@ the position at a '\0' character.</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="split_file_list" c:identifier="pango_split_file_list">
+    <function name="split_file_list"
+              c:identifier="pango_split_file_list"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Splits a %G_SEARCHPATH_SEPARATOR-separated list of files, stripping
 white space and substituting ~/ with $HOME/.</doc>
       <return-value transfer-ownership="full">
@@ -13193,7 +13774,10 @@ strings to be freed with g_strfreev()</doc>
         </parameter>
       </parameters>
     </function>
-    <function name="trim_string" c:identifier="pango_trim_string">
+    <function name="trim_string"
+              c:identifier="pango_trim_string"
+              deprecated="1"
+              deprecated-version="1.38">
       <doc xml:space="preserve">Trims leading and trailing whitespace from a string.</doc>
       <return-value transfer-ownership="full">
         <doc xml:space="preserve">A newly-allocated string that must be freed with g_free()</doc>
@@ -13289,11 +13873,11 @@ version @required_major.required_minor.@required_micro
 (same major version.)
 For compile-time version checking use PANGO_VERSION_CHECK().</doc>
-      <return-value transfer-ownership="none">
-        <doc xml:space="preserve">%NULL if the Pango library is compatible with the
-  given version, or a string describing the version mismatch.
-  The returned string is owned by Pango and should not be modified
-  or freed.</doc>
+      <return-value transfer-ownership="none" nullable="1">
+        <doc xml:space="preserve">%NULL if the Pango library is compatible
+  with the given version, or a string describing the version
+  mismatch.  The returned string is owned by Pango and should not
+  be modified or freed.</doc>
         <type name="utf8" c:type="const char*"/>
       </return-value>
       <parameters>