Wouldn't it be more consistent if one of these always worked?
Asked
Active
Viewed 1,473 times
18
-
I understand that this might have something to do with cross-platform applications, but I am curious if there are any other reasons – Casebash Sep 10 '10 at 04:32
-
4Reality is worse than you describe: many commands have full documentation in `info` format. – mouviciel Sep 10 '10 at 08:22
-
3you should totally make this a [feature-request]... – Tobias Kienzler Sep 10 '10 at 08:52
-
@Tobias: tagging something feature-request is for requests to add functionality to the site, and belongs on meta. – Kevin M Sep 10 '10 at 16:14
-
3@Tobias++ @Kevin I'm pretty sure Tobias is making a joke ;) – xenoterracide Sep 11 '10 at 21:43
-
1@Kevin M: just kidding. I meant as a feature-request to the devs of unix/linux software – Tobias Kienzler Sep 13 '10 at 09:46
-
[Relevant xkcd](https://xkcd.com/927/) – Wildcard Oct 21 '16 at 22:38
3 Answers
22
Yes it would be more consistent. This has nothing to do with cross-platform and everything to do with developers not writing (wanting to write) documentation. a man page is documentation, --help is mostly programming in nature. I've also seen the case where man pages didn't exist because the developer didn't know how to make one, or convert the documentation from another format, sometimes this is easily remedied.
I would like to note that I wish both always worked.
xenoterracide
- 57,918
- 74
- 184
- 250
13
I agree with @xenoterracide's answer - both would be nice...
I expect --help to report functionality and options real short.
I expect man (or info...) to describe in detail what was previously reported by --help, maybe provide some examples, background etc.
Ardent Coder
- 107
- 7
Nils
- 361
- 3
- 10
1
Some people do not like man pages, and write info files instead (notably GNU).
bhm
- 751
- 4
- 5
-
1Why? And which does `help` use? [Here's the answer.](http://unix.stackexchange.com/a/159817/16521) – Cees Timmerman Oct 22 '14 at 08:42