Git helper script to launch a web browser


gitweb --browse [<options>] <url|file> ...


This script tries, as much as possible, to display the URLs and FILEs that are passed as arguments, as HTML pages in new tabs on an already opened web browser .
The following browsers (or commands) are currently supported:
'-04' '+03' .sp -1

2.3 firefox (this is the default under X Window when not using KDE)
'-04' '+03' .sp -1

2.3 iceweasel
'-04' '+03' .sp -1

2.3 seamonkey
'-04' '+03' .sp -1

2.3 iceape
'-04' '+03' .sp -1

2.3 chromium (also supported as chromium -browser)
'-04' '+03' .sp -1

2.3 google -chrome (also supported as chrome)
'-04' '+03' .sp -1

2.3 konqueror (this is the default under KDE, see Noteabout konqueror below)
'-04' '+03' .sp -1

2.3 opera
'-04' '+03' .sp -1

2.3 w3m (this is the default outside graphical environments)
'-04' '+03' .sp -1

2.3 elinks
'-04' '+03' .sp -1

2.3 links
'-04' '+03' .sp -1

2.3 lynx
'-04' '+03' .sp -1

2.3 dillo
'-04' '+03' .sp -1

2.3 open (this is the default under Mac OS X GUI)
'-04' '+03' .sp -1

2.3 start (this is the default under MinGW)
'-04' '+03' .sp -1

2.3 cygstart (this is the default under Cygwin)
'-04' '+03' .sp -1

2.3 xdg -open
Custom commands may also be specified .


-b <browser>, --browser=<browser> Use the specified browser . It must be in the list of supported browsers .

-t <browser>, --tool=<browser> Same as above .

-c <conf .var>, --config=<conf .var> CONF .VAR is looked up in the Git config files . If it set, then its value specifies the browser that should be used .


"CONF .VAR (from -c option) and web .browser"

The web browser can be specified using a configuration variable passed with the -c (or --config) command -line option, or the web.browser configuration variable if the former is not used .

"browser .<tool> .path"

You can explicitly provide a full path to your preferred browser by setting the configuration variable browser.<tool> .path . For example, you can configure the absolute path to firefox by setting browser.firefox .path . Otherwise, gitweb --browse assumes the tool is available in PATH .

"browser .<tool> .cmd"

When the browser, specified by options or configuration variables, is not among the supported ones, then the corresponding browser.<tool> .cmd configuration variable will be looked up . If this variable exists then gitweb --browse will treat the specified tool as a custom command and will use a shell eval to run the command with the URLs passed as arguments .


When konqueror is specified by a command -line option or a configuration variable, we launch kfmclient to try to open the HTML man page on an already opened konqueror in a new tab if possible .
For consistency, we also try such a trick if browser.konqueror .path is set to something like A_PATH_TO/konqueror . That means we will try to launch A_PATH_TO/kfmclient instead .
If you really want to use konqueror ,then you can use something like the following:
.RS 4
[web] browser = konq
[browser "konq"] cmd = A_PATH_TO/konqueror .RE

"Note about git -config --global"

Note that these configuration variables should probably be set using the --global flag, for example like this:
.RS 4
$ git config --global web .browser firefox .RE

as they are probably more user specific than repository specific . See git-config (1)for more information about this .


Part of the git (1)suite

Copied to clipboard
free 100$ digital ocean credit