arc4random.3: Raise the severity of the CAVEATS to BUGS

This is a misdesign that the original OpenBSD developers fail to
acknowledge.

Link: <https://inbox.sourceware.org/libc-alpha/068b01c4-d0c4-0849-eabb-09c020a1480b@gmail.com/T/>
Cc: "Jason A. Donenfeld" <Jason@zx2c4.com>
Cc: Arsen Arsenović <arsen@aarsen.me>
Cc: Sam James <sam@gentoo.org>
Cc: "Serge E. Hallyn" <serge@hallyn.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man3/arc4random.3 b/man3/arc4random.3
index 6128ba7a4de2343418521d667a1bf26853acfbd2..6e25cfb381e0c425c3efba607d20bb0ed8b14f22 100644 (file)
--- a/man3/arc4random.3
+++ b/man3/arc4random.3
@@ -26,7 +26,7 @@ returns a uniformly-distributed value.
 .BR arc4random_uniform ()
 returns a uniformly-distributed value less than
 .I upper_bound
-(see CAVEATS).
+(see BUGS).
 .PP
 .BR arc4random_buf ()
 fills the memory pointed to by
@@ -80,7 +80,7 @@ T}    Thread safety   MT-Safe
 .sp 1
 .SH STANDARDS
 These nonstandard functions are present on several Unix systems.
-.SH CAVEATS
+.SH BUGS
 An
 .I upper_bound
 of