1GIT-WEB--BROWSE(1)                Git Manual                GIT-WEB--BROWSE(1)
2
3
4

NAME

6       git-web--browse - Git helper script to launch a web browser
7

SYNOPSIS

9       git web--browse [<options>] <url|file>...
10
11

DESCRIPTION

13       This script tries, as much as possible, to display the URLs and FILEs
14       that are passed as arguments, as HTML pages in new tabs on an already
15       opened web browser.
16
17       The following browsers (or commands) are currently supported:
18
19       ·   firefox (this is the default under X Window when not using KDE)
20
21       ·   iceweasel
22
23       ·   seamonkey
24
25       ·   iceape
26
27       ·   chromium (also supported as chromium-browser)
28
29       ·   google-chrome (also supported as chrome)
30
31       ·   konqueror (this is the default under KDE, see Note about konqueror
32           below)
33
34       ·   opera
35
36       ·   w3m (this is the default outside graphical environments)
37
38       ·   elinks
39
40       ·   links
41
42       ·   lynx
43
44       ·   dillo
45
46       ·   open (this is the default under Mac OS X GUI)
47
48       ·   start (this is the default under MinGW)
49
50       ·   cygstart (this is the default under Cygwin)
51
52       ·   xdg-open
53
54       Custom commands may also be specified.
55

OPTIONS

57       -b <browser>, --browser=<browser>
58           Use the specified browser. It must be in the list of supported
59           browsers.
60
61       -t <browser>, --tool=<browser>
62           Same as above.
63
64       -c <conf.var>, --config=<conf.var>
65           CONF.VAR is looked up in the Git config files. If it’s set, then
66           its value specifies the browser that should be used.
67

CONFIGURATION VARIABLES

69   CONF.VAR (from -c option) and web.browser
70       The web browser can be specified using a configuration variable passed
71       with the -c (or --config) command-line option, or the web.browser
72       configuration variable if the former is not used.
73
74   browser.<tool>.path
75       You can explicitly provide a full path to your preferred browser by
76       setting the configuration variable browser.<tool>.path. For example,
77       you can configure the absolute path to firefox by setting
78       browser.firefox.path. Otherwise, git web--browse assumes the tool is
79       available in PATH.
80
81   browser.<tool>.cmd
82       When the browser, specified by options or configuration variables, is
83       not among the supported ones, then the corresponding browser.<tool>.cmd
84       configuration variable will be looked up. If this variable exists then
85       git web--browse will treat the specified tool as a custom command and
86       will use a shell eval to run the command with the URLs passed as
87       arguments.
88

NOTE ABOUT KONQUEROR

90       When konqueror is specified by a command-line option or a configuration
91       variable, we launch kfmclient to try to open the HTML man page on an
92       already opened konqueror in a new tab if possible.
93
94       For consistency, we also try such a trick if browser.konqueror.path is
95       set to something like A_PATH_TO/konqueror. That means we will try to
96       launch A_PATH_TO/kfmclient instead.
97
98       If you really want to use konqueror, then you can use something like
99       the following:
100
101                   [web]
102                           browser = konq
103
104                   [browser "konq"]
105                           cmd = A_PATH_TO/konqueror
106
107
108   Note about git-config --global
109       Note that these configuration variables should probably be set using
110       the --global flag, for example like this:
111
112           $ git config --global web.browser firefox
113
114
115       as they are probably more user specific than repository specific. See
116       git-config(1) for more information about this.
117

GIT

119       Part of the git(1) suite
120
121
122
123Git 2.21.0                        02/24/2019                GIT-WEB--BROWSE(1)