From dfb89905121c8eb262484c41d4d7b90415db7821 Mon Sep 17 00:00:00 2001 From: Tor Lillqvist Date: Tue, 29 Mar 2005 08:27:02 +0000 Subject: [PATCH] Add Win32 warnings regarding the child setup function. 2005-03-29 Tor Lillqvist * glib/tmpl/spawn.sgml: Add Win32 warnings regarding the child setup function. --- docs/reference/ChangeLog | 5 +++++ docs/reference/glib/tmpl/spawn.sgml | 17 +++++++++++++---- 2 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 1fe143b49..3529912f1 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2005-03-29 Tor Lillqvist + + * glib/tmpl/spawn.sgml: Add Win32 warnings regarding the child + setup function. + 2005-03-21 Matthias Clasen * glib/glib-sections.txt: diff --git a/docs/reference/glib/tmpl/spawn.sgml b/docs/reference/glib/tmpl/spawn.sgml index aab76533b..36615b444 100644 --- a/docs/reference/glib/tmpl/spawn.sgml +++ b/docs/reference/glib/tmpl/spawn.sgml @@ -77,10 +77,19 @@ Flags passed to g_spawn_sync(), g_spawn_async() and g_spawn_async_with_pipes(). Specifies the type of the setup function passed to g_spawn_async(), -g_spawn_sync() and g_spawn_async_with_pipes(). It is called in the -child after GLib has performed all the setup it plans to perform -but before calling exec(). Obviously, actions -taken in this function will only affect the child, not the parent. +g_spawn_sync() and g_spawn_async_with_pipes(). On POSIX platforms it +is called in the child after GLib has performed all the setup it plans +to perform but before calling exec(). On POSIX +actions taken in this function will thus only affect the child, not +the parent. + + + +On Windows the function is called in the parent. Its usefulness on +Windows is thus questionable. In many cases executing the child setup +function in the parent can have ill effects, and you should be very +careful when porting software to Windows that uses child setup +functions. @user_data: user data to pass to the function.