draco icon indicating copy to clipboard operation
draco copied to clipboard

Please include missing man files

Open luyatshimbalanga opened this issue 2 years ago • 3 comments

Hello, while packing draco for Fedora Linux, the tarball misses man files for the binaries for UNIX terminals. It will be great to include them. Easier way to create them is via help2man command with output like draco_decoder.1 and {name}_encoder.1

luyatshimbalanga avatar Jan 17 '23 00:01 luyatshimbalanga

The Draco project has never shipped manual pages. What are you looking for?

Maintaining a dump of the usage text from the command line utilities for generation of manual pages doesn't seem useful or worth the resources involved.

tomfinegan avatar Jan 17 '23 16:01 tomfinegan

When submitting a packaged draco for review on Fedora Linux, one of reviewers asked about getting a manual pages for users running on terminal and to adhere to Fedora packaging guideline. As I learned about a script like help2man (highlighted above) generating a manual and got informed the project never provided since inception, the request deemed unnecessary.

luyatshimbalanga avatar Jan 27 '23 02:01 luyatshimbalanga

Follow up, if the manual page is unneeded, you can close this ticket.

luyatshimbalanga avatar Feb 19 '23 04:02 luyatshimbalanga