All of lore.kernel.org
 help / color / mirror / Atom feed
* A handful of help-related patches
@ 2012-06-27 20:54 Chris Webb
  2012-06-27 20:55 ` [PATCH 1/3] Add config variable to set HTML path for git-help --web Chris Webb
  0 siblings, 1 reply; 15+ messages in thread
From: Chris Webb @ 2012-06-27 20:54 UTC (permalink / raw)
  To: git

Whilst looking at git-rebase, I noticed I have a few local git --help
related patches from a couple of years ago that I use on my own systems.

I'm not sure whether they're just personal quirks, but I thought I should
post them to the list in case they're of wider interest or might be relevant
upstream.

The first two patches allow the HTML path used by git-help --web to be set
in .gitconfig, and allow it to be a URL prefix, so you can do

  [help]
    format = html
    htmlpath = http://git-scm.com/docs

git wibble --help will then open http://git-scm.com/docs/git-wibble.html
instead of /share/doc/git/html/git-wibble.html in your browser.

The third patch adds a help format called 'usage' making git wibble --help
equivalent to git wibble -h, i.e. printing short command-line usage
information. (Generally that's what I want and I end up rather surprised
when I get an unwanted man page because my fingers are trained to type the
more universal --help rather than -h.)

This 'usage' help format is also good for making --help do something useful
other than produce an error message on our cut-down servers without man
pages, web browsers and so on.

Best wishes,

Chris.

^ permalink raw reply	[flat|nested] 15+ messages in thread

end of thread, other threads:[~2012-06-28 23:39 UTC | newest]

Thread overview: 15+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-06-27 20:54 A handful of help-related patches Chris Webb
2012-06-27 20:55 ` [PATCH 1/3] Add config variable to set HTML path for git-help --web Chris Webb
2012-06-27 20:55   ` [PATCH 2/3] Allow help.htmlpath to be an http: URL Chris Webb
2012-06-27 21:05     ` Jeff King
2012-06-27 21:12       ` Chris Webb
2012-06-27 21:32       ` Junio C Hamano
2012-06-27 21:41         ` Chris Webb
2012-06-27 22:11         ` Jeff King
2012-06-27 22:19           ` Chris Webb
2012-06-27 22:52             ` Jeff King
2012-06-28  2:41               ` Junio C Hamano
2012-06-28  6:56               ` Chris Webb
2012-06-28 17:50                 ` Jeff King
2012-06-28 23:39                   ` Chris Webb
2012-06-27 20:55   ` [PATCH 3/3] Add a help format 'usage' to provide brief command usage Chris Webb

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.