4 ms·
I for one prefer actual manpages than online documentation. The web documentation is cumbersome to find, forces me to open a browser window, and I cannot copy-p
by enriquto 8y ago
I for one prefer actual manpages than online documentation. The web documentation is cumbersome to find, forces me to open a browser window, and I cannot copy-paste easily from inside my terminal.
Notice that if you already have help, you can build the manpages automatically from them using "help2man". You could get manpages for all your tools by simply adding a line into your makefile!
- dickeytk 8y agoIf the man pages are simply generated from the help output, why bother having them when you can just use `--help`?
- TeMPOraL 8y agoBecause the expectation on UNIX-like systems is that I can type `man foo` and get the manpage for `foo`. It's good manners for a CLI app you want installed on someone's system to also integrate with the help infrastructure of that system.
- scbrg 8y agoapropos
- JdeBP 8y agoThe end result argues against using help2man and thinking that --help and the user manual should be the same thing, not against having a user manual at all. (-: * https://news.ycombinator.com/item?id=18174025 https://news.ycombinator.com/item?id=18174025