Bump version

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dano"
-version = "0.8.2"
+version = "0.8.3"
 edition = "2021"
 keywords = ["checksum", "verify", "media", "cli-utility", "storage"]
 description = "A CLI tool for generating checksums of media bitstreams"
@@ -25,7 +25,7 @@ which = { version = "5.0.0", default-features = false }
 serde = { version = "1.0.163", features = ["derive"] }
 serde_json = { version = "1.0.96" } # need alloc or std
 itertools = { version = "0.12.0" } # use_std, use_alloc for into_group_map_by()
-crossbeam-channel = { version = "0.5.8", default-features = false }
+crossbeam-channel = { version = "0.5.10", default-features = false, features = ["std"] }
 num_cpus = { version = "1.15", default-features = false }
 xattr = { version = "1.0.0", default-features = false }
 

dano.1

@@ -1,47 +1,60 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
-.TH DANO "1" "May 2023" "dano 0.8.2" "User Commands"
+.TH DANO "1" "December 2023" "dano 0.8.3" "User Commands"
 .SH NAME
-dano \- manual page for dano 0.8.2
+dano \- manual page for dano 0.8.3
 .SH DESCRIPTION
-dano 0.8.2
-dano is a wrapper for ffmpeg that checksums the internal file streams of certain media files, and
-stores them in a format which can be used to verify such checksums later.  This is handy, because,
-should you choose to change metadata tags, or change file names, the media checksums should remain
-the same.
+dano 0.8.3
+dano is a wrapper for ffmpeg that checksums the internal bitstreams of held within certain media
+files/containers, and stores them in a format which can be used to verify such checksums later.
+This is handy, because, should you choose to change metadata tags, or change file names, the media
+checksums should remain the same.
 .SS "USAGE:"
 .IP
 dano [OPTIONS] [\-\-] [INPUT_FILES]...
 .SS "ARGS:"
 .TP
 <INPUT_FILES>...
-input files to be hashed or verified.  INPUT_FILES can also be read from
-stdin for NULL or NEWLINE delimited inputs.
+select the input files to be hashed or verified, etc.  INPUT_FILES can
+also be read from stdin for NULL or NEWLINE delimited inputs.  By
+default, files which don't appear to be valid extensions for ffmpeg are
+filtered with a WARN message, unless the SILENT flag is enabled.  Hidden
+files (so\-called dot files), files with no name, or no extension are
+silently ignored.  The default behavior can be disabled with the
+DISABLE_FILTER flag.
 .SS "OPTIONS:"
 .HP
 \fB\-o\fR, \fB\-\-output\-file=\fR<OUTPUT_FILE>...
 .IP
-output file which will contain the recorded file information. If not specified,
+select the output file to record the file information. If not specified,
 \&'dano_hashes.txt' in the current working directory will be used.
 .HP
 \fB\-k\fR, \fB\-\-hash\-file=\fR<HASH_FILE>...
+.TP
+select the file from which to read recorded file information.
+If not specified, the
 .IP
-file from which to read recorded file information. If not specified, the output file 
-will be used (or if not specified 'dano_hashes.txt' in the current working directory).
+output file will be used (or if not specified, 'dano_hashes.txt' in the current working
+directory will be used).
 .HP
 \fB\-w\fR, \fB\-\-write\fR
+.TP
+write the new input files' hash information.
+If no other flags are specified, dano will
 .IP
-write the new input files' hash information (and ignore files that already have file
-hashes).
+ignore files which already have file hashes.
 .HP
 \fB\-t\fR, \fB\-\-test\fR
+.TP
+verify the recorded file information.
+Prints the pass/fail status, and exits with a
 .IP
-verify the recorded file information.  Prints the pass/fail status, exits with a 
-non\-zero code if failed, and, potentially, performs write operations, like \fB\-\-write\-new\fR
-or \fB\-\-overwrite\fR.
+non\-zero code, if failed, and can, potentially, performs write operations when
+specified, by the WRITE_NEW and OVERWRITE_OLD flags.
 .HP
 \fB\-p\fR, \fB\-\-print\fR
 .IP
-pretty print all recorded file information (in hash file and xattrs).
+pretty print all recorded file information (discovered within both the hash file and any
+xattrs).
 .HP
 \fB\-\-dump\fR
 .IP
@@ -53,59 +66,82 @@ test/compare).
 show any hash value duplicates discovered when reading back recorded file information
 (in hash file and xattrs).
 .HP
+\fB\-\-clean\fR
+.IP
+remove any hash files, given as input files, and remove any extended attributes, given
+as input files.
+.HP
 \fB\-\-import\-flac\fR
 .IP
-import flac checksums and write as dano recorded file information.
+import flac checksums and write such information as dano recorded file information.
 .HP
 \fB\-j\fR, \fB\-\-threads=\fR<NUM_THREADS>...
+.TP
+requested number of threads to use for file processing.
+Default is the number of
 .IP
-requested number of threads to use for file processing.  Default is the number of logical cores.
+logical cores.
 .HP
 \fB\-s\fR, \fB\-\-silent\fR
 .IP
-quiet many informational messages (like "OK").
+quiet many informational messages (such as "OK").
 .HP
 \fB\-\-write\-new\fR
 .IP
-if new files are present in TEST mode, append such file info.
+in TEST mode, when not writing to an extended attribute, if new files are present, write
+new file info to the hash file.
 .HP
 \fB\-\-overwrite\fR
 .IP
-if one file's hash matches another's, but they have different file name's, overwrite the
-old file's info with the most current.
+in TEST mode, when not writing to an extended attribute, if a file's hash matches a
+recorded hash, but that file now has a different file name, overwrite file info with the
+most current to the hash file.
 .HP
 \fB\-\-disable\-filter\fR
 .IP
-by default, file extensions not recognized by ffmpeg are filtered.  Here, you may disable such filtering.
+disable the default filtering of file extensions which ffmpeg lists as "common"
+extensions for supported file formats.
 .HP
 \fB\-\-canonical\-paths\fR
 .IP
-use canonical paths (instead of potentially relative paths).
+use canonical paths (paths from the root directory) instead of potentially relative
+paths.
 .HP
 \fB\-x\fR, \fB\-\-xattr\fR
 .IP
-try to write (dano will always try to read) hash to/from file's extended attributes.
-Can also be enabled by setting environment variable DANO_XATTR_WRITES to any value.
-When XATTR is enabled, if a write is requested, dano will always overwrite extended
-attributes previously written.
+try to write (dano will always try to read) hash to any input file's extended
+attributes.  Can also be enabled by setting environment variable DANO_XATTR_WRITES to
+any value (such as: export DANO_XATTR_WRITES=enabled).  When XATTR is enabled, if a
+write is requested, dano will always overwrite extended attributes previously written.
 .HP
 \fB\-\-hash\-algo=\fR<HASH_ALGO>...
+.TP
+specify the algorithm to use for hashing.
+Default is 'murmur3'. [possible values:
 .IP
-specify the algorithm to use for hashing.  Default is 'murmur3'. 
-[possible values: murmur3, md5, crc32, adler32, sha1, sha160, sha256, sha384, sha512]
+murmur3, md5, crc32, adler32, sha1, sha160, sha256, sha384, sha512]
 .HP
 \fB\-\-decode\fR
+.TP
+decode internal bitstream before hashing.
+This option makes testing and writes much
 .IP
-decode stream before hashing.  Much slower, but potentially useful for lossless formats.
+slower, but this option is potentially useful for lossless formats.
 .HP
 \fB\-\-rewrite\fR
+.TP
+rewrite all recorded hashes to the latest and greatest format version.
+When specified,
 .IP
-rewrite all recorded hashes to the latest and greatest format version.  
-dano will ignore input files without recorded hashes.
+dano will silently ignore any input files without recorded hashes.
 .HP
 \fB\-\-only=\fR<ONLY>
+.TP
+hash the an input file container's first audio or video stream only, if available.
+dano
 .IP
-hash selected stream only [possible values: audio, video]
+will fall back to default behavior, if no stream is available. [possible values: audio,
+video]
 .HP
 \fB\-\-dry\-run\fR
 .IP