luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-09-20 17:26:14 +02:00
Code Issues Packages Projects Releases Wiki Activity

Bug 679467 — Mention translation in g_warning() documentation

Browse Source 
Include a line in the documentation for g_warning(), g_error(), g_critical()
and g_debug() mentioning that the messages passed to them typically should not
be translated.

Closes: https://bugzilla.gnome.org/show_bug.cgi?id=679467
This commit is contained in:
Philip Withnall 2012-07-05 20:32:19 +01:00 committed by Philip Withnall
parent 0a10f7375f
commit 8330b09d78
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
glib/gmessages.c
View File

@ -371,7 +371,8 @@ myInvalidParameterHandler(const wchar_t *expression,
* @...: format string, followed by parameters to insert
* into the format string (as with printf())
*
* A convenience function/macro to log a warning message.
* A convenience function/macro to log a warning message. The message should
* typically *not* be translated to the user's language.
*
* This is not intended for end user error reporting. Use of #GError is
* preferred for that instead, as it allows calling functions to perform actions
@ -406,6 +407,9 @@ myInvalidParameterHandler(const wchar_t *expression,
* setting the `G_DEBUG` environment variable (see
* [Running GLib Applications](glib-running.html)).
*
* The message should typically *not* be translated to the
* user's language.
*
* If g_log_default_handler() is used as the log handler function, a new-line
* character will automatically be appended to @..., and need not be entered
* manually.
@ -420,7 +424,8 @@ myInvalidParameterHandler(const wchar_t *expression,
* @...: format string, followed by parameters to insert
* into the format string (as with printf())
*
* A convenience function/macro to log an error message.
* A convenience function/macro to log an error message. The message should
* typically *not* be translated to the user's language.
*
* This is not intended for end user error reporting. Use of #GError is
* preferred for that instead, as it allows calling functions to perform actions
@ -468,7 +473,8 @@ myInvalidParameterHandler(const wchar_t *expression,
* @...: format string, followed by parameters to insert
* into the format string (as with printf())
*
* A convenience function/macro to log a debug message.
* A convenience function/macro to log a debug message. The message should
* typically *not* be translated to the user's language.
*
* If g_log_default_handler() is used as the log handler function, a new-line
* character will automatically be appended to @..., and need not be entered