[gobject-introspection] docs: Mention GI_TYPELIB_PATH

[Emmanuele Bassi <ebassi src gnome org>]

commit c78611cac946bb99d32b9dba0435ba492c40c224
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Tue Jan 30 14:01:06 2018 +0000

    docs: Mention GI_TYPELIB_PATH
    
    The rules for searching typelib files should be properly documented,
    as well as the way to modify the search paths.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=699328

 girepository/girepository.c |   16 ++++++++++++++--
 1 files changed, 14 insertions(+), 2 deletions(-)
---
diff --git a/girepository/girepository.c b/girepository/girepository.c
index df0f247..10282c7 100644
--- a/girepository/girepository.c
+++ b/girepository/girepository.c
@@ -41,6 +41,17 @@
  *
  * #GIRepository is used to manage repositories of namespaces. Namespaces
  * are represented on disk by type libraries (.typelib files).
+ *
+ * ### Discovery of type libraries
+ *
+ * #GIRepository will typically look for a `girepository-1.0` directory
+ * under the library directory used when compiling gobject-introspection.
+ *
+ * It is possible to control the search paths programmatically, using
+ * g_irepository_prepend_search_path(). It is also possible to modify
+ * the search paths by using the `GI_TYPELIB_PATH` environment variable.
+ * The environment variable takes precedence over the default search path
+ * and the g_irepository_prepend_search_path() calls.
  */
 
 
@@ -198,7 +209,8 @@ init_globals (void)
  *   search path
  *
  * Prepends @directory to the typelib search path.
- * See g_irepository_get_search_path().
+ *
+ * See also: g_irepository_get_search_path().
  */
 void
 g_irepository_prepend_search_path (const char *directory)
@@ -1369,7 +1381,7 @@ find_namespace_latest (const gchar  *namespace,
  */
 GList *
 g_irepository_enumerate_versions (GIRepository *repository,
-                        const gchar  *namespace_)
+                                  const gchar  *namespace_)
 {
   GList *ret = NULL;
   GSList *candidates, *link;