[glib] docs: Be more precise on the use of set_resource_base_path()



commit a81568273c2fedf6ac435dcd51731f8e79840694
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Tue Dec 1 12:57:02 2015 +0000

    docs: Be more precise on the use of set_resource_base_path()
    
    The current wording is a bit vague on when to call
    set_resource_base_path() in a GApplication implementation.

 gio/gapplication.c |    7 ++++++-
 1 files changed, 6 insertions(+), 1 deletions(-)
---
diff --git a/gio/gapplication.c b/gio/gapplication.c
index 98649b1..551e8ce 100644
--- a/gio/gapplication.c
+++ b/gio/gapplication.c
@@ -1767,7 +1767,12 @@ g_application_get_resource_base_path (GApplication *application)
  *
  * Changing the resource base path once the application is running is
  * not recommended.  The point at which the resource path is consulted
- * for forming paths for various purposes is unspecified.
+ * for forming paths for various purposes is unspecified.  When writing
+ * a sub-class of #GApplication you should either set the
+ * #GApplication:resource-base-path property at construction time, or call
+ * this function during the instance initialization. Alternatively, you
+ * can call this function in the #GApplicationClass.startup virtual function,
+ * before chaining up to the parent implementation.
  *
  * Since: 2.42
  */


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]