tiny icon indicating copy to clipboard operation
tiny copied to clipboard

add man page

Open ralphptorres opened this issue 1 year ago • 2 comments

It would be nice to have a man page for tiny. I can make a pr if you are not averse to the idea.

ralphptorres avatar Nov 10 '23 13:11 ralphptorres

I'm not against it but I also don't want another documentation to maintain.

I'm curious what do you want to see in the man page for tiny? tiny's command line interface is very simple and --help documents it all, and README is supposed to show detailed usage. If README is missing anything let's update it first.

osa1 avatar Nov 11 '23 08:11 osa1

Understandable. I think the README is actually good and would make a proper man page. That, the config.yml, and this repo's wiki on keys, external sasl can be combined into tiny(1), tiny(5) man pages with minimal editing. I suggest we use scdoc (also used in alacritty man pages) since the syntax is very similar to Markdown's. Once synced up, atomically updating the contents of README, etc. and man pages should be easy.

My only issue with README, etc. is that they are not always bundled with the binary by package managers. And if they are, they will be in different locations such as /usr/share/doc/tiny for README, /usr/share/tiny for config.yml, etc. They are not as convenient and accessible as man tiny for general commands, man 5 tiny for config and keys, etc.

But, I am okay with whatever you decide. :)

ralphptorres avatar Nov 12 '23 05:11 ralphptorres