luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-11-04 10:08:56 +01:00
Code Issues Packages Projects Releases Wiki Activity

Improve the docs. (#491968, Areg Beketovski)

Browse Source 
2007-11-09  Matthias Clasen <mclasen@redhat.com>

        * glib/gspawn.c (g_spawn_sync): Improve the docs.  (#491968,
        Areg Beketovski)


svn path=/trunk/; revision=5846
This commit is contained in:
Matthias Clasen
2007-11-09 16:45:42 +00:00
committed by Matthias Clasen
parent dd9cdb33aa
commit d451314384
2 changed files with 21 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@@ -1,3 +1,8 @@
2007-11-09 Matthias Clasen <mclasen@redhat.com>
* glib/gspawn.c (g_spawn_sync): Improve the docs. (#491968,
Areg Beketovski)
2007-11-08 Matthias Clasen <mclasen@redhat.com> 2007-11-08 Matthias Clasen <mclasen@redhat.com>
* glib/gmain.c (g_main_context_release): * glib/gmain.c (g_main_context_release):

27
glib/gspawn.c
View File

@@ -191,22 +191,27 @@ read_data (GString *str,
* @working_directory: child's current working directory, or %NULL to inherit parent's * @working_directory: child's current working directory, or %NULL to inherit parent's
* @argv: child's argument vector * @argv: child's argument vector
* @envp: child's environment, or %NULL to inherit parent's * @envp: child's environment, or %NULL to inherit parent's
* @flags: flags from #GSpawnFlags * @flags: flags from #GSpawnFlags
* @child_setup: function to run in the child just before exec() * @child_setup: function to run in the child just before exec()
* @user_data: user data for @child_setup * @user_data: user data for @child_setup
* @standard_output: return location for child output * @standard_output: return location for child output, or %NULL
* @standard_error: return location for child error messages * @standard_error: return location for child error messages, or %NULL
* @exit_status: return location for child exit status, as returned by waitpid() * @exit_status: return location for child exit status, as returned by waitpid(), or %NULL
* @error: return location for error * @error: return location for error, or %NULL
* *
* Executes a child synchronously (waits for the child to exit before returning). * Executes a child synchronously (waits for the child to exit before returning).
* All output from the child is stored in @standard_output and @standard_error, * All output from the child is stored in @standard_output and @standard_error,
* if those parameters are non-%NULL. If @exit_status is non-%NULL, the exit * if those parameters are non-%NULL. Note that you must set the
* status of the child is stored there as it would be returned by * %G_SPAWN_STDOUT_TO_DEV_NULL and %G_SPAWN_STDERR_TO_DEV_NULL flags when
* waitpid(); standard UNIX macros such as WIFEXITED() and WEXITSTATUS() * passing %NULL for @standard_output and @standard_error.
* must be used to evaluate the exit status. If an error occurs, no data is * If @exit_status is non-%NULL, the exit status of the child is stored
* returned in @standard_output, @standard_error, or @exit_status. * there as it would be returned by waitpid(); standard UNIX macros such
* * as WIFEXITED() and WEXITSTATUS() must be used to evaluate the exit status.
* Note that this function call waitpid() even if @exit_status is %NULL, and
* does not accept the %G_SPAWN_DO_NOT_REAP_CHILD flag.
* If an error occurs, no data is returned in @standard_output,
* @standard_error, or @exit_status.
*
* This function calls g_spawn_async_with_pipes() internally; see that * This function calls g_spawn_async_with_pipes() internally; see that
* function for full details on the other parameters and details on * function for full details on the other parameters and details on
* how these functions work on Windows. * how these functions work on Windows.