Merge commit 'stable/20110609'

[gnulib.git] / doc / posix-functions / getgroups.texi

diff --git a/doc/posix-functions/getgroups.texi b/doc/posix-functions/getgroups.texi
index e503b22..f9615ad 100644 (file)
--- a/doc/posix-functions/getgroups.texi
+++ b/doc/posix-functions/getgroups.texi
@@ -2,7 +2,7 @@
 @section @code{getgroups}
 @findex getgroups
 
-POSIX specification: @url{http://www.opengroup.org/onlinepubs/9699919799/functions/getgroups.html}
+POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/getgroups.html}
 
 Gnulib module: getgroups
 
@@ -18,8 +18,17 @@ FreeBSD 7.2.
 @item
 On Ultrix 4.3, @code{getgroups (0, NULL)} always fails.  See macro
 @samp{AC_FUNC_GETGROUPS}.
+@item
+On very old systems, this function operated on an array of @samp{int},
+even though that was a different size than an array of @samp{gid_t}.
 @end itemize
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+It is unspecified whether the effective group id will be included in
+the returned list, nor whether the list will be sorted in any
+particular order.  For that matter, some platforms include the
+effective group id twice, if it is also a member of the current
+supplemental group ids.
 @end itemize