Output comment clarifying GPid semantics to glibconfig.h.

2008-08-07  Tor Lillqvist  <tml@novell.com>

	* configure.in: Output comment clarifying GPid semantics to
	glibconfig.h.

	* glibconfig.h.win32.in: Ditto here.

svn path=/trunk/; revision=7317

diff --git a/ChangeLog b/ChangeLog
index c54578b..1b2603d 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-08-07  Tor Lillqvist  <tml@novell.com>
+
+       * configure.in: Output comment clarifying GPid semantics to
+       glibconfig.h.
+
+       * glibconfig.h.win32.in: Ditto here.
+
 2008-08-04  Matthias Clasen  <mclasen@redhat.com>
 
        Bug 546329 – API docs for g_utf8_normalize() are incorrect

diff --git a/configure.in b/configure.in
index 8aa7d6e..0c80f2f 100644 (file)
--- a/configure.in
+++ b/configure.in
@@ -2951,6 +2951,12 @@ _______EOF
 
 #define G_MODULE_SUFFIX "$g_module_suffix"
 
+/* A GPid is an abstraction for a process "handle". It is *not* a 
+ * process identifier, the type that getpid() returns. GPid is used in
+ * GLib only in gspawn.h and gmain.h. On POSIX there are no "handles"
+ * as such, but on Windows a GPid is a handle to a process, a kind of
+ * pointer, not a process identifier.
+ */
 typedef $g_pid_type GPid;
 
 G_END_DECLS

diff --git a/glibconfig.h.win32.in b/glibconfig.h.win32.in
index 013a213..2b1a9ce 100644 (file)
--- a/glibconfig.h.win32.in
+++ b/glibconfig.h.win32.in
@@ -241,6 +241,12 @@ union _GSystemThread
 
 #define G_MODULE_SUFFIX "dll"
 
+/* A GPid is an abstraction for a process "handle". It is *not* a 
+ * process identifier, the type that getpid() returns. GPid is used in
+ * GLib only in gspawn.h and gmain.h. On POSIX there are no "handles"
+ * as such, but on Windows a GPid is a handle to a process, a kind of
+ * pointer, not a process identifier.
+ */
 typedef void * GPid;
 
 G_END_DECLS