Documentation/git-instaweb.txt

   1 git-instaweb(1)
   2 ===============
   3
   4 NAME
   5 ----
   6 git-instaweb - Instantly browse your working repository in gitweb
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 'git instaweb' [--local] [--httpd=<httpd>] [--port=<port>]
  12                [--browser=<browser>] [--reuse-config]
  13 'git instaweb' [--start] [--stop] [--restart]
  14
  15 DESCRIPTION
  16 -----------
  17 A simple script to set up `gitweb` and a web server for browsing the local
  18 repository.
  19
  20 OPTIONS
  21 -------
  22
  23 -l::
  24 --local::
  25         Only bind the web server to the local IP (127.0.0.1).
  26
  27 -d::
  28 --httpd::
  29         The HTTP daemon command-line that will be executed.
  30         Command-line options may be specified here, and the
  31         configuration file will be added at the end of the command-line.
  32         Currently apache2, lighttpd, mongoose, plackup and webrick are supported.
  33         (Default: lighttpd)
  34
  35 -m::
  36 --module-path::
  37         The module path (only needed if httpd is Apache).
  38         (Default: /usr/lib/apache2/modules)
  39
  40 -p::
  41 --port::
  42         The port number to bind the httpd to.  (Default: 1234)
  43
  44 -b::
  45 --browser::
  46         The web browser that should be used to view the gitweb
  47         page. This will be passed to the 'git web--browse' helper
  48         script along with the URL of the gitweb instance. See
  49         linkgit:git-web--browse[1] for more information about this. If
  50         the script fails, the URL will be printed to stdout.
  51
  52 --reuse-config::
  53         The previous gitweb_config.perl will not be overwritten.
  54
  55 --start::
  56         Start the httpd instance and exit.  This does not generate
  57         any of the configuration files for spawning a new instance.
  58
  59 --stop::
  60         Stop the httpd instance and exit.  This does not generate
  61         any of the configuration files for spawning a new instance,
  62         nor does it close the browser.
  63
  64 --restart::
  65         Restart the httpd instance and exit.  This does not generate
  66         any of the configuration files for spawning a new instance.
  67
  68 CONFIGURATION
  69 -------------
  70
  71 You may specify configuration in your .git/config
  72
  73 -----------------------------------------------------------------------
  74 [instaweb]
  75         local = true
  76         httpd = apache2 -f
  77         port = 4321
  78         browser = konqueror
  79         modulepath = /usr/lib/apache2/modules
  80         gitwebdir = /usr/share/gitweb
  81         overwrite = false
  82
  83 -----------------------------------------------------------------------
  84
  85 If the configuration variable 'instaweb.browser' is not set,
  86 'web.browser' will be used instead if it is defined. See
  87 linkgit:git-web--browse[1] for more information about this.
  88
  89 Author
  90 ------
  91 Written by Eric Wong <normalperson@yhbt.net>
  92
  93 Documentation
  94 --------------
  95 Documentation by Eric Wong <normalperson@yhbt.net>.
  96
  97 GIT
  98 ---
  99 Part of the linkgit:git[1] suite