Documentation / git-web--browse.txton commit Merge branch 'jc/setup' (9e7bd01)
   1git-web--browse(1)
   2==================
   3
   4NAME
   5----
   6git-web--browse - git helper script to launch a web browser
   7
   8SYNOPSIS
   9--------
  10'git-web--browse' [OPTIONS] URL/FILE ...
  11
  12DESCRIPTION
  13-----------
  14
  15This script tries, as much as possible, to display the URLs and FILEs
  16that are passed as arguments, as HTML pages in new tabs on an already
  17opened web browser.
  18
  19The following browsers (or commands) are currently supported:
  20
  21* firefox (this is the default under X Window when not using KDE)
  22* iceweasel
  23* konqueror (this is the default under KDE)
  24* w3m (this is the default outside graphical environments)
  25* links
  26* lynx
  27* dillo
  28* open (this is the default under Mac OS X GUI)
  29
  30OPTIONS
  31-------
  32-b BROWSER|--browser=BROWSER::
  33        Use the specified BROWSER. It must be in the list of supported
  34        browsers.
  35
  36-t BROWSER|--tool=BROWSER::
  37        Same as above.
  38
  39-c CONF.VAR|--config=CONF.VAR::
  40        CONF.VAR is looked up in the git config files. If it's set,
  41        then its value specify the browser that should be used.
  42
  43CONFIGURATION VARIABLES
  44-----------------------
  45
  46The web browser can be specified using a configuration variable passed
  47with the -c (or --config) command line option, or the 'web.browser'
  48configuration variable if the former is not used.
  49
  50You can explicitly provide a full path to your preferred browser by
  51setting the configuration variable 'browser.<tool>.path'. For example,
  52you can configure the absolute path to firefox by setting
  53'browser.firefox.path'. Otherwise, 'git-web--browse' assumes the tool
  54is available in PATH.
  55
  56Note that these configuration variables should probably be set using
  57the '--global' flag, for example like this:
  58
  59------------------------------------------------
  60$ git config --global web.browser firefox
  61------------------------------------------------
  62
  63as they are probably more user specific than repository specific.
  64See linkgit:git-config[1] for more information about this.
  65
  66Author
  67------
  68Written by Christian Couder <chriscool@tuxfamily.org> and the git-list
  69<git@vger.kernel.org>, based on git-mergetool by Theodore Y. Ts'o.
  70
  71Documentation
  72-------------
  73Documentation by Christian Couder <chriscool@tuxfamily.org> and the
  74git-list <git@vger.kernel.org>.
  75
  76GIT
  77---
  78Part of the linkgit:git[7] suite