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       Custom commands may also be specified.
51

OPTIONS

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

CONFIGURATION VARIABLES

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

NOTE ABOUT KONQUEROR

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

GIT

115       Part of the git(1) suite
116
117
118
119Git 1.8.3.1                       11/19/2018                GIT-WEB--BROWSE(1)
Impressum