logoalt Hacker News

nextaccounticyesterday at 4:02 AM4 repliesview on HN

unfortunately there's a trend lately where many newer cli tools don't have a man page. they put up a --help and think it suffices

even though there are tools to automatically generate man pages those days


Replies

Groxxyesterday at 5:02 PM

I suspect a significant amount of that is due to requiring more than one file (the binary itself) and having to learn about multiple packaging and distribution systems. That's a gigantic wall to climb compared to "put a binary on github"

show 1 reply
wpmyesterday at 4:15 AM

I should write a tool that converts help output to troff, even if the result wouldn't be as detailed and nice to read as a good man page it would save me the frustration of having to stab at "will i get usage docs with a -h, a --help, a -help, or running it with no args at all".

show 5 replies
beej71yesterday at 4:08 AM

I agree. If it can be launched from the command line, it deserves a man page.

Ferret7446yesterday at 8:02 AM

Because installing a man page requires root and a writeable root fs for that matter

show 2 replies