]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/commit
random.3: Clarify confusing summary
authorcem <cem@FreeBSD.org>
Mon, 15 Apr 2019 18:49:04 +0000 (18:49 +0000)
committercem <cem@FreeBSD.org>
Mon, 15 Apr 2019 18:49:04 +0000 (18:49 +0000)
commit993031ca08bb5d9f9687c639120f90c940b177a6
tree23dafd4a9a1f26d6c1b0a0c7e51054e9f8b34d4d
parent654aeb58dd40d3db3af91ce26c9c31d1b02cee5f
random.3: Clarify confusing summary

random.3 is only "better" in contrast to rand.3.  Both are non-cryptographic
pseudo-random number generators.  The opening blurbs of each's DESCRIPTION
section does emphasize this, and correctly directs unfamiliar developers to
arc4random(3).  However, the summary (".Nd" or Name description) of random.3
conflicted in tone and message with that warning.

Resolve the conflict by clarifying in the Nd section that random(3) is
non-cryptographic and pseudo-random.  Elide the "better" qualifier which
implied a comparison but did not provide a specific object to contrast.

Sponsored by: Dell EMC Isilon
lib/libc/stdlib/random.3