{"thread":{"id":"11983","subject":"[PATCH 1/2] Documentation: instaweb: add 'git-web--browse' information.","startedAt":"2008-02-09T06:10:57Z","lastAt":"2008-02-09T06:10:57Z","messageCount":1,"participants":["Christian Couder"],"isPatch":true,"patchVersion":1,"patchTotal":2},"messages":[{"id":"68056","messageId":"20080209071058.6b64fb32.chriscool@tuxfamily.org","threadId":"11983","inReplyTo":null,"subject":"[PATCH 1/2] Documentation: instaweb: add 'git-web--browse' information.","fromName":"Christian Couder","fromEmail":"chriscool@tuxfamily.org","sentAt":"2008-02-09T06:10:57Z","receivedAt":"2008-02-09T06:10:57Z","isPatch":true,"sender":{"key":"christian.couder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/208954?v=4"},"body":"Now that 'git-instaweb' uses 'git-web--browse', update the\ndocumentation accordingly.\n\nSigned-off-by: Christian Couder <chriscool@tuxfamily.org>\n---\n Documentation/git-instaweb.txt |   27 +++++++++++++++++++++++----\n 1 files changed, 23 insertions(+), 4 deletions(-)\n\n\tThe added documentation is copied from 'Documentation/git-help.txt',\n\tso maybe it would be better for 'git-web--browse' to have its own\n\tdocumentation and to refer to it in both 'git-help.txt' and\n\t'git-instaweb.txt'.\n\ndiff --git a/Documentation/git-instaweb.txt b/Documentation/git-instaweb.txt\nindex 841e8fa..a1456ab 100644\n--- a/Documentation/git-instaweb.txt\n+++ b/Documentation/git-instaweb.txt\n@@ -38,10 +38,23 @@ OPTIONS\n \tThe port number to bind the httpd to.  (Default: 1234)\n \n -b|--browser::\n-\n-\tThe web browser command-line to execute to view the gitweb page.\n-\tIf blank, the URL of the gitweb instance will be printed to\n-\tstdout.  (Default: 'firefox')\n+\tThe web browser that should be used to view the gitweb\n+\tpage. This will be passed to the 'git-web--browse' helper\n+\tscript along with the URL of the gitweb instance. If the\n+\tscript fails, the URL will be printed to stdout.\n++\n+Note that the 'git-web--browse' script tries, as much as possible, to\n+display the HTML page in a new tab on an already opened browser.\n++\n+The following browsers are currently supported by 'git-web--browse':\n++\n+* firefox (this is the default under X Window when not using KDE)\n+* iceweasel\n+* konqueror (this is the default under KDE)\n+* w3m (this is the default outside X Window)\n+* links\n+* lynx\n+* dillo\n \n --start::\n \tStart the httpd instance and exit.  This does not generate\n@@ -74,6 +87,12 @@ You may specify configuration in your .git/config\n If the configuration variable 'instaweb.browser' is not set,\n 'web.browser' will be used instead if it is defined.\n \n+You can explicitly provide a full path to your preferred browser by\n+setting the configuration variable 'browser.<tool>.path'. For example,\n+you can configure the absolute path to firefox by setting\n+'browser.firefox.path'. Otherwise, 'git-web--browse' assumes the tool\n+is available in PATH.\n+\n Author\n ------\n Written by Eric Wong <normalperson@yhbt.net>\n-- \n1.5.4.16.g9f0c3\n"}]}