`--out-file` and doc fixes/updates