luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-05 02:36:19 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'gerror-utf8-docs' into 'master'

Browse Source 
gerror: Clarify docs around message requirements

See merge request GNOME/glib!2046
This commit is contained in:
Emmanuele Bassi 2021-04-14 20:25:39 +00:00
commit 7a0bc25792
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
glib/gerror.c
View File

@ -114,6 +114,12 @@
* function (the file being opened, or whatever - though in the * function (the file being opened, or whatever - though in the
* g_file_get_contents() case, the @message already contains a filename). * g_file_get_contents() case, the @message already contains a filename).
* *
* Since error messages may be displayed to the user, they need to be valid
* UTF-8 (all GTK widgets expect text to be UTF-8). Keep this in mind in
* particular when formatting error messages with filenames, which are in
* the 'filename encoding', and need to be turned into UTF-8 using
* g_filename_to_utf8(), g_filename_display_name() or g_utf8_make_valid().
*
* Note, however, that many error messages are too technical to display to the * Note, however, that many error messages are too technical to display to the
* user in an application, so prefer to use g_error_matches() to categorize errors * user in an application, so prefer to use g_error_matches() to categorize errors
* from called functions, and build an appropriate error message for the context * from called functions, and build an appropriate error message for the context