[libgsystem] Introspection fixes, use --warn-error

[Colin Walters <walters src gnome org>]

commit aac3668399f8058877cf21ba35617ec4cfecd500
Author: Colin Walters <walters verbum org>
Date:   Sat Dec 8 13:45:59 2012 -0500

    Introspection fixes, use --warn-error
    
    This way we get more of the API for bindings.

 gsystem-file-utils.c         |    2 +-
 gsystem-file-utils.h         |    8 ++++----
 gsystem-subprocess-context.c |   17 ++++++++++++++++-
 gsystem-subprocess.c         |   15 +++++++++++++++
 4 files changed, 36 insertions(+), 6 deletions(-)
---
diff --git a/gsystem-file-utils.c b/gsystem-file-utils.c
index b436923..82d1d6b 100644
--- a/gsystem-file-utils.c
+++ b/gsystem-file-utils.c
@@ -86,7 +86,7 @@ gs_file_read_noatime (GFile         *file,
 }
 
 /**
- * gs_file_map_noatime:
+ * gs_file_map_noatime: (skip)
  * @file: a #GFile
  * @cancellable: a #GCancellable
  * @error: a #GError
diff --git a/gsystem-file-utils.h b/gsystem-file-utils.h
index b0db9e1..fc85584 100644
--- a/gsystem-file-utils.h
+++ b/gsystem-file-utils.h
@@ -29,15 +29,15 @@ const char *gs_file_get_path_cached (GFile *file);
 
 const char *gs_file_get_basename_cached (GFile *file);
 
-GInputStream *gs_file_read_noatime (GFile         *path,
+GInputStream *gs_file_read_noatime (GFile         *file,
                                     GCancellable  *cancellable,
                                     GError       **error);
-GMappedFile *gs_file_map_noatime (GFile         *path,
+GMappedFile *gs_file_map_noatime (GFile         *file,
                                   GCancellable  *cancellable,
                                   GError       **error);
 
-gboolean gs_file_rename (GFile          *src,
-                         GFile          *dest,
+gboolean gs_file_rename (GFile          *from,
+                         GFile          *to,
                          GCancellable   *cancellable,
                          GError        **error);
 
diff --git a/gsystem-subprocess-context.c b/gsystem-subprocess-context.c
index 67bd3db..2615d53 100644
--- a/gsystem-subprocess-context.c
+++ b/gsystem-subprocess-context.c
@@ -23,7 +23,7 @@
 #include "libgsystem.h"
 
 /**
- * SECTION:gssubprocess
+ * SECTION:gssubprocesscontext
  * @title: GSSubprocess Context
  * @short_description: Environment options for launching a child process
  *
@@ -85,6 +85,13 @@ gs_subprocess_context_newv (const gchar  *first_arg,
   return result;
 }
 
+/**
+ * gs_subprocess_context_newa:
+ * @first_arg: First argument
+ * @args: a va_list
+ *
+ * Returns: (transfer full): A new instance of a #GSSubprocessContext.
+ */
 GSSubprocessContext *
 gs_subprocess_context_newa (const gchar *first_arg,
                            va_list      args)
@@ -340,6 +347,14 @@ gs_subprocess_context_set_stderr_fd        (GSSubprocessContext           *self,
 #endif
 
 #ifdef G_OS_UNIX
+/**
+ * gs_subprocess_context_set_child_setup: (skip)
+ * @self:
+ * @child_setup: Function to call in the newly forked child, before execve()
+ * @user_data: Data passed to child
+ *
+ * FIXME - note extensive restricitons on GSpawnChildSetupFunc here
+ */
 void
 gs_subprocess_context_set_child_setup (GSSubprocessContext           *self,
 				      GSpawnChildSetupFunc          child_setup,
diff --git a/gsystem-subprocess.c b/gsystem-subprocess.c
index d016144..4302cab 100644
--- a/gsystem-subprocess.c
+++ b/gsystem-subprocess.c
@@ -502,6 +502,11 @@ gs_subprocess_get_pid (GSSubprocess     *self)
   return self->pid;
 }
 
+/**
+ * gs_subprocess_get_stdin_pipe:
+ *
+ * Returns: (transfer full): Pipe
+ */
 GOutputStream *
 gs_subprocess_get_stdin_pipe (GSSubprocess       *self)
 {
@@ -511,6 +516,11 @@ gs_subprocess_get_stdin_pipe (GSSubprocess       *self)
   return self->stdin_pipe;
 }
 
+/**
+ * gs_subprocess_get_stdout_pipe:
+ *
+ * Returns: (transfer full): Pipe
+ */
 GInputStream *
 gs_subprocess_get_stdout_pipe (GSSubprocess      *self)
 {
@@ -520,6 +530,11 @@ gs_subprocess_get_stdout_pipe (GSSubprocess      *self)
   return self->stdout_pipe;
 }
 
+/**
+ * gs_subprocess_get_stderr_pipe:
+ *
+ * Returns: (transfer full): Pipe
+ */
 GInputStream *
 gs_subprocess_get_stderr_pipe (GSSubprocess      *self)
 {