gtksourceview3 3.0.9-x86-mingw32 → 3.1.0-x86-mingw32

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

@@ -780,12 +780,15 @@ closing bracket character will be highlighted.</doc>
       </method>
       <method name="set_highlight_syntax"
               c:identifier="gtk_source_buffer_set_highlight_syntax">
-        <doc xml:space="preserve">Controls whether syntax is highlighted in the buffer. If @highlight
-is %TRUE, the text will be highlighted according to the syntax
-patterns specified in the language set with
-gtk_source_buffer_set_language(). If @highlight is %FALSE, syntax highlighting
-is disabled and all the GtkTextTag objects that have been added by the
-syntax highlighting engine are removed from the buffer.</doc>
+        <doc xml:space="preserve">Controls whether syntax is highlighted in the buffer.
+
+If @highlight is %TRUE, the text will be highlighted according to the syntax
+patterns specified in the #GtkSourceLanguage set with
+gtk_source_buffer_set_language().
+
+If @highlight is %FALSE, syntax highlighting is disabled and all the
+#GtkTextTag objects that have been added by the syntax highlighting engine
+are removed from the buffer.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -835,11 +838,11 @@ content is not modified when saved into a file.</doc>
       </method>
       <method name="set_language"
               c:identifier="gtk_source_buffer_set_language">
-        <doc xml:space="preserve">Associate a #GtkSourceLanguage with the buffer. If @language is
-not-%NULL and syntax highlighting is enabled (see gtk_source_buffer_set_highlight_syntax()),
-the syntax patterns defined in @language will be used to highlight the text
-contained in the buffer. If @language is %NULL, the text contained in the
-buffer is not highlighted.
+        <doc xml:space="preserve">Associates a #GtkSourceLanguage with the buffer.
+
+Note that a #GtkSourceLanguage affects not only the syntax highlighting, but
+also the [context classes][context-classes]. If you want to disable just the
+syntax highlighting, see gtk_source_buffer_set_highlight_syntax().
 
 The buffer holds a reference to @language.</doc>
         <return-value transfer-ownership="none">
@@ -884,8 +887,19 @@ If @max_undo_levels is 0, the undo/redo is disabled.</doc>
       </method>
       <method name="set_style_scheme"
               c:identifier="gtk_source_buffer_set_style_scheme">
-        <doc xml:space="preserve">Sets style scheme used by the buffer. If @scheme is %NULL no
-style scheme is used.</doc>
+        <doc xml:space="preserve">Sets a #GtkSourceStyleScheme to be used by the buffer and the view.
+
+Note that a #GtkSourceStyleScheme affects not only the syntax highlighting,
+but also other #GtkSourceView features such as highlighting the current line,
+matching brackets, the line numbers, etc.
+
+Instead of setting a %NULL @scheme, it is better to disable syntax
+highlighting with gtk_source_buffer_set_highlight_syntax(), and setting the
+#GtkSourceStyleScheme with the "classic" or "tango" ID, because those two
+style schemes follow more closely the GTK+ theme (for example for the
+background color).
+
+The buffer holds a reference to @scheme.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -3757,14 +3771,14 @@ info widget.</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">The name for the provider</doc>
+            <doc xml:space="preserve">The name for the provider, or %NULL.</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
           <parameter name="icon"
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">A specific icon for the provider</doc>
+            <doc xml:space="preserve">A specific icon for the provider, or %NULL.</doc>
             <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
           </parameter>
         </parameters>
@@ -3914,7 +3928,9 @@ the line will be drawn (i.e. it has the same effect as specifying all of them).<
               value="4"
               c:identifier="GTK_SOURCE_DRAW_SPACES_NEWLINE"
               glib:nick="newline">
-        <doc xml:space="preserve">whether the line breaks should be drawn.</doc>
+        <doc xml:space="preserve">whether the line breaks should be drawn. If
+  the #GtkSourceBuffer:implicit-trailing-newline property is %TRUE, a line
+  break is also drawn at the end of the buffer.</doc>
       </member>
       <member name="nbsp"
               value="8"
@@ -5852,7 +5868,8 @@ be taken into account to properly draw the different possible states
                      transfer-ownership="none"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">return location for the x-alignment (can be %NULL)</doc>
+            <doc xml:space="preserve">return location for the x-alignment,
+  or %NULL to ignore.</doc>
             <type name="gfloat" c:type="gfloat*"/>
           </parameter>
           <parameter name="yalign"
@@ -5861,7 +5878,8 @@ be taken into account to properly draw the different possible states
                      transfer-ownership="none"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">return location for the y-alignment (can be %NULL)</doc>
+            <doc xml:space="preserve">return location for the y-alignment,
+  or %NULL to ignore.</doc>
             <type name="gfloat" c:type="gfloat*"/>
           </parameter>
         </parameters>
@@ -5922,7 +5940,8 @@ renderer is aligned (see :xalign and :yalign).</doc>
                      transfer-ownership="none"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">return location for the x-padding (can be %NULL)</doc>
+            <doc xml:space="preserve">return location for the x-padding,
+  or %NULL to ignore.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
           <parameter name="ypad"
@@ -5931,7 +5950,8 @@ renderer is aligned (see :xalign and :yalign).</doc>
                      transfer-ownership="none"
                      optional="1"
                      allow-none="1">
-            <doc xml:space="preserve">return location for the y-padding (can be %NULL)</doc>
+            <doc xml:space="preserve">return location for the y-padding,
+  or %NULL to ignore.</doc>
             <type name="gint" c:type="gint*"/>
           </parameter>
         </parameters>
@@ -6782,7 +6802,7 @@ text wrapping).</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the icon</doc>
+            <doc xml:space="preserve">the icon, or %NULL.</doc>
             <type name="Gio.Icon" c:type="GIcon*"/>
           </parameter>
         </parameters>
@@ -6802,7 +6822,7 @@ text wrapping).</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the icon name</doc>
+            <doc xml:space="preserve">the icon name, or %NULL.</doc>
             <type name="utf8" c:type="const gchar*"/>
           </parameter>
         </parameters>
@@ -6822,7 +6842,7 @@ text wrapping).</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">the pixbuf</doc>
+            <doc xml:space="preserve">the pixbuf, or %NULL.</doc>
             <type name="GdkPixbuf.Pixbuf" c:type="GdkPixbuf*"/>
           </parameter>
         </parameters>
@@ -9223,6 +9243,378 @@ call to the gtk_source_print_compositor_paginate() function.</doc>
             c:type="GtkSourcePrintCompositorPrivate"
             disguised="1">
     </record>
+    <class name="Region"
+           c:symbol-prefix="region"
+           c:type="GtkSourceRegion"
+           parent="GObject.Object"
+           glib:type-name="GtkSourceRegion"
+           glib:get-type="gtk_source_region_get_type"
+           glib:type-struct="RegionClass">
+      <constructor name="new"
+                   c:identifier="gtk_source_region_new"
+                   version="3.22">
+        <return-value transfer-ownership="full">
+          <doc xml:space="preserve">a new #GtkSourceRegion object for @buffer.</doc>
+          <type name="Region" c:type="GtkSourceRegion*"/>
+        </return-value>
+        <parameters>
+          <parameter name="buffer" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkTextBuffer.</doc>
+            <type name="Gtk.TextBuffer" c:type="GtkTextBuffer*"/>
+          </parameter>
+        </parameters>
+      </constructor>
+      <method name="add_region"
+              c:identifier="gtk_source_region_add_region"
+              version="3.22">
+        <doc xml:space="preserve">Adds @region_to_add to @region. @region_to_add is not modified.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="region_to_add"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the #GtkSourceRegion to add to @region, or %NULL.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="add_subregion"
+              c:identifier="gtk_source_region_add_subregion"
+              version="3.22">
+        <doc xml:space="preserve">Adds the subregion delimited by @_start and @_end to @region.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="_start" transfer-ownership="none">
+            <doc xml:space="preserve">the start of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+          <parameter name="_end" transfer-ownership="none">
+            <doc xml:space="preserve">the end of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_bounds"
+              c:identifier="gtk_source_region_get_bounds"
+              version="3.22">
+        <doc xml:space="preserve">Gets the @start and @end bounds of the @region.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @start and @end have been set successfully (if non-%NULL),
+  or %FALSE if the @region is empty.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">iterator to initialize with the start of @region,
+  or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">iterator to initialize with the end of @region,
+  or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="get_buffer"
+              c:identifier="gtk_source_region_get_buffer"
+              version="3.22">
+        <return-value transfer-ownership="none" nullable="1">
+          <doc xml:space="preserve">the #GtkTextBuffer.</doc>
+          <type name="Gtk.TextBuffer" c:type="GtkTextBuffer*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="get_start_region_iter"
+              c:identifier="gtk_source_region_get_start_region_iter"
+              version="3.22">
+        <doc xml:space="preserve">Initializes a #GtkSourceRegionIter to the first subregion of @region. If
+@region is empty, @iter will be initialized to the end iterator.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="iter"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none">
+            <doc xml:space="preserve">iterator to initialize to the first subregion.</doc>
+            <type name="RegionIter" c:type="GtkSourceRegionIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="intersect_region"
+              c:identifier="gtk_source_region_intersect_region"
+              version="3.22">
+        <doc xml:space="preserve">Returns the intersection between @region1 and @region2. @region1 and
+@region2 are not modified.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the intersection as a #GtkSourceRegion
+  object.</doc>
+          <type name="Region" c:type="GtkSourceRegion*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region1"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #GtkSourceRegion, or %NULL.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="region2"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">a #GtkSourceRegion, or %NULL.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="intersect_subregion"
+              c:identifier="gtk_source_region_intersect_subregion"
+              version="3.22">
+        <doc xml:space="preserve">Returns the intersection between @region and the subregion delimited by
+@_start and @_end. @region is not modified.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">the intersection as a new
+  #GtkSourceRegion.</doc>
+          <type name="Region" c:type="GtkSourceRegion*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="_start" transfer-ownership="none">
+            <doc xml:space="preserve">the start of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+          <parameter name="_end" transfer-ownership="none">
+            <doc xml:space="preserve">the end of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="is_empty"
+              c:identifier="gtk_source_region_is_empty"
+              version="3.22">
+        <doc xml:space="preserve">Returns whether the @region is empty. A %NULL @region is considered empty.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the @region is empty.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #GtkSourceRegion, or %NULL.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="subtract_region"
+              c:identifier="gtk_source_region_subtract_region"
+              version="3.22">
+        <doc xml:space="preserve">Subtracts @region_to_subtract from @region. @region_to_subtract is not
+modified.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="region_to_subtract"
+                     transfer-ownership="none"
+                     nullable="1"
+                     allow-none="1">
+            <doc xml:space="preserve">the #GtkSourceRegion to subtract from
+  @region, or %NULL.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="subtract_subregion"
+              c:identifier="gtk_source_region_subtract_subregion"
+              version="3.22">
+        <doc xml:space="preserve">Subtracts the subregion delimited by @_start and @_end from @region.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+          <parameter name="_start" transfer-ownership="none">
+            <doc xml:space="preserve">the start of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+          <parameter name="_end" transfer-ownership="none">
+            <doc xml:space="preserve">the end of the subregion.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="to_string"
+              c:identifier="gtk_source_region_to_string"
+              version="3.22">
+        <doc xml:space="preserve">Gets a string represention of @region, for debugging purposes.
+
+The returned string contains the character offsets of the subregions. It
+doesn't include a newline character at the end of the string.</doc>
+        <return-value transfer-ownership="full" nullable="1">
+          <doc xml:space="preserve">a string represention of @region. Free
+  with g_free() when no longer needed.</doc>
+          <type name="utf8" c:type="gchar*"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="region" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegion.</doc>
+            <type name="Region" c:type="GtkSourceRegion*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <property name="buffer"
+                version="3.22"
+                writable="1"
+                construct-only="1"
+                transfer-ownership="none">
+        <doc xml:space="preserve">The #GtkTextBuffer. The #GtkSourceRegion has a weak reference to the
+buffer.</doc>
+        <type name="Gtk.TextBuffer"/>
+      </property>
+      <field name="parent_instance">
+        <type name="GObject.Object" c:type="GObject"/>
+      </field>
+    </class>
+    <record name="RegionClass"
+            c:type="GtkSourceRegionClass"
+            glib:is-gtype-struct-for="Region">
+      <field name="parent_class">
+        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
+      </field>
+      <field name="padding">
+        <array zero-terminated="0" c:type="gpointer" fixed-size="8">
+          <type name="gpointer" c:type="gpointer"/>
+        </array>
+      </field>
+    </record>
+    <record name="RegionIter" c:type="GtkSourceRegionIter" version="3.22">
+      <doc xml:space="preserve">#GtkSourceRegionIter is an opaque datatype; ignore all its fields.
+Initialize the iter with gtk_source_region_get_start_region_iter().</doc>
+      <field name="dummy1" readable="0" private="1">
+        <type name="gpointer" c:type="gpointer"/>
+      </field>
+      <field name="dummy2" readable="0" private="1">
+        <type name="guint32" c:type="guint32"/>
+      </field>
+      <field name="dummy3" readable="0" private="1">
+        <type name="gpointer" c:type="gpointer"/>
+      </field>
+      <method name="get_subregion"
+              c:identifier="gtk_source_region_iter_get_subregion"
+              version="3.22">
+        <doc xml:space="preserve">Gets the subregion at this iterator.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @start and @end have been set successfully (if non-%NULL),
+  or %FALSE if @iter is the end iterator or if the region is empty.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegionIter.</doc>
+            <type name="RegionIter" c:type="GtkSourceRegionIter*"/>
+          </instance-parameter>
+          <parameter name="start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">iterator to initialize with the subregion start, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">iterator to initialize with the subregion end, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="is_end"
+              c:identifier="gtk_source_region_iter_is_end"
+              version="3.22">
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether @iter is the end iterator.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegionIter.</doc>
+            <type name="RegionIter" c:type="GtkSourceRegionIter*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+      <method name="next"
+              c:identifier="gtk_source_region_iter_next"
+              version="3.22">
+        <doc xml:space="preserve">Moves @iter to the next subregion.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">%TRUE if @iter moved and is dereferenceable, or %FALSE if @iter has
+  been set to the end iterator.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceRegionIter.</doc>
+            <type name="RegionIter" c:type="GtkSourceRegionIter*"/>
+          </instance-parameter>
+        </parameters>
+      </method>
+    </record>
     <class name="SearchContext"
            c:symbol-prefix="search_context"
            c:type="GtkSourceSearchContext"
@@ -9257,10 +9649,13 @@ gtk_source_search_context_get_settings().</doc>
       </constructor>
       <method name="backward"
               c:identifier="gtk_source_search_context_backward"
-              version="3.10">
+              version="3.10"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Synchronous backward search. It is recommended to use the asynchronous
 functions instead, to not block the user interface. However, if you are sure
 that the @buffer is small, this function is more convenient to use.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_source_search_context_backward2() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether a match was found.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -9294,11 +9689,74 @@ that the @buffer is small, this function is more convenient to use.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="backward2"
+              c:identifier="gtk_source_search_context_backward2"
+              version="3.22">
+        <doc xml:space="preserve">Synchronous backward search. It is recommended to use the asynchronous
+functions instead, to not block the user interface. However, if you are sure
+that the @buffer is small, this function is more convenient to use.
+
+The difference with gtk_source_search_context_backward() is that the
+@has_wrapped_around out parameter has been added for convenience.
+
+If the #GtkSourceSearchSettings:wrap-around property is %FALSE, this function
+doesn't try to wrap around.
+
+The @has_wrapped_around out parameter is set independently of whether a match
+is found. So if this function returns %FALSE, @has_wrapped_around will have
+the same value as the #GtkSourceSearchSettings:wrap-around property.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether a match was found.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="search" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceSearchContext.</doc>
+            <type name="SearchContext" c:type="GtkSourceSearchContext*"/>
+          </instance-parameter>
+          <parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">start of search.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for start of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for end of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="has_wrapped_around"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location to know whether the
+  search has wrapped around, or %NULL.</doc>
+            <type name="gboolean" c:type="gboolean*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="backward_async"
               c:identifier="gtk_source_search_context_backward_async"
               version="3.10">
-        <doc xml:space="preserve">Asynchronous backward search. See the #GAsyncResult documentation to know
-how to use this function.
+        <doc xml:space="preserve">The asynchronous version of gtk_source_search_context_backward2().
+
+See the documentation of gtk_source_search_context_backward2() for more
+details.
+
+See the #GAsyncResult documentation to know how to use this function.
 
 If the operation is cancelled, the @callback will only be called if
 @cancellable was not %NULL. gtk_source_search_context_backward_async() takes
@@ -9343,9 +9801,54 @@ ownership of @cancellable, so you can unref it after calling this function.</doc
       <method name="backward_finish"
               c:identifier="gtk_source_search_context_backward_finish"
               version="3.10"
+              deprecated="1"
+              deprecated-version="3.22"
               throws="1">
         <doc xml:space="preserve">Finishes a backward search started with
 gtk_source_search_context_backward_async().</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_source_search_context_backward_finish2() instead.</doc-deprecated>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether a match was found.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="search" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceSearchContext.</doc>
+            <type name="SearchContext" c:type="GtkSourceSearchContext*"/>
+          </instance-parameter>
+          <parameter name="result" transfer-ownership="none">
+            <doc xml:space="preserve">a #GAsyncResult.</doc>
+            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
+          </parameter>
+          <parameter name="match_start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for start of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for end of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+        </parameters>
+      </method>
+      <method name="backward_finish2"
+              c:identifier="gtk_source_search_context_backward_finish2"
+              version="3.22"
+              throws="1">
+        <doc xml:space="preserve">Finishes a backward search started with
+gtk_source_search_context_backward_async().
+
+See the documentation of gtk_source_search_context_backward2() for more
+details.</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether a match was found.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -9377,14 +9880,27 @@ gtk_source_search_context_backward_async().</doc>
             <doc xml:space="preserve">return location for end of match, or %NULL.</doc>
             <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
           </parameter>
+          <parameter name="has_wrapped_around"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location to know whether the
+  search has wrapped around, or %NULL.</doc>
+            <type name="gboolean" c:type="gboolean*"/>
+          </parameter>
         </parameters>
       </method>
       <method name="forward"
               c:identifier="gtk_source_search_context_forward"
-              version="3.10">
+              version="3.10"
+              deprecated="1"
+              deprecated-version="3.22">
         <doc xml:space="preserve">Synchronous forward search. It is recommended to use the asynchronous
 functions instead, to not block the user interface. However, if you are sure
 that the @buffer is small, this function is more convenient to use.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_source_search_context_forward2() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether a match was found.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -9418,11 +9934,74 @@ that the @buffer is small, this function is more convenient to use.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="forward2"
+              c:identifier="gtk_source_search_context_forward2"
+              version="3.22">
+        <doc xml:space="preserve">Synchronous forward search. It is recommended to use the asynchronous
+functions instead, to not block the user interface. However, if you are sure
+that the @buffer is small, this function is more convenient to use.
+
+The difference with gtk_source_search_context_forward() is that the
+@has_wrapped_around out parameter has been added for convenience.
+
+If the #GtkSourceSearchSettings:wrap-around property is %FALSE, this function
+doesn't try to wrap around.
+
+The @has_wrapped_around out parameter is set independently of whether a match
+is found. So if this function returns %FALSE, @has_wrapped_around will have
+the same value as the #GtkSourceSearchSettings:wrap-around property.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether a match was found.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="search" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceSearchContext.</doc>
+            <type name="SearchContext" c:type="GtkSourceSearchContext*"/>
+          </instance-parameter>
+          <parameter name="iter" transfer-ownership="none">
+            <doc xml:space="preserve">start of search.</doc>
+            <type name="Gtk.TextIter" c:type="const GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for start of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for end of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="has_wrapped_around"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location to know whether the
+  search has wrapped around, or %NULL.</doc>
+            <type name="gboolean" c:type="gboolean*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="forward_async"
               c:identifier="gtk_source_search_context_forward_async"
               version="3.10">
-        <doc xml:space="preserve">Asynchronous forward search. See the #GAsyncResult documentation to know
-how to use this function.
+        <doc xml:space="preserve">The asynchronous version of gtk_source_search_context_forward2().
+
+See the documentation of gtk_source_search_context_forward2() for more
+details.
+
+See the #GAsyncResult documentation to know how to use this function.
 
 If the operation is cancelled, the @callback will only be called if
 @cancellable was not %NULL. gtk_source_search_context_forward_async() takes
@@ -9467,9 +10046,12 @@ ownership of @cancellable, so you can unref it after calling this function.</doc
       <method name="forward_finish"
               c:identifier="gtk_source_search_context_forward_finish"
               version="3.10"
+              deprecated="1"
+              deprecated-version="3.22"
               throws="1">
         <doc xml:space="preserve">Finishes a forward search started with
 gtk_source_search_context_forward_async().</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_source_search_context_forward_finish2() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether a match was found.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -9503,6 +10085,58 @@ gtk_source_search_context_forward_async().</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="forward_finish2"
+              c:identifier="gtk_source_search_context_forward_finish2"
+              version="3.22"
+              throws="1">
+        <doc xml:space="preserve">Finishes a forward search started with
+gtk_source_search_context_forward_async().
+
+See the documentation of gtk_source_search_context_forward2() for more
+details.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether a match was found.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="search" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceSearchContext.</doc>
+            <type name="SearchContext" c:type="GtkSourceSearchContext*"/>
+          </instance-parameter>
+          <parameter name="result" transfer-ownership="none">
+            <doc xml:space="preserve">a #GAsyncResult.</doc>
+            <type name="Gio.AsyncResult" c:type="GAsyncResult*"/>
+          </parameter>
+          <parameter name="match_start"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for start of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_end"
+                     direction="out"
+                     caller-allocates="1"
+                     transfer-ownership="none"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location for end of match, or %NULL.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="has_wrapped_around"
+                     direction="out"
+                     caller-allocates="0"
+                     transfer-ownership="full"
+                     optional="1"
+                     allow-none="1">
+            <doc xml:space="preserve">return location to know whether the
+  search has wrapped around, or %NULL.</doc>
+            <type name="gboolean" c:type="gboolean*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="get_buffer"
               c:identifier="gtk_source_search_context_get_buffer"
               version="3.10">
@@ -9626,6 +10260,8 @@ Free the return value with g_error_free().</doc>
       <method name="replace"
               c:identifier="gtk_source_search_context_replace"
               version="3.10"
+              deprecated="1"
+              deprecated-version="3.22"
               throws="1">
         <doc xml:space="preserve">Replaces a search match by another text. If @match_start and @match_end
 doesn't correspond to a search match, %FALSE is returned.
@@ -9633,6 +10269,7 @@ doesn't correspond to a search match, %FALSE is returned.
 For a regular expression replacement, you can check if @replace is valid by
 calling g_regex_check_replacement(). The @replace text can contain
 backreferences; read the g_regex_replace() documentation for more details.</doc>
+        <doc-deprecated xml:space="preserve">Use gtk_source_search_context_replace2() instead.</doc-deprecated>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">whether the match has been replaced.</doc>
           <type name="gboolean" c:type="gboolean"/>
@@ -9660,6 +10297,46 @@ backreferences; read the g_regex_replace() documentation for more details.</doc>
           </parameter>
         </parameters>
       </method>
+      <method name="replace2"
+              c:identifier="gtk_source_search_context_replace2"
+              version="3.22"
+              throws="1">
+        <doc xml:space="preserve">Replaces a search match by another text. If @match_start and @match_end
+doesn't correspond to a search match, %FALSE is returned.
+
+Unlike with gtk_source_search_context_replace(), the @match_start and
+@match_end iters are revalidated to point to the replacement text boundaries.
+
+For a regular expression replacement, you can check if @replace is valid by
+calling g_regex_check_replacement(). The @replace text can contain
+backreferences; read the g_regex_replace() documentation for more details.</doc>
+        <return-value transfer-ownership="none">
+          <doc xml:space="preserve">whether the match has been replaced.</doc>
+          <type name="gboolean" c:type="gboolean"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="search" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkSourceSearchContext.</doc>
+            <type name="SearchContext" c:type="GtkSourceSearchContext*"/>
+          </instance-parameter>
+          <parameter name="match_start" transfer-ownership="none">
+            <doc xml:space="preserve">the start of the match to replace.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="match_end" transfer-ownership="none">
+            <doc xml:space="preserve">the end of the match to replace.</doc>
+            <type name="Gtk.TextIter" c:type="GtkTextIter*"/>
+          </parameter>
+          <parameter name="replace" transfer-ownership="none">
+            <doc xml:space="preserve">the replacement text.</doc>
+            <type name="utf8" c:type="const gchar*"/>
+          </parameter>
+          <parameter name="replace_length" transfer-ownership="none">
+            <doc xml:space="preserve">the length of @replace in bytes, or -1.</doc>
+            <type name="gint" c:type="gint"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="replace_all"
               c:identifier="gtk_source_search_context_replace_all"
               version="3.10"
@@ -9726,7 +10403,7 @@ gtk_source_search_context_set_highlight().</doc>
                      transfer-ownership="none"
                      nullable="1"
                      allow-none="1">
-            <doc xml:space="preserve">a #GtkSourceStyle.</doc>
+            <doc xml:space="preserve">a #GtkSourceStyle, or %NULL.</doc>
             <type name="Style" c:type="GtkSourceStyle*"/>
           </parameter>
         </parameters>
@@ -9960,7 +10637,11 @@ gtk_text_iter_ends_word().</doc>
               version="3.10">
         <doc xml:space="preserve">Enables or disables whether to search by regular expressions.
 If enabled, the #GtkSourceSearchSettings:search-text property contains the
-pattern of the regular expression.</doc>
+pattern of the regular expression.
+
+#GtkSourceSearchContext uses #GRegex when regex search is enabled. See the
+[Regular expression syntax](https://developer.gnome.org/glib/stable/glib-regex-syntax.html)
+page in the GLib reference manual.</doc>
         <return-value transfer-ownership="none">
           <type name="none" c:type="void"/>
         </return-value>
@@ -10163,6 +10844,33 @@ non-whitespace character when the HOME/END keys are pressed.</doc>
            glib:type-name="GtkSourceStyle"
            glib:get-type="gtk_source_style_get_type"
            glib:type-struct="StyleClass">
+      <method name="apply"
+              c:identifier="gtk_source_style_apply"
+              version="3.22">
+        <doc xml:space="preserve">This function modifies the #GtkTextTag properties that are related to the
+#GtkSourceStyle properties. Other #GtkTextTag properties are left untouched.
+
+If @style is non-%NULL, applies @style to @tag.
+
+If @style is %NULL, the related *-set properties of #GtkTextTag are set to
+%FALSE.</doc>
+        <return-value transfer-ownership="none">
+          <type name="none" c:type="void"/>
+        </return-value>
+        <parameters>
+          <instance-parameter name="style"
+                              transfer-ownership="none"
+                              nullable="1"
+                              allow-none="1">
+            <doc xml:space="preserve">a #GtkSourceStyle to apply, or %NULL.</doc>
+            <type name="Style" c:type="const GtkSourceStyle*"/>
+          </instance-parameter>
+          <parameter name="tag" transfer-ownership="none">
+            <doc xml:space="preserve">a #GtkTextTag to apply styles to.</doc>
+            <type name="Gtk.TextTag" c:type="GtkTextTag*"/>
+          </parameter>
+        </parameters>
+      </method>
       <method name="copy" c:identifier="gtk_source_style_copy" version="2.0">
         <doc xml:space="preserve">Creates a copy of @style, that is a new #GtkSourceStyle instance which
 has the same attributes set.</doc>
@@ -11319,9 +12027,14 @@ if there are undo operations available.</doc>
       <implements name="Gtk.Buildable"/>
       <implements name="Gtk.Scrollable"/>
       <constructor name="new" c:identifier="gtk_source_view_new">
-        <doc xml:space="preserve">Creates a new #GtkSourceView. An empty default #GtkSourceBuffer will be
-created for you and can be retrieved with gtk_text_view_get_buffer(). If you
-want to specify your own buffer, consider gtk_source_view_new_with_buffer().</doc>
+        <doc xml:space="preserve">Creates a new #GtkSourceView.
+
+By default, an empty #GtkSourceBuffer will be lazily created and can be
+retrieved with gtk_text_view_get_buffer().
+
+If you want to specify your own buffer, either override the
+#GtkTextViewClass create_buffer factory method, or use
+gtk_source_view_new_with_buffer().</doc>
         <return-value transfer-ownership="none">
           <doc xml:space="preserve">a new #GtkSourceView.</doc>
           <type name="Gtk.Widget" c:type="GtkWidget*"/>
@@ -12498,7 +13211,7 @@ if not found.</doc>
     <function name="utils_escape_search_text"
               c:identifier="gtk_source_utils_escape_search_text"
               version="3.10">
-      <doc xml:space="preserve">Use this function to escape the following characters: \n, \r, \t and \.
+      <doc xml:space="preserve">Use this function to escape the following characters: `\n`, `\r`, `\t` and `\`.
 
 For a regular expression search, use g_regex_escape_string() instead.
 
@@ -12529,7 +13242,7 @@ may be modified.
               c:identifier="gtk_source_utils_unescape_search_text"
               version="3.10">
       <doc xml:space="preserve">Use this function before gtk_source_search_settings_set_search_text(), to
-unescape the following sequences of characters: \n, \r, \t and \\.
+unescape the following sequences of characters: `\n`, `\r`, `\t` and `\\`.
 The purpose is to easily write those characters in a search entry.
 
 Note that unescaping the search text is not needed for regular expression