14

Wouldn't it be more consistent if one of these always worked?

  • 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 4:32
  • 4
    Reality is worse than you describe: many commands have full documentation in info format. – mouviciel Sep 10 '10 at 8:22
  • 3
    you should totally make this a [feature-request]... – Tobias Kienzler Sep 10 '10 at 8:52
  • 2
    @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 9:46
16

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.

9

I agree with xenoterracide - 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.

1

Some people do not like man pages, and write info files instead (notably GNU).

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.