documentation: web--browse: add a note about konqueror
This note explains how to work around the fact that we try to use kfmclient to launch konqueror. Signed-off-by: Christian Couder <chriscool@tuxfamily.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Christian Couder committed
Apr 25, 2008 at 08:25 UTC
ac3a4a2694fa8bea477b1a265efd6829de686e5c
1 file changed
+23
-1
Documentation/git-web--browse.txt
+23
-1
@@ -20,7 +20,7 @@ The 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)
23
+* konqueror (this is the default under KDE, see 'Note about konqueror' below)
24
* w3m (this is the default outside graphical environments)
25
* links
26
* lynx
@@ -71,6 +71,28 @@ variable exists then "git web--browse" will treat the specified tool
71
as a custom command and will use a shell eval to run the command with
72
the URLs passed as arguments.
73
74
+Note about konqueror
75
+--------------------
76
+
77
+When 'konqueror' is specified by the a command line option or a
78
+configuration variable, we launch 'kfmclient' to try to open the HTML
79
+man page on an already opened konqueror in a new tab if possible.
80
+
81
+For consistency, we also try such a trick if 'brower.konqueror.path' is
82
+set to something like 'A_PATH_TO/konqueror'. That means we will try to
83
+launch 'A_PATH_TO/kfmclient' instead.
84
+
85
+If you really want to use 'konqueror', then you can use something like
86
+the following:
87
+
88
+------------------------------------------------
89
+ [web]
90
+ browser = konq
91
+
92
+ [browser "konq"]
93
+ cmd = A_PATH_TO/konqueror
94
+------------------------------------------------
95
+
96
Note about git config --global
97
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
98