Update manual

Author: dd86k

man/ddh.1

@@ -4,7 +4,7 @@
 ." Please read man-pages(7) and groff_man(7) about the manual page format.
 ." If you're missing groff_man.7, install groff. Solid documentation.
 ."
-.TH ddh 1 "December 2020" dd86k "User manual"
+.TH ddh 1 "September 2021" dd86k "User manual"
 .SH NAME
 ddh \(em Generic hasher
 
@@ -13,9 +13,6 @@ ddh \(em Generic hasher
 .B  {list|ver|help|version|license}
 .SY ddh
 .B  alias
-.OP -
-.SY ddh
-.B  alias
 .OP options...
 .B  {files|-}...
 .YS
@@ -25,12 +22,13 @@ ddh \(em Generic hasher
 is a generic hasher. The main goal of this utility is to centralize
 the various options into one package for multiple systems.
 
-The output matches the one of the coreutils sum (e.g., sha1sum) utilities for
-compability reasons.
+By default, the GNU-style checksums are used. You can use
+.I --tag
+to switch to the BSD-style checksums. This affects reading lists.
 
-The default operating mode is FILE for being the best case scenario for
+The default entry mode is File for being the best case scenario for
 behaving better on zero-length files, network shares, and on most
-operating systems.
+operating systems. The Mmfile option is good for performance reasons.
 
 .SH EXAMPLES
 
@@ -63,16 +61,17 @@ Use SHA-256 to hash all files in the
 folder.
 
 .TP
-.BI ddh\ md5 \ -Ms \ *.{json,md}
+.BI ddh\ md5 \ -Ms \ "*.{json,md}"
 Use MD5 to hash all files in sub-directories
 .RI ( -s )
 that end with .json or .md using the memory-mapped file option
-.RI ( -M ).
+.RI ( -M )
+using the embedded glob matcher.
 
 .TP
 .BI ddh\ sha256 \ -c\ list
 Use SHA-256 to verify the integrity a list of files. This is similar to
-.BR sha1sum\ -c\ list .
+.BR sha256sum\ -c\ list .
 
 .SH ALIASES
 
@@ -84,42 +83,48 @@ Below is a list of supported checksum and hash algorithms.
 
 
 .TS
-l l.
-Alias	Name
+l l l.
+Alias	Name	Tag
 .T&
-lB l.
+lB l l.
 _
-crc32	CRC-32
-crc64iso	CRC-64-ISO
-crc64ecma	CRC-64-ECMA
-md5	MD5-128
-ripemd160	RIDEMD-160
-sha1	SHA-1-160
-sha224	SHA-2-224
-sha256	SHA-2-256
-sha384	SHA-2-384
-sha512	SHA-2-512
-sha3-224	SHA-3-224
-sha3-256	SHA-3-256
-sha3-384	SHA-3-384
-sha3-512	SHA-3-512
-shake128	SHAKE-128
-shake256	SHAKE-256
+crc32	CRC-32	CRC32
+crc64iso	CRC-64-ISO	CRC64ISO
+crc64ecma	CRC-64-ECMA	CRC64ECMA
+md5	MD5-128	MD5
+ripemd160	RIPEMD-160	RIPEMD160
+sha1	SHA-1-160	SHA1
+sha224	SHA-2-224	SHA224
+sha256	SHA-2-256	SHA256
+sha384	SHA-2-384	SHA384
+sha512	SHA-2-512	SHA512
+sha3-224	SHA-3-224	SHA3_224
+sha3-256	SHA-3-256	SHA3_256
+sha3-384	SHA-3-384	SHA3_384
+sha3-512	SHA-3-512	SHA3_512
+shake128	SHAKE-128	SHAKE128
+shake256	SHAKE-256	SHAKE256
 .TE
 
 .SH OPTIONS
 
-Options beforehand the
-.I files...
-specification affects the set of all current and future files unless new
-options are defined for the current and future set of files.
-
 Short options can be combined. Options that expect an additional argument
 (i.e., the following argument) should not be combined, this includes
 .I -c
 and
 .IR -a .
 
+.SS Entry methods
+.TS
+l l.
+Option	Description
+.T&
+lB l.
+-a, --arg	Hash argument text as UTF-8.
+-c, --check	Check hashes against a file.
+-	Set input mode to stdin.
+.TE
+
 .SS File input modes
 .TS
 l l.
@@ -131,9 +136,6 @@ _
 -b, --binary	File: Set read mode to binary (default).
 -t, --text	File: Set read mode to text.
 -M, --mmfile	Set input mode to memory-mapped file.
--a, --arg	Hash the follow argument as text (UTF-8).
--c, --check	Set input mode to check file.
--	Set input mode to stdin.
 .TE
 
 .SS Embedded globber engine
@@ -157,23 +159,20 @@ Option	Description
 .T&
 lB l.
 _
---	Stop argument parsing, forever.
+--tag	Create or read BSD-style checksums.
+--	Stop parsing arguments.
 .TE
 
 .SH WARNINGS
 
-The \-\-mmfile option does not support files of size zero.
+None for the moment!
 
 .SH NOTES
 
 UNIX-like shells use their own globbing mechanism. To use the embedded
 globbing mechanism, use '*' or \\*.
 
-The garbage collector is explicitly configured to be disabled when the program
-is started, and avoids collecting when the program stops for performance
-reasons. It is only re-enabled when the user specifies \-\-mmfile.
-
-Release versions of this utility has the druntime gcopts command-line
+Release versions of this utility has the druntime GC command-line
 interface disabled.
 
 .SH AUTHOR