gtksourceview3 3.0.7-x86-mingw32 → 3.0.8-x86-mingw32

data/vendor/local/share/gir-1.0/GtkSource-3.0.gir

@@ -292,6 +292,54 @@ executing instruction indication in a source file, etc..</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="create_source_tag"
+              c:identifier="gtk_source_buffer_create_source_tag"
+              version="3.20"
+              introspectable="0">
+        <doc xml:space="preserve">In short, this is the same function as gtk_text_buffer_create_tag(), but
+instead of creating a #GtkTextTag, this function creates a #GtkSourceTag.
+
+This function creates a #GtkSourceTag and adds it to the tag table for
+@buffer.  Equivalent to calling gtk_text_tag_new() and then adding the tag to
+the buffer’s tag table. The returned tag is owned by the buffer’s tag table,
+so the ref count will be equal to one.
+
+If @tag_name is %NULL, the tag is anonymous.
+
+If @tag_name is non-%NULL, a tag called @tag_name must not already
+exist in the tag table for this buffer.
+
+The @first_property_name argument and subsequent arguments are a list
+of properties to set on the tag, as with g_object_set().</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new #GtkSourceTag.</doc>
+          <type name="Gtk.TextTag" c:type="GtkTextTag*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="buffer" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceBuffer</doc>
+            <type name="Buffer" c:type="GtkSourceBuffer*"/>
+          </instance-parameter>
+          <parameter name="tag_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">name of the new tag, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="first_property_name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">name of first property to set, or %NULL</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="..." transfer-ownership="none">
+            <doc xml:space="preserve">%NULL-terminated list of property names and values</doc>
+            <varargs/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="end_not_undoable_action"
               c:identifier="gtk_source_buffer_end_not_undoable_action">
         <doc xml:space="preserve">Marks the end of a not undoable action on the buffer.  When the
@@ -440,8 +488,9 @@ buffer.</doc>
         <doc xml:space="preserve">Returns the #GtkSourceLanguage associated with the buffer,
 see gtk_source_buffer_set_language().  The returned object should not be
 unreferenced by the user.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #GtkSourceLanguage associated with the buffer, or %NULL.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #GtkSourceLanguage associated
+with the buffer, or %NULL.</doc>
           <type name="Language" c:type="GtkSourceLanguage*"/>
         </return-value>
         <parameters>
@@ -530,9 +579,9 @@ a newly allocated #GSList.</doc>
         <doc xml:space="preserve">Returns the #GtkSourceStyleScheme associated with the buffer,
 see gtk_source_buffer_set_style_scheme().
 The returned object should not be unreferenced by the user.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #GtkSourceStyleScheme associated
-with the buffer, or %NULL.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #GtkSourceStyleScheme
+associated with the buffer, or %NULL.</doc>
           <type name="StyleScheme" c:type="GtkSourceStyleScheme*"/>
         </return-value>
         <parameters>
@@ -578,10 +627,7 @@ See the #GtkSourceBuffer description for the list of default context classes.</d
             <doc xml:space="preserve">a #GtkSourceBuffer.</doc>
             <type name="Buffer" c:type="GtkSourceBuffer*"/>
           </instance-parameter>
-          <parameter name="iter"
-                     direction="inout"
-                     caller-allocates="0"
-                     transfer-ownership="full">
+          <parameter name="iter" transfer-ownership="none">
             <doc xml:space="preserve">a #GtkTextIter.</doc>
             <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
           </parameter>
@@ -610,10 +656,7 @@ See the #GtkSourceBuffer description for the list of default context classes.</d
             <doc xml:space="preserve">a #GtkSourceBuffer.</doc>
             <type name="Buffer" c:type="GtkSourceBuffer*"/>
           </instance-parameter>
-          <parameter name="iter"
-                     direction="inout"
-                     caller-allocates="0"
-                     transfer-ownership="full">
+          <parameter name="iter" transfer-ownership="none">
             <doc xml:space="preserve">a #GtkTextIter.</doc>
             <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
           </parameter>
@@ -822,7 +865,9 @@ The buffer holds a reference to @language.</doc>
 track.  If the number of user actions exceeds the limit set by this
 function, older actions will be discarded.
 
-If @max_undo_levels is -1, no limit is set.</doc>
+If @max_undo_levels is -1, the undo/redo is unlimited.
+
+If @max_undo_levels is 0, the undo/redo is disabled.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -879,6 +924,36 @@ will be set.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="sort_lines"
+              c:identifier="gtk_source_buffer_sort_lines"
+              version="3.18">
+        <doc xml:space="preserve">Sort the lines of text between the specified iterators.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="buffer" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceBuffer.</doc>
+            <type name="Buffer" c:type="GtkSourceBuffer*"/>
+          </instance-parameter>
+          <parameter name="start" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkTextIter.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="end" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkTextIter.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="flags" transfer-ownership="none">
+            <doc xml:space="preserve">#GtkSourceSortFlags specifying how the sort should behave</doc>
+            <type name="SortFlags" c:type="GtkSourceSortFlags"/>
+          </parameter>
+          <parameter name="column" transfer-ownership="none">
+            <doc xml:space="preserve">sort considering the text starting at the given column</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="undo" c:identifier="gtk_source_buffer_undo">
         <doc xml:space="preserve">Undoes the last user action which modified the buffer.  Use
 gtk_source_buffer_can_undo() to check whether a call to this
@@ -947,19 +1022,24 @@ brackets style.</doc>
         <type name="BufferPrivate" c:type="GtkSourceBufferPrivate*"/>
       </field>
       <glib:signal name="bracket-matched" when="last" version="2.12">
-        <doc xml:space="preserve">Sets @iter to a valid iterator pointing to the matching bracket
-if @state is #GTK_SOURCE_BRACKET_MATCH_FOUND. Otherwise @iter is
-meaningless.</doc>
+        <doc xml:space="preserve">@iter is set to a valid iterator pointing to the matching bracket
+if @state is %GTK_SOURCE_BRACKET_MATCH_FOUND. Otherwise @iter is
+meaningless.
+
+The signal is emitted only when the @state changes, typically when
+the cursor moves.
+
+A use-case for this signal is to show messages in a #GtkStatusbar.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
         <parameters>
           <parameter name="iter" transfer-ownership="none">
-            <doc xml:space="preserve">iterator to initialize.</doc>
+            <doc xml:space="preserve">if found, the location of the matching bracket.</doc>
             <type name="Gtk.TextIter"/>
           </parameter>
           <parameter name="state" transfer-ownership="none">
-            <doc xml:space="preserve">state of bracket matching</doc>
+            <doc xml:space="preserve">state of bracket matching.</doc>
             <type name="BracketMatchType"/>
           </parameter>
         </parameters>
@@ -1325,7 +1405,7 @@ list of #GtkSourceCompletionProvider.</doc>
       <method name="get_view" c:identifier="gtk_source_completion_get_view">
         <doc xml:space="preserve">The #GtkSourceView associated with @completion, or %NULL if the view has been
 destroyed.</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">
 The #GtkSourceView associated with @completion, or %NULL.</doc>
           <type name="View" c:type="GtkSourceView*"/>
@@ -2226,10 +2306,24 @@ which case there will be no icon shown and no extra information available.</doc>
           </parameter>
         </parameters>
       </constructor>
+      <property name="gicon"
+                version="3.18"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GIcon for the icon to be shown for this proposal.</doc>
+        <type name="Gio.Icon"/>
+      </property>
       <property name="icon" writable="1" transfer-ownership="none">
-        <doc xml:space="preserve">Icon to be shown for this proposal.</doc>
+        <doc xml:space="preserve">The #GdkPixbuf for the icon to be shown for this proposal.</doc>
         <type name="GdkPixbuf.Pixbuf"/>
       </property>
+      <property name="icon-name"
+                version="3.18"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The icon name for the icon to be shown for this proposal.</doc>
+        <type name="utf8" c:type="gchar*"/>
+      </property>
       <property name="info" writable="1" transfer-ownership="none">
         <doc xml:space="preserve">Optional extra information to be shown for this proposal.</doc>
         <type name="utf8" c:type="gchar*"/>
@@ -2311,10 +2405,24 @@ completion model. By default, it uses direct equality (g_direct_equal()).</doc>
           </parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="get_gicon" invoker="get_gicon" version="3.18">
+        <doc xml:space="preserve">Gets the #GIcon for the icon of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">A #GIcon with the icon of @proposal.</doc>
+          <type name="Gio.Icon" c:type="GIcon*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="proposal" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+            <type name="CompletionProposal"
+                  c:type="GtkSourceCompletionProposal*"/>
+          </instance-parameter>
+        </parameters>
+      </virtual-method>
       <virtual-method name="get_icon" invoker="get_icon">
-        <doc xml:space="preserve">Gets the icon of @proposal.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">The icon of @proposal.</doc>
+        <doc xml:space="preserve">Gets the #GdkPixbuf for the icon of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">A #GdkPixbuf with the icon of @proposal.</doc>
           <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
         <parameters>
@@ -2325,13 +2433,30 @@ completion model. By default, it uses direct equality (g_direct_equal()).</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="get_icon_name"
+                      invoker="get_icon_name"
+                      version="3.18">
+        <doc xml:space="preserve">Gets the icon name of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon name of @proposal.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="proposal" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+            <type name="CompletionProposal"
+                  c:type="GtkSourceCompletionProposal*"/>
+          </instance-parameter>
+        </parameters>
+      </virtual-method>
       <virtual-method name="get_info" invoker="get_info">
         <doc xml:space="preserve">Gets extra information associated to the proposal. This information will be
 used to present the user with extra, detailed information about the
 selected proposal. The returned string must be freed with g_free().</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new string containing extra information of @proposal or %NULL if
-         no extra information is associated to @proposal.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a newly-allocated string containing
+extra information of @proposal or %NULL if no extra information is associated
+to @proposal.</doc>
           <type name="utf8" c:type="gchar*"/>
         </return-value>
         <parameters>
@@ -2448,11 +2573,27 @@ completion model. By default, it uses direct equality (g_direct_equal()).</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="get_gicon"
+              c:identifier="gtk_source_completion_proposal_get_gicon"
+              version="3.18">
+        <doc xml:space="preserve">Gets the #GIcon for the icon of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">A #GIcon with the icon of @proposal.</doc>
+          <type name="Gio.Icon" c:type="GIcon*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="proposal" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+            <type name="CompletionProposal"
+                  c:type="GtkSourceCompletionProposal*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_icon"
               c:identifier="gtk_source_completion_proposal_get_icon">
-        <doc xml:space="preserve">Gets the icon of @proposal.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">The icon of @proposal.</doc>
+        <doc xml:space="preserve">Gets the #GdkPixbuf for the icon of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">A #GdkPixbuf with the icon of @proposal.</doc>
           <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
         </return-value>
         <parameters>
@@ -2463,14 +2604,31 @@ completion model. By default, it uses direct equality (g_direct_equal()).</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_icon_name"
+              c:identifier="gtk_source_completion_proposal_get_icon_name"
+              version="3.18">
+        <doc xml:space="preserve">Gets the icon name of @proposal.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon name of @proposal.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="proposal" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+            <type name="CompletionProposal"
+                  c:type="GtkSourceCompletionProposal*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_info"
               c:identifier="gtk_source_completion_proposal_get_info">
         <doc xml:space="preserve">Gets extra information associated to the proposal. This information will be
 used to present the user with extra, detailed information about the
 selected proposal. The returned string must be freed with g_free().</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a new string containing extra information of @proposal or %NULL if
-         no extra information is associated to @proposal.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a newly-allocated string containing
+extra information of @proposal or %NULL if no extra information is associated
+to @proposal.</doc>
           <type name="utf8" c:type="gchar*"/>
         </return-value>
         <parameters>
@@ -2616,8 +2774,8 @@ will react to this by updating the shown information.</doc>
       </field>
       <field name="get_icon">
         <callback name="get_icon">
-          <return-value transfer-ownership="none">
-            <doc xml:space="preserve">The icon of @proposal.</doc>
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">A #GdkPixbuf with the icon of @proposal.</doc>
             <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
           </return-value>
           <parameters>
@@ -2629,11 +2787,42 @@ will react to this by updating the shown information.</doc>
           </parameters>
         </callback>
       </field>
+      <field name="get_icon_name">
+        <callback name="get_icon_name">
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">The icon name of @proposal.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </return-value>
+          <parameters>
+            <parameter name="proposal" transfer-ownership="none">
+              <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+              <type name="CompletionProposal"
+                    c:type="GtkSourceCompletionProposal*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="get_gicon">
+        <callback name="get_gicon">
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">A #GIcon with the icon of @proposal.</doc>
+            <type name="Gio.Icon" c:type="GIcon*"/>
+          </return-value>
+          <parameters>
+            <parameter name="proposal" transfer-ownership="none">
+              <doc xml:space="preserve">a #GtkSourceCompletionProposal.</doc>
+              <type name="CompletionProposal"
+                    c:type="GtkSourceCompletionProposal*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
       <field name="get_info">
         <callback name="get_info">
-          <return-value transfer-ownership="full">
-            <doc xml:space="preserve">a new string containing extra information of @proposal or %NULL if
-         no extra information is associated to @proposal.</doc>
+          <return-value transfer-ownership="full" nullable="1">
+            <doc xml:space="preserve">a newly-allocated string containing
+extra information of @proposal or %NULL if no extra information is associated
+to @proposal.</doc>
             <type name="utf8" c:type="gchar*"/>
           </return-value>
           <parameters>
@@ -2749,8 +2938,23 @@ will contain only alphanumerical and the "_" characters.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="get_gicon" invoker="get_gicon" version="3.18">
+        <doc xml:space="preserve">Gets the #GIcon for the icon of @provider.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+          <type name="Gio.Icon" c:type="GIcon*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+            <type name="CompletionProvider"
+                  c:type="GtkSourceCompletionProvider*"/>
+          </instance-parameter>
+        </parameters>
+      </virtual-method>
       <virtual-method name="get_icon" invoker="get_icon">
-        <doc xml:space="preserve">Get the icon of the provider.</doc>
+        <doc xml:space="preserve">Get the #GdkPixbuf for the icon of the @provider.</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The icon to be used for the provider,
          or %NULL if the provider does not have a special icon.</doc>
@@ -2764,6 +2968,23 @@ will contain only alphanumerical and the "_" characters.</doc>
           </instance-parameter>
         </parameters>
       </virtual-method>
+      <virtual-method name="get_icon_name"
+                      invoker="get_icon_name"
+                      version="3.18">
+        <doc xml:space="preserve">Gets the icon name of @provider.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon name to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+            <type name="CompletionProvider"
+                  c:type="GtkSourceCompletionProvider*"/>
+          </instance-parameter>
+        </parameters>
+      </virtual-method>
       <virtual-method name="get_info_widget" invoker="get_info_widget">
         <doc xml:space="preserve">Get a customized info widget to show extra information of a proposal.
 This allows for customized widgets on a proposal basis, although in general
@@ -3008,9 +3229,26 @@ will contain only alphanumerical and the "_" characters.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_gicon"
+              c:identifier="gtk_source_completion_provider_get_gicon"
+              version="3.18">
+        <doc xml:space="preserve">Gets the #GIcon for the icon of @provider.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+          <type name="Gio.Icon" c:type="GIcon*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+            <type name="CompletionProvider"
+                  c:type="GtkSourceCompletionProvider*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_icon"
               c:identifier="gtk_source_completion_provider_get_icon">
-        <doc xml:space="preserve">Get the icon of the provider.</doc>
+        <doc xml:space="preserve">Get the #GdkPixbuf for the icon of the @provider.</doc>
         <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">The icon to be used for the provider,
          or %NULL if the provider does not have a special icon.</doc>
@@ -3024,6 +3262,23 @@ will contain only alphanumerical and the "_" characters.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_icon_name"
+              c:identifier="gtk_source_completion_provider_get_icon_name"
+              version="3.18">
+        <doc xml:space="preserve">Gets the icon name of @provider.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">The icon name to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+          <type name="utf8" c:type="const gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="provider" transfer-ownership="none">
+            <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+            <type name="CompletionProvider"
+                  c:type="GtkSourceCompletionProvider*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_info_widget"
               c:identifier="gtk_source_completion_provider_get_info_widget">
         <doc xml:space="preserve">Get a customized info widget to show extra information of a proposal.
@@ -3264,6 +3519,38 @@ gtk_source_completion_context_add_proposals() function.</doc>
           </parameters>
         </callback>
       </field>
+      <field name="get_icon_name">
+        <callback name="get_icon_name">
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">The icon name to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </return-value>
+          <parameters>
+            <parameter name="provider" transfer-ownership="none">
+              <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+              <type name="CompletionProvider"
+                    c:type="GtkSourceCompletionProvider*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
+      <field name="get_gicon">
+        <callback name="get_gicon">
+          <return-value transfer-ownership="none" nullable="1">
+            <doc xml:space="preserve">The icon to be used for the provider,
+         or %NULL if the provider does not have a special icon.</doc>
+            <type name="Gio.Icon" c:type="GIcon*"/>
+          </return-value>
+          <parameters>
+            <parameter name="provider" transfer-ownership="none">
+              <doc xml:space="preserve">The #GtkSourceCompletionProvider</doc>
+              <type name="CompletionProvider"
+                    c:type="GtkSourceCompletionProvider*"/>
+            </parameter>
+          </parameters>
+        </callback>
+      </field>
       <field name="populate">
         <callback name="populate">
           <return-value transfer-ownership="none">
@@ -3760,6 +4047,23 @@ all #GtkSourceEncoding's. Free with g_slist_free().</doc>
           <type name="Encoding" c:type="const GtkSourceEncoding*"/>
         </return-value>
       </function>
+      <function name="get_default_candidates"
+                c:identifier="gtk_source_encoding_get_default_candidates"
+                version="3.18">
+        <doc xml:space="preserve">Gets the list of default candidate encodings to try when loading a file. See
+gtk_source_file_loader_set_candidate_encodings().
+
+This function returns a different list depending on the current locale (i.e.
+language, country and default encoding). The UTF-8 encoding and the current
+locale encoding are guaranteed to be present in the returned list.</doc>
+        <return-value transfer-ownership="container">
+          <doc xml:space="preserve">the list of
+default candidate encodings. Free with g_slist_free().</doc>
+          <type name="GLib.SList" c:type="GSList*">
+            <type name="Encoding"/>
+          </type>
+        </return-value>
+      </function>
       <function name="get_from_charset"
                 c:identifier="gtk_source_encoding_get_from_charset"
                 version="3.14">
@@ -3801,12 +4105,97 @@ if not found.</doc>
           <type name="File" c:type="GtkSourceFile*"/>
         </return-value>
       </constructor>
+      <method name="check_file_on_disk"
+              c:identifier="gtk_source_file_check_file_on_disk"
+              version="3.18">
+        <doc xml:space="preserve">Checks synchronously the file on disk, to know whether the file is externally
+modified, or has been deleted, and whether the file is read-only.
+
+#GtkSourceFile doesn't create a #GFileMonitor to track those properties, so
+this function needs to be called instead. Creating lots of #GFileMonitor's
+would take lots of resources.
+
+Since this function is synchronous, it is advised to call it only on local
+files. See gtk_source_file_is_local().</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceFile.</doc>
+            <type name="File" c:type="GtkSourceFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_compression_type"
               c:identifier="gtk_source_file_get_compression_type"
               version="3.14">
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the compression type.</doc>
-          <type name="CompressionType" c:type="GtkSourceCompressionType"/>
+          <doc xml:space="preserve">the compression type.</doc>
+          <type name="CompressionType" c:type="GtkSourceCompressionType"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceFile.</doc>
+            <type name="File" c:type="GtkSourceFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_encoding"
+              c:identifier="gtk_source_file_get_encoding"
+              version="3.14">
+        <doc xml:space="preserve">The encoding is initially %NULL. After a successful file loading or saving
+operation, the encoding is non-%NULL.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the character encoding.</doc>
+          <type name="Encoding" c:type="const GtkSourceEncoding*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceFile.</doc>
+            <type name="File" c:type="GtkSourceFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_location"
+              c:identifier="gtk_source_file_get_location"
+              version="3.14">
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the #GFile.</doc>
+          <type name="Gio.File" c:type="GFile*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceFile.</doc>
+            <type name="File" c:type="GtkSourceFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_newline_type"
+              c:identifier="gtk_source_file_get_newline_type"
+              version="3.14">
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">the newline type.</doc>
+          <type name="NewlineType" c:type="GtkSourceNewlineType"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="file" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceFile.</doc>
+            <type name="File" c:type="GtkSourceFile*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="is_deleted"
+              c:identifier="gtk_source_file_is_deleted"
+              version="3.18">
+        <doc xml:space="preserve">Returns whether the file has been deleted. If the
+#GtkSourceFile:location is %NULL, returns %FALSE.
+
+To have an up-to-date value, you must first call
+gtk_source_file_check_file_on_disk().</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the file has been deleted.</doc>
+          <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="file" transfer-ownership="none">
@@ -3815,14 +4204,17 @@ if not found.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="get_encoding"
-              c:identifier="gtk_source_file_get_encoding"
-              version="3.14">
-        <doc xml:space="preserve">The encoding is initially %NULL. After a successful file loading or saving
-operation, the encoding is non-%NULL.</doc>
+      <method name="is_externally_modified"
+              c:identifier="gtk_source_file_is_externally_modified"
+              version="3.18">
+        <doc xml:space="preserve">Returns whether the file is externally modified. If the
+#GtkSourceFile:location is %NULL, returns %FALSE.
+
+To have an up-to-date value, you must first call
+gtk_source_file_check_file_on_disk().</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the character encoding.</doc>
-          <type name="Encoding" c:type="const GtkSourceEncoding*"/>
+          <doc xml:space="preserve">whether the file is externally modified.</doc>
+          <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="file" transfer-ownership="none">
@@ -3831,12 +4223,14 @@ operation, the encoding is non-%NULL.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="get_location"
-              c:identifier="gtk_source_file_get_location"
-              version="3.14">
+      <method name="is_local"
+              c:identifier="gtk_source_file_is_local"
+              version="3.18">
+        <doc xml:space="preserve">Returns whether the file is local. If the #GtkSourceFile:location is %NULL,
+returns %FALSE.</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #GFile.</doc>
-          <type name="Gio.File" c:type="GFile*"/>
+          <doc xml:space="preserve">whether the file is local.</doc>
+          <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="file" transfer-ownership="none">
@@ -3845,12 +4239,17 @@ operation, the encoding is non-%NULL.</doc>
           </instance-parameter>
         </parameters>
       </method>
-      <method name="get_newline_type"
-              c:identifier="gtk_source_file_get_newline_type"
-              version="3.14">
+      <method name="is_readonly"
+              c:identifier="gtk_source_file_is_readonly"
+              version="3.18">
+        <doc xml:space="preserve">Returns whether the file is read-only. If the
+#GtkSourceFile:location is %NULL, returns %FALSE.
+
+To have an up-to-date value, you must first call
+gtk_source_file_check_file_on_disk().</doc>
         <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the newline type.</doc>
-          <type name="NewlineType" c:type="GtkSourceNewlineType"/>
+          <doc xml:space="preserve">whether the file is read-only.</doc>
+          <type name="gboolean" c:type="gboolean"/>
         </return-value>
         <parameters>
           <instance-parameter name="file" transfer-ownership="none">
@@ -3908,7 +4307,10 @@ called.</doc>
             <type name="MountOperationFactory"
                   c:type="GtkSourceMountOperationFactory"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the data to pass to the @callback function.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -3937,6 +4339,7 @@ loading or saving operation, the encoding is non-%NULL.</doc>
       <property name="location"
                 version="3.14"
                 writable="1"
+                construct="1"
                 transfer-ownership="none">
         <doc xml:space="preserve">The location.</doc>
         <type name="Gio.File"/>
@@ -3945,6 +4348,11 @@ loading or saving operation, the encoding is non-%NULL.</doc>
         <doc xml:space="preserve">The line ending type.</doc>
         <type name="NewlineType"/>
       </property>
+      <property name="read-only" version="3.18" transfer-ownership="none">
+        <doc xml:space="preserve">Whether the file is read-only or not. The value of this property is
+not updated automatically (there is no file monitors).</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <field name="parent">
         <type name="GObject.Object" c:type="GObject"/>
       </field>
@@ -4076,9 +4484,9 @@ the @buffer is emptied.</doc>
       <method name="get_input_stream"
               c:identifier="gtk_source_file_loader_get_input_stream"
               version="3.14">
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #GInputStream to load, or %NULL if a #GFile is
-  used.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #GInputStream to load, or %NULL
+if a #GFile is used.</doc>
           <type name="Gio.InputStream" c:type="GInputStream*"/>
         </return-value>
         <parameters>
@@ -4091,9 +4499,9 @@ the @buffer is emptied.</doc>
       <method name="get_location"
               c:identifier="gtk_source_file_loader_get_location"
               version="3.14">
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the #GFile to load, or %NULL if an input stream is
-  used.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #GFile to load, or %NULL
+if an input stream is used.</doc>
           <type name="Gio.File" c:type="GFile*"/>
         </return-value>
         <parameters>
@@ -4155,7 +4563,10 @@ function.</doc>
             <type name="Gio.FileProgressCallback"
                   c:type="GFileProgressCallback"/>
           </parameter>
-          <parameter name="progress_callback_data" transfer-ownership="none">
+          <parameter name="progress_callback_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @progress_callback.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4179,7 +4590,10 @@ function.</doc>
   satisfied.</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @callback.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4218,11 +4632,11 @@ the same order as the list.
 For convenience, @candidate_encodings can contain duplicates. Only the first
 occurrence of a duplicated encoding is kept in the list.
 
-By default the candidate encodings are (in that order):
-1. If set, the #GtkSourceFile's encoding. See gtk_source_file_get_encoding().
-2. Depending on the current locale (language and country), a list of common
-encodings are added. The UTF-8 encoding and the current locale encoding are
-always present.</doc>
+By default the candidate encodings are (in that order in the list):
+1. If set, the #GtkSourceFile's encoding as returned by
+gtk_source_file_get_encoding().
+2. The default candidates as returned by
+gtk_source_encoding_get_default_candidates().</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -4528,7 +4942,10 @@ documentation to know how to use this function.</doc>
             <type name="Gio.FileProgressCallback"
                   c:type="GFileProgressCallback"/>
           </parameter>
-          <parameter name="progress_callback_data" transfer-ownership="none">
+          <parameter name="progress_callback_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @progress_callback.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4552,7 +4969,10 @@ documentation to know how to use this function.</doc>
   satisfied.</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">user data to pass to @callback.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -4566,7 +4986,10 @@ documentation to know how to use this function.</doc>
 
 If the file has been saved successfully, the following #GtkSourceFile
 properties will be updated: the location, the encoding, the newline type and
-the compression type.</doc>
+the compression type.
+
+Since the 3.20 version, gtk_text_buffer_set_modified() is called with %FALSE
+if the file has been saved successfully.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether the file was saved successfully.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -4829,7 +5252,7 @@ from the #GtkSourceFile at construction time.</doc>
       <method name="get_renderer_at_pos"
               c:identifier="gtk_source_gutter_get_renderer_at_pos">
         <doc xml:space="preserve">Finds the #GtkSourceGutterRenderer at (x, y).</doc>
-        <return-value transfer-ownership="none">
+        <return-value transfer-ownership="none" nullable="1">
           <doc xml:space="preserve">the renderer at (x, y) or %NULL.</doc>
           <type name="GutterRenderer" c:type="GtkSourceGutterRenderer*"/>
         </return-value>
@@ -5088,27 +5511,39 @@ some state before the draw method is called for each cell.</doc>
         </parameters>
       </virtual-method>
       <virtual-method name="change_buffer">
+        <doc xml:space="preserve">This is called when the text buffer changes for @renderer.</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 #GtkSourceGutterRenderer.</doc>
             <type name="GutterRenderer" c:type="GtkSourceGutterRenderer*"/>
           </instance-parameter>
-          <parameter name="old_buffer" transfer-ownership="none">
+          <parameter name="old_buffer"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the old #GtkTextBuffer.</doc>
             <type name="Gtk.TextBuffer" c:type="GtkTextBuffer*"/>
           </parameter>
         </parameters>
       </virtual-method>
       <virtual-method name="change_view">
+        <doc xml:space="preserve">This is called when the text view changes for @renderer.</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 #GtkSourceGutterRenderer.</doc>
             <type name="GutterRenderer" c:type="GtkSourceGutterRenderer*"/>
           </instance-parameter>
-          <parameter name="old_view" transfer-ownership="none">
+          <parameter name="old_view"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the old #GtkTextView.</doc>
             <type name="Gtk.TextView" c:type="GtkTextView*"/>
           </parameter>
         </parameters>
@@ -5886,7 +6321,7 @@ activated.</doc>
           </parameter>
           <parameter name="area" transfer-ownership="none">
             <doc xml:space="preserve">a #GdkRectangle</doc>
-            <type name="cairo.RectangleInt"/>
+            <type name="Gdk.Rectangle"/>
           </parameter>
           <parameter name="event" transfer-ownership="none">
             <doc xml:space="preserve">the event that caused the activation</doc>
@@ -5907,7 +6342,7 @@ can possibly be activated.</doc>
           </parameter>
           <parameter name="area" transfer-ownership="none">
             <doc xml:space="preserve">a #GdkRectangle</doc>
-            <type name="cairo.RectangleInt"/>
+            <type name="Gdk.Rectangle"/>
           </parameter>
           <parameter name="event" transfer-ownership="none">
             <doc xml:space="preserve">the #GdkEvent that is causing the activatable query</doc>
@@ -5951,7 +6386,7 @@ show a tooltip.</doc>
           </parameter>
           <parameter name="area" transfer-ownership="none">
             <doc xml:space="preserve">a #GdkRectangle</doc>
-            <type name="cairo.RectangleInt"/>
+            <type name="Gdk.Rectangle"/>
           </parameter>
           <parameter name="x" transfer-ownership="none">
             <doc xml:space="preserve">the x position (in window coordinates)</doc>
@@ -6100,9 +6535,14 @@ text wrapping).</doc>
           </return-value>
           <parameters>
             <parameter name="renderer" transfer-ownership="none">
+              <doc xml:space="preserve">a #GtkSourceGutterRenderer.</doc>
               <type name="GutterRenderer" c:type="GtkSourceGutterRenderer*"/>
             </parameter>
-            <parameter name="old_view" transfer-ownership="none">
+            <parameter name="old_view"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
+              <doc xml:space="preserve">the old #GtkTextView.</doc>
               <type name="Gtk.TextView" c:type="GtkTextView*"/>
             </parameter>
           </parameters>
@@ -6115,9 +6555,14 @@ text wrapping).</doc>
           </return-value>
           <parameters>
             <parameter name="renderer" transfer-ownership="none">
+              <doc xml:space="preserve">a #GtkSourceGutterRenderer.</doc>
               <type name="GutterRenderer" c:type="GtkSourceGutterRenderer*"/>
             </parameter>
-            <parameter name="old_buffer" transfer-ownership="none">
+            <parameter name="old_buffer"
+                       transfer-ownership="none"
+                       nullable="1"
+                       allow-none="1">
+              <doc xml:space="preserve">the old #GtkTextBuffer.</doc>
               <type name="Gtk.TextBuffer" c:type="GtkTextBuffer*"/>
             </parameter>
           </parameters>
@@ -6496,42 +6941,78 @@ a line in the buffer which contains part of the selection</doc>
       </constructor>
       <method name="measure"
               c:identifier="gtk_source_gutter_renderer_text_measure">
+        <doc xml:space="preserve">Measures the text provided using the pango layout used by the
+#GtkSourceGutterRendererText.</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 #GtkSourceGutterRendererText.</doc>
             <type name="GutterRendererText"
                   c:type="GtkSourceGutterRendererText*"/>
           </instance-parameter>
           <parameter name="text" transfer-ownership="none">
+            <doc xml:space="preserve">the text to measure.</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="width" transfer-ownership="none">
+          <parameter name="width"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">location to store the width of the text in pixels,
+  or %NULL.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
-          <parameter name="height" transfer-ownership="none">
+          <parameter name="height"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">location to store the height of the text in
+  pixels, or %NULL.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
         </parameters>
       </method>
       <method name="measure_markup"
               c:identifier="gtk_source_gutter_renderer_text_measure_markup">
+        <doc xml:space="preserve">Measures the pango markup provided using the pango layout used by the
+#GtkSourceGutterRendererText.</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 #GtkSourceGutterRendererText.</doc>
             <type name="GutterRendererText"
                   c:type="GtkSourceGutterRendererText*"/>
           </instance-parameter>
           <parameter name="markup" transfer-ownership="none">
+            <doc xml:space="preserve">the pango markup to measure.</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
-          <parameter name="width" transfer-ownership="none">
+          <parameter name="width"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">location to store the width of the text in pixels,
+  or %NULL.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
-          <parameter name="height" transfer-ownership="none">
+          <parameter name="height"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">location to store the height of the text in
+  pixels, or %NULL.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
         </parameters>
@@ -6615,9 +7096,10 @@ a line in the buffer which contains part of the selection</doc>
         <doc xml:space="preserve">Returns the globs associated to this language. This is just
 an utility wrapper around gtk_source_language_get_metadata() to
 retrieve the "globs" metadata property and split it into an array.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a newly-allocated
-%NULL terminated array containing the globs or %NULL if no globs are found.
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">
+a newly-allocated %NULL terminated array containing the globs or %NULL
+if no globs are found.
 The returned array must be freed with g_strfreev().</doc>
           <array c:type="gchar**">
             <type name="utf8"/>
@@ -6660,9 +7142,10 @@ or modified.</doc>
       </method>
       <method name="get_metadata"
               c:identifier="gtk_source_language_get_metadata">
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">value of property @name stored in the metadata of @language
-or %NULL if language doesn't contain that metadata property.
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">value of property @name stored in
+the metadata of @language or %NULL if language does not contain the
+specified metadata property.
 The returned string is owned by @language and should not be freed
 or modified.</doc>
           <type name="utf8" c:type="const gchar*"/>
@@ -6684,10 +7167,10 @@ or modified.</doc>
 an utility wrapper around gtk_source_language_get_metadata() to
 retrieve the "mimetypes" metadata property and split it into an
 array.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a newly-allocated
-%NULL terminated array containing the mime types or %NULL if no
-mime types are found.
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">
+a newly-allocated %NULL terminated array containing the mime types
+or %NULL if no mime types are found.
 The returned array must be freed with g_strfreev().</doc>
           <array c:type="gchar**">
             <type name="utf8"/>
@@ -6738,10 +7221,10 @@ or modified.</doc>
               version="3.4">
         <doc xml:space="preserve">Returns the ID of the style to use if the specified @style_id
 is not present in the current style scheme.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the ID of the style to use if the specified @style_id
-is not present in the current style scheme or %NULL if the style has
-no fallback defined.
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the ID of the style to use if the
+specified @style_id is not present in the current style scheme or %NULL
+if the style has no fallback defined.
 The returned string is owned by the @language and must not be modified.</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
@@ -6759,10 +7242,10 @@ The returned string is owned by the @language and must not be modified.</doc>
       <method name="get_style_ids"
               c:identifier="gtk_source_language_get_style_ids">
         <doc xml:space="preserve">Returns the ids of the styles defined by this @language.</doc>
-        <return-value transfer-ownership="full">
-          <doc xml:space="preserve">a  %NULL terminated
-array containing ids of the styles defined by this @language or
-%NULL if no style is defined.
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">
+a newly-allocated %NULL terminated array containing ids of the
+styles defined by this @language or %NULL if no style is defined.
 The returned array must be freed with g_strfreev().</doc>
           <array c:type="gchar**">
             <type name="utf8"/>
@@ -6778,11 +7261,11 @@ The returned array must be freed with g_strfreev().</doc>
       <method name="get_style_name"
               c:identifier="gtk_source_language_get_style_name">
         <doc xml:space="preserve">Returns the name of the style with ID @style_id defined by this @language.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">the name of the style with ID @style_id defined by this @language or
-%NULL if the style has no name or there is no style with ID @style_id defined
-by this @language. The returned string is owned by the @language and must
-not be modified.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the name of the style with ID @style_id
+defined by this @language or %NULL if the style has no name or there is no
+style with ID @style_id defined by this @language.
+The returned string is owned by the @language and must not be modified.</doc>
           <type name="utf8" c:type="const gchar*"/>
         </return-value>
         <parameters>
@@ -6886,12 +7369,12 @@ owned by @lm and should not be freed.</doc>
               c:identifier="gtk_source_language_manager_get_language_ids">
         <doc xml:space="preserve">Returns the ids of the available languages.</doc>
         <return-value transfer-ownership="none" nullable="1">
-          <doc xml:space="preserve">a %NULL-terminated array of
-string containing the ids of the available languages or %NULL if no
-language is available.  The array is sorted alphabetically
-according to the language name.  The array is owned by @lm and must
-not be modified.</doc>
-          <array c:type="const gchar* const*">
+          <doc xml:space="preserve">
+a %NULL-terminated array of strings containing the ids of the available
+languages or %NULL if no language is available.
+The array is sorted alphabetically according to the language name.
+The array is owned by @lm and must not be modified.</doc>
+          <array c:type="gchar**">
             <type name="utf8"/>
           </array>
         </return-value>
@@ -7077,6 +7560,78 @@ a %NULL-terminated array of strings or %NULL.</doc>
             c:type="GtkSourceLanguagePrivate"
             disguised="1">
     </record>
+    <class name="Map"
+           c:symbol-prefix="map"
+           c:type="GtkSourceMap"
+           parent="View"
+           glib:type-name="GtkSourceMap"
+           glib:get-type="gtk_source_map_get_type"
+           glib:type-struct="MapClass">
+      <implements name="Atk.ImplementorIface"/>
+      <implements name="Gtk.Buildable"/>
+      <implements name="Gtk.Scrollable"/>
+      <constructor name="new" c:identifier="gtk_source_map_new" version="3.18">
+        <doc xml:space="preserve">Creates a new #GtkSourceMap.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">a new #GtkSourceMap.</doc>
+          <type name="Gtk.Widget" c:type="GtkWidget*"/>
+        </return-value>
+      </constructor>
+      <method name="get_view"
+              c:identifier="gtk_source_map_get_view"
+              version="3.18">
+        <doc xml:space="preserve">Gets the #GtkSourceMap:view property, which is the view this widget is mapping.</doc>
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">a #GtkSourceView or %NULL.</doc>
+          <type name="View" c:type="GtkSourceView*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="map" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceMap.</doc>
+            <type name="Map" c:type="GtkSourceMap*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="set_view"
+              c:identifier="gtk_source_map_set_view"
+              version="3.18">
+        <doc xml:space="preserve">Sets the view that @map will be doing the mapping to.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="map" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceMap</doc>
+            <type name="Map" c:type="GtkSourceMap*"/>
+          </instance-parameter>
+          <parameter name="view" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceView</doc>
+            <type name="View" c:type="GtkSourceView*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <property name="font-desc" writable="1" transfer-ownership="none">
+        <type name="Pango.FontDescription"/>
+      </property>
+      <property name="view" writable="1" transfer-ownership="none">
+        <type name="View"/>
+      </property>
+      <field name="parent_instance">
+        <type name="View" c:type="GtkSourceView"/>
+      </field>
+    </class>
+    <record name="MapClass"
+            c:type="GtkSourceMapClass"
+            glib:is-gtype-struct-for="Map">
+      <field name="parent_class">
+        <type name="ViewClass" c:type="GtkSourceViewClass"/>
+      </field>
+      <field name="padding">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="10">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </record>
     <class name="Mark"
            c:symbol-prefix="mark"
            c:type="GtkSourceMark"
@@ -7551,7 +8106,10 @@ g_free() when done with it.</doc>
           <doc xml:space="preserve">a #GtkSourceFile.</doc>
           <type name="File" c:type="GtkSourceFile*"/>
         </parameter>
-        <parameter name="userdata" transfer-ownership="none">
+        <parameter name="userdata"
+                   transfer-ownership="none"
+                   nullable="1"
+                   allow-none="1">
           <doc xml:space="preserve">user data</doc>
           <type name="gpointer" c:type="gpointer"/>
         </parameter>
@@ -8123,24 +8681,8 @@ gtk_source_print_compositor_paginate() function.</doc>
       <method name="set_footer_format"
               c:identifier="gtk_source_print_compositor_set_footer_format"
               version="2.2">
-        <doc xml:space="preserve">Sets strftime like header format strings, to be printed on the
-left, center and right of the bottom of each page. The strings may
-include strftime(3) codes which will be expanded at print time.
-All strftime() codes are accepted, with the addition of #N for the
-page number and #Q for the page count.
-
-@separator specifies if a solid line should be drawn to separate
-the footer from the document text.
-
-If %NULL is given for any of the three arguments, that particular
-string will not be printed.
-
-For the footer to be printed, in
-addition to specifying format strings, you need to enable footer
-printing with gtk_source_print_compositor_set_print_footer().
-
-This function cannot be called anymore after the first call to the
-gtk_source_print_compositor_paginate() function.</doc>
+        <doc xml:space="preserve">See gtk_source_print_compositor_set_header_format() for more information
+about the parameters.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -8213,8 +8755,11 @@ gtk_source_print_compositor_paginate() function.</doc>
         <doc xml:space="preserve">Sets strftime like header format strings, to be printed on the
 left, center and right of the top of each page.  The strings may
 include strftime(3) codes which will be expanded at print time.
-All strftime() codes are accepted, with the addition of #N for the
-page number and #Q for the page count.
+A subset of strftime() codes are accepted, see g_date_time_format()
+for more details on the accepted format specifiers.
+Additionally the following format specifiers are accepted:
+- #N: the page number
+- #Q: the page count.
 
 @separator specifies if a solid line should be drawn to separate
 the header from the document text.
@@ -8786,7 +9331,10 @@ ownership of @cancellable, so you can unref it after calling this function.</doc
             <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished.</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the data to pass to the @callback function.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -8907,7 +9455,10 @@ ownership of @cancellable, so you can unref it after calling this function.</doc
             <doc xml:space="preserve">a #GAsyncReadyCallback to call when the operation is finished.</doc>
             <type name="Gio.AsyncReadyCallback" c:type="GAsyncReadyCallback"/>
           </parameter>
-          <parameter name="user_data" transfer-ownership="none">
+          <parameter name="user_data"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
             <doc xml:space="preserve">the data to pass to the @callback function.</doc>
             <type name="gpointer" c:type="gpointer"/>
           </parameter>
@@ -9575,6 +10126,36 @@ non-whitespace character on the second press.</doc>
 non-whitespace character when the HOME/END keys are pressed.</doc>
       </member>
     </enumeration>
+    <bitfield name="SortFlags"
+              version="3.18"
+              glib:type-name="GtkSourceSortFlags"
+              glib:get-type="gtk_source_sort_flags_get_type"
+              c:type="GtkSourceSortFlags">
+      <member name="none"
+              value="0"
+              c:identifier="GTK_SOURCE_SORT_FLAGS_NONE"
+              glib:nick="none">
+        <doc xml:space="preserve">no flags specified</doc>
+      </member>
+      <member name="case_sensitive"
+              value="1"
+              c:identifier="GTK_SOURCE_SORT_FLAGS_CASE_SENSITIVE"
+              glib:nick="case-sensitive">
+        <doc xml:space="preserve">case sensitive sort</doc>
+      </member>
+      <member name="reverse_order"
+              value="2"
+              c:identifier="GTK_SOURCE_SORT_FLAGS_REVERSE_ORDER"
+              glib:nick="reverse-order">
+        <doc xml:space="preserve">sort in reverse order</doc>
+      </member>
+      <member name="remove_duplicates"
+              value="4"
+              c:identifier="GTK_SOURCE_SORT_FLAGS_REMOVE_DUPLICATES"
+              glib:nick="remove-duplicates">
+        <doc xml:space="preserve">remove duplicates</doc>
+      </member>
+    </bitfield>
     <class name="Style"
            c:symbol-prefix="style"
            c:type="GtkSourceStyle"
@@ -9657,6 +10238,12 @@ when you are done with it.</doc>
                 transfer-ownership="none">
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="pango-underline"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <type name="Pango.Underline"/>
+      </property>
       <property name="scale"
                 writable="1"
                 construct-only="1"
@@ -9682,6 +10269,21 @@ when you are done with it.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
       <property name="underline"
+                deprecated="1"
+                deprecated-version="3.18"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc-deprecated xml:space="preserve">Use pango-underline.</doc-deprecated>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
+      <property name="underline-color"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <type name="utf8" c:type="gchar*"/>
+      </property>
+      <property name="underline-color-set"
                 writable="1"
                 construct-only="1"
                 transfer-ownership="none">
@@ -10128,10 +10730,10 @@ the @manager is accessed.</doc>
       <method name="get_scheme_ids"
               c:identifier="gtk_source_style_scheme_manager_get_scheme_ids">
         <doc xml:space="preserve">Returns the ids of the available style schemes.</doc>
-        <return-value transfer-ownership="none">
-          <doc xml:space="preserve">a %NULL-terminated array
-of string containing the ids of the available style schemes or %NULL if no
-style scheme is available.
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">
+a %NULL-terminated array of strings containing the ids of the available
+style schemes or %NULL if no style scheme is available.
 The array is sorted alphabetically according to the scheme name.
 The array is owned by the @manager and must not be modified.</doc>
           <array c:type="gchar**">
@@ -10273,6 +10875,69 @@ a %NULL-terminated array of strings or %NULL.</doc>
             c:type="GtkSourceStyleSchemePrivate"
             disguised="1">
     </record>
+    <class name="Tag"
+           c:symbol-prefix="tag"
+           c:type="GtkSourceTag"
+           parent="Gtk.TextTag"
+           glib:type-name="GtkSourceTag"
+           glib:get-type="gtk_source_tag_get_type"
+           glib:type-struct="TagClass">
+      <constructor name="new" c:identifier="gtk_source_tag_new" version="3.20">
+        <doc xml:space="preserve">Creates a #GtkSourceTag. Configure the tag using object arguments,
+i.e. using g_object_set().
+
+For usual cases, gtk_source_buffer_create_source_tag() is more convenient to
+use.</doc>
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkSourceTag.</doc>
+          <type name="Gtk.TextTag" c:type="GtkTextTag*"/>
+        </return-value>
+        <parameters>
+          <parameter name="name"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">tag name, or %NULL.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+        </parameters>
+      </constructor>
+      <property name="draw-spaces"
+                version="3.20"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether to draw spaces. This property takes precedence over the value
+defined by the GtkSourceView's #GtkSourceView:draw-spaces property
+(only where the tag is applied).
+
+Setting this property also changes #GtkSourceTag:draw-spaces-set to
+%TRUE.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
+      <property name="draw-spaces-set"
+                version="3.20"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether the #GtkSourceTag:draw-spaces property is set and must be
+taken into account.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
+      <field name="parent_instance">
+        <type name="Gtk.TextTag" c:type="GtkTextTag"/>
+      </field>
+    </class>
+    <record name="TagClass"
+            c:type="GtkSourceTagClass"
+            glib:is-gtype-struct-for="Tag">
+      <field name="parent_class">
+        <type name="Gtk.TextTagClass" c:type="GtkTextTagClass"/>
+      </field>
+      <field name="padding">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="10">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </record>
     <interface name="UndoManager"
                c:symbol-prefix="undo_manager"
                c:type="GtkSourceUndoManager"
@@ -10850,8 +11515,7 @@ and mark category icons are rendered in the left gutter.</doc>
         </parameters>
       </method>
       <method name="get_indent_on_tab"
-              c:identifier="gtk_source_view_get_indent_on_tab"
-              version="1.8">
+              c:identifier="gtk_source_view_get_indent_on_tab">
         <doc xml:space="preserve">Returns whether when the tab key is pressed the current selection
 should get indented instead of replaced with the \t character.</doc>
         <return-value transfer-ownership="none">
@@ -10975,6 +11639,22 @@ The object belongs to @view, so it must not be unreffed.</doc>
           </instance-parameter>
         </parameters>
       </method>
+      <method name="get_smart_backspace"
+              c:identifier="gtk_source_view_get_smart_backspace"
+              version="3.18">
+        <doc xml:space="preserve">Returns %TRUE if pressing the Backspace key will try to delete spaces
+up to the previous tab stop.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if smart Backspace handling is enabled.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="view" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceView.</doc>
+            <type name="View" c:type="GtkSourceView*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
       <method name="get_smart_home_end"
               c:identifier="gtk_source_view_get_smart_home_end">
         <doc xml:space="preserve">Returns a #GtkSourceSmartHomeEndType end value specifying
@@ -11090,7 +11770,10 @@ on the context.</doc>
       <method name="set_draw_spaces"
               c:identifier="gtk_source_view_set_draw_spaces">
         <doc xml:space="preserve">Set if and how the spaces should be visualized. Specifying @flags as 0 will
-disable display of spaces.</doc>
+disable display of spaces.
+
+For a finer-grained method, there is also the GtkSourceTag's
+#GtkSourceTag:draw-spaces property.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -11124,8 +11807,7 @@ be displayed</doc>
         </parameters>
       </method>
       <method name="set_indent_on_tab"
-              c:identifier="gtk_source_view_set_indent_on_tab"
-              version="1.8">
+              c:identifier="gtk_source_view_set_indent_on_tab">
         <doc xml:space="preserve">If %TRUE, when the tab key is pressed when several lines are selected, the
 selected lines are indented of one level instead of being replaced with a \t
 character. Shift+Tab unindents the selection.
@@ -11298,6 +11980,25 @@ course it is still possible to insert a real \t programmatically with the
           </parameter>
         </parameters>
       </method>
+      <method name="set_smart_backspace"
+              c:identifier="gtk_source_view_set_smart_backspace"
+              version="3.18">
+        <doc xml:space="preserve">When set to %TRUE, pressing the Backspace key will try to delete spaces
+up to the previous tab stop.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="view" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceView.</doc>
+            <type name="View" c:type="GtkSourceView*"/>
+          </instance-parameter>
+          <parameter name="smart_backspace" transfer-ownership="none">
+            <doc xml:space="preserve">whether to enable smart Backspace handling.</doc>
+            <type name="gboolean" c:type="gboolean"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="set_smart_home_end"
               c:identifier="gtk_source_view_set_smart_home_end">
         <doc xml:space="preserve">Set the desired movement of the cursor when HOME and END keys
@@ -11376,7 +12077,10 @@ specified lines.</doc>
                 version="2.4"
                 writable="1"
                 transfer-ownership="none">
-        <doc xml:space="preserve">Set if and how the spaces should be visualized.</doc>
+        <doc xml:space="preserve">Set if and how the spaces should be visualized.
+
+For a finer-grained method, there is also the GtkSourceTag's
+#GtkSourceTag:draw-spaces property.</doc>
         <type name="DrawSpacesFlags"/>
       </property>
       <property name="highlight-current-line"
@@ -11418,6 +12122,13 @@ specified lines.</doc>
         <doc xml:space="preserve">Whether to display the right margin.</doc>
         <type name="gboolean" c:type="gboolean"/>
       </property>
+      <property name="smart-backspace"
+                version="3.18"
+                writable="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">Whether smart Backspace should be used.</doc>
+        <type name="gboolean" c:type="gboolean"/>
+      </property>
       <property name="smart-home-end"
                 version="2.0"
                 writable="1"
@@ -11725,6 +12436,24 @@ all #GtkSourceEncoding's. Free with g_slist_free().</doc>
         <type name="Encoding" c:type="const GtkSourceEncoding*"/>
       </return-value>
     </function>
+    <function name="encoding_get_default_candidates"
+              c:identifier="gtk_source_encoding_get_default_candidates"
+              moved-to="Encoding.get_default_candidates"
+              version="3.18">
+      <doc xml:space="preserve">Gets the list of default candidate encodings to try when loading a file. See
+gtk_source_file_loader_set_candidate_encodings().
+
+This function returns a different list depending on the current locale (i.e.
+language, country and default encoding). The UTF-8 encoding and the current
+locale encoding are guaranteed to be present in the returned list.</doc>
+      <return-value transfer-ownership="container">
+        <doc xml:space="preserve">the list of
+default candidate encodings. Free with g_slist_free().</doc>
+        <type name="GLib.SList" c:type="GSList*">
+          <type name="Encoding"/>
+        </type>
+      </return-value>
+    </function>
     <function name="encoding_get_from_charset"
               c:identifier="gtk_source_encoding_get_from_charset"
               moved-to="Encoding.get_from_charset"
@@ -11780,7 +12509,7 @@ better to escape those special characters to better fit in the search entry.
 See also: gtk_source_utils_unescape_search_text().
 
 &lt;warning&gt;
-The escape and unescape functions are not reciprocal! For example,
+Warning: the escape and unescape functions are not reciprocal! For example,
 escape (unescape (\)) = \\. So avoid cycles such as: search entry -&gt; unescape
 -&gt; search settings -&gt; escape -&gt; search entry. The original search entry text
 may be modified.