[src/trunk]: src/lib/libcrypt Fix typos. Use more markup. New sentence, new l...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/db1db7c4d5dd
branches:  trunk
changeset: 1008527:db1db7c4d5dd
user:      wiz <wiz%NetBSD.org@localhost>
date:      Wed Mar 25 18:53:50 2020 +0000

description:
Fix typos. Use more markup. New sentence, new line.

diffstat:

 lib/libcrypt/pw_gensalt.3 |  36 +++++++++++++++++++-----------------
 1 files changed, 19 insertions(+), 17 deletions(-)

diffs (104 lines):

diff -r 4502da6ce3c1 -r db1db7c4d5dd lib/libcrypt/pw_gensalt.3
--- a/lib/libcrypt/pw_gensalt.3 Wed Mar 25 18:50:47 2020 +0000
+++ b/lib/libcrypt/pw_gensalt.3 Wed Mar 25 18:53:50 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: pw_gensalt.3,v 1.2 2020/03/25 18:37:08 christos Exp $
+.\"    $NetBSD: pw_gensalt.3,v 1.3 2020/03/25 18:53:50 wiz Exp $
 .\"
 .\" Copyright (c) 2020 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -32,7 +32,7 @@
 .Dt PW_GENSALT 3
 .Os
 .Sh NAME
-.Nm pw_gensalt 
+.Nm pw_gensalt
 .Nd passwd salt generation function
 .Sh LIBRARY
 .Lb libcrypt
@@ -42,32 +42,33 @@
 .Fn pw_gensalt "char *salt" "size_t saltlen" "const char *type" "const char *option"
 .Sh DESCRIPTION
 The
-.Fn pw_gensalt 
+.Fn pw_gensalt
 function generates a
 .Dq salt
 to be added to a password hashing function to guarantee uniqueness and
-slow down dictionary and brute force attacks. The function places a
-random array of
-.Ar saltlen bytes in
+slow down dictionary and brute force attacks.
+The function places a random array of
+.Ar saltlen
+bytes in
 .Ar salt
 using the hash function specified in
 .Ar type
 with the function-specific
 .Ar option .
-.Ph
+.Pp
 The new salt types follow the MCF standard and are of the form:
 .Li $<id>[$<param>=<value>(,<param>=<value>)*][$<salt>[$<hash>]]
 The characters allowed in the password salt are alphanumeric and
 include a forward slash and a period.
 .Pp
-.The following types are available:
-.Bl -tag -width blowfish compact
-.It old 
+The following types are available:
+.Bl -tag -width blowfish -compact
+.It old
 The original Unix implementation.
-This is of the form 
+This is of the form
 .Li _Gl/.???? ,
 where
-.Li ?
+.Li \&?
 denotes a random alphanumeric character.
 The minimum salt size is
 .Dv 3 .
@@ -90,7 +91,7 @@
 A salt generated using the
 .Xr md5 1
 algorithm.
-This is of the form 
+This is of the form
 .Li $1$????????$ .
 The minimum salt size is
 .Dv 13 .
@@ -98,14 +99,14 @@
 A salt generated using the
 .Xr sha1 1
 algorithm.
-This is of the form 
+This is of the form
 .Li $sha1$nrounds$????????$ ,
 where
 .Ar nrounds
 is the number of rounds to be used.
 The number of rounds can be specified in
 .Ar option ,
-and defaults to random if 
+and defaults to random if
 .Dv NULL .
 The minimum salt size is
 .Dv 8
@@ -146,7 +147,7 @@
 The
 .Ar saltlen
 was not large enough to fit the salt for the specified
-.Ar type.
+.Ar type .
 .El
 .Sh SEE ALSO
 .Xr passwd 1 ,
@@ -154,4 +155,5 @@
 .Sh HISTORY
 The
 .Fn pw_gensalt
-function was written in 1997 Niels Provos <provos%physnet.uni-hamburg.de@localhost>.
+function was written in 1997 by
+.An Niels Provos Aq Mt provos%physnet.uni-hamburg.de@localhost .