Not logged in
Log in now
Create an account
Subscribe to LWN
LWN.net Weekly Edition for December 5, 2013
Deadline scheduling: coming soon?
LWN.net Weekly Edition for November 27, 2013
ACPI for ARM?
LWN.net Weekly Edition for November 21, 2013
Posted Sep 5, 2008 23:29 UTC (Fri) by giraffedata (subscriber, #1954)
I've always thought it was pretty cool that 'git foo --help' would pull up the man page. Yay unix!
As a workaround by git develoeprs for the fact that you can't use the more logical command, 'help git foo', maybe.
It's actually counter-Unix, as the Unix tradition is for --help to give you something more brief than a man page. And the Unix one-program-one-function rule says if you want to display a man page, you should invoke the man page displayer program, not the SCM access program. (That gives you the power to choose the man page displayer, etc.).
Posted Sep 6, 2008 14:54 UTC (Sat) by bronson (subscriber, #4806)
Absolutely true. It would be nice if each Git page started with a good synopsis and maybe a few examples. If those don't answer your questions, you can keep reading.
> And the Unix one-program-one-function rule says if you want to display a man page, you should invoke the man page displayer program, not the SCM access program.
This is only true for typical medium-complexity tools. Man is simply insufficient for more complex programs (most other scms, gdb, etc). At least Git still uses man! gdb and svn require you to use a different reader entirely.
Copyright © 2013, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds