AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-15 14:50:06 +00:00
Code Issues Projects Releases Wiki Activity

css: Clarify docs for GtkCssProvider::parser-error

Browse Source 
Some of these errors should not be fatal.

Related: #6736
This commit is contained in:
Matthias Clasen 2024-05-29 09:47:16 -04:00
parent 282510e113
commit 4ec4280e51
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
gtk/gtkcssprovider.c
View File

@ -220,6 +220,9 @@ gtk_css_provider_class_init (GtkCssProviderClass *klass)
* *
* Signals that a parsing error occurred. * Signals that a parsing error occurred.
* *
* The expected error values are in the [error@Gtk.CssParserError]
* and [enum@Gtk.CssParserWarning] enumerations.
*
* The @path, @line and @position describe the actual location of * The @path, @line and @position describe the actual location of
* the error as accurately as possible. * the error as accurately as possible.
* *
@ -228,6 +231,9 @@ gtk_css_provider_class_init (GtkCssProviderClass *klass)
* even all of it to not be parsed at all. So it is a useful idea * even all of it to not be parsed at all. So it is a useful idea
* to check that the parsing succeeds by connecting to this signal. * to check that the parsing succeeds by connecting to this signal.
* *
* Errors in the [enum@Gtk.CssParserWarning] enumeration should not
* be treated as fatal errors.
*
* Note that this signal may be emitted at any time as the css provider * Note that this signal may be emitted at any time as the css provider
* may opt to defer parsing parts or all of the input to a later time * may opt to defer parsing parts or all of the input to a later time
* than when a loading function was called. * than when a loading function was called.