.SH DESCRIPTION
The
.B fshash
-program generates digests of filesystems. It's similar in concept (but
-somewhat different from) Ian Jackson's
+program generates digests of filesystems. It's similar in concept to
+(but somewhat different from) Ian Jackson's
.BR summer (1)
tool.
.PP
.I hash
function, which can be any hash function supported by Python's
.BR hashlib .
-If this option may be omitted then the hash is read from the cache file;
-if there is no cache file either, then an error is reported.
+This option may be omitted: if it is, then the hash is read from the
+cache file; if there is no cache file either, then an error is reported.
.PP
Positional arguments are interpreted as files and directories to be
processed, in order. A directory name which ends in
.I Errors
If there was an error reading the object's metadata then the information
field shows
-.BI Enn
+.BI E nn
.IR message ,
and the other fields, except the name, are printed as
.B error
.BR symbolic-link .
The name is followed by
.RB ` \~\->\~ '
-and the link target (or by
+and the link target (or
.BI <E nn \~ message >
if there was an error reading the link destination).
.TP