replace help2man generated manual page with one generated from the Rust code
Forwarding LWN discussion #913131
Please consider removing the help2man generated manual page and replacing it with a manual page generated from the Rust code.
Generated files that are committed to a VCS inevitably get out of date as changes can often update the source files but not the generated files. When they are not present in the VCS then they are always built from source and thus can never get outdated compared to the source files in the VCS. Since help2man isn't part of the Rust ecosystem this makes it hard to run during the Cargo build process, so switching to another generator is needed. In addition help2man does not work in a cross-compilation scenario because it needs to run the compiled binaries, which do not run on the build machine.
Sequoia generates manual pages from clap data structures. A similar approach could be used here, although this project uses StructOpt instead.