Fix qoflog's comments to reflect a preference for the macros over GLib functions.

This commit is contained in:
John Ralls 2021-09-14 15:59:01 -07:00
parent 74d0630867
commit 824b515430
2 changed files with 6 additions and 5 deletions

View File

@ -93,7 +93,7 @@ gchar * gnc_build_reports_path(const gchar *);
void gnc_scm_log_warn(const gchar *);
void gnc_scm_log_error(const gchar *);
void gnc_scm_log_msg(const gchar *);
void gnc_scm_loDEBUG(const gchar *);
void gnc_scm_log_debug(const gchar *);
%newobject gnc_utf8_strip_invalid_strdup;
gchar * gnc_utf8_strip_invalid_strdup(const gchar *);

View File

@ -73,10 +73,11 @@
* @c "gnc.gui.plugin-pages.sx-list" or
* @c "gnc.register.gnome.cell.quickfill" are
* good examples.
* @li Use glib-provided @c DEBUG(...), @c PINFO(...),
* @c g_warning(...), @c g_critical(...) and
* @c g_error(...) functions in preference to the historical qof/gnc @c
* PINFO, @c PERR (&c.) macros
* @li Prefer the macros defined here (PERR, PWARN, PINFO, etc.) to
* the GLib-provided functions that they wrap because it allows us to
* more easily replace the GLib logging functinos with another
* implementation and besides our macros are able to short-circuit
* GLib's rather slow domain and level matching.
*
* @see qof_log_parse_log_config(const char*)
**/