+2020-05-31 Bruno Haible <bruno@clisp.org>
+
+ getrandom, getentropy: Mention the crypto/gc-random module.
+ Suggested by Simon Josefsson in
+ <https://lists.gnu.org/archive/html/bug-gnulib/2020-05/msg00400.html>.
+ * doc/glibc-functions/getrandom.texi: Mention the quality issues and the
+ crypto/gc-random module.
+ * doc/glibc-functions/getentropy.texi: Likewise.
+
2020-05-31 Bruno Haible <bruno@clisp.org>
getentropy: Enhance tests.
Portability problems not fixed by Gnulib:
@itemize
@end itemize
+
+Note: This function does not provides high-quality random numbers, as needed
+by some crypto applications. If you want such high-quality random numbers,
+use the function @code{getrandom} with the @code{GRND_RANDOM} flag or (better)
+use the @samp{crypto/gc-random} module and configure with
+@samp{--with-libgcrypt}.
Portability problems not fixed by Gnulib:
@itemize
-This function cannot produce truly random numbers on some platforms:
+This function cannot produce truly random numbers, even when the
+@code{GRND_RANDOM} flag is given, on some platforms:
GNU/Hurd, Mac OS X, GNU/kFreeBSD, FreeBSD 12.0, OpenBSD 6.5, Minix 3.3, AIX 7.1, Haiku, mingw, MSVC 14.
@end itemize
+
+Note: This function does not provides high-quality random numbers, as needed
+by some crypto applications, even when the @code{GRND_RANDOM} flag is given.
+If you want such high-quality random numbers, use the @samp{crypto/gc-random}
+module and configure with @samp{--with-libgcrypt}.