summaryrefslogtreecommitdiffstats
path: root/git-instaweb.txt
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2006-07-07 02:03:59 +0000
committerJunio C Hamano <junio@hera.kernel.org>2006-07-07 02:03:59 +0000
commit7ec15728dd6c76d7065c3b3b7614f0a799a38916 (patch)
treec9ee51e8bb3574d14542a2e17247ae3e398f3905 /git-instaweb.txt
parenta126a3b08ee48828cacfacaca460373c2f785167 (diff)
downloadgit-htmldocs-7ec15728dd6c76d7065c3b3b7614f0a799a38916.tar.gz
Autogenerated HTML docs for v1.4.1-gc31c
Diffstat (limited to 'git-instaweb.txt')
-rw-r--r--git-instaweb.txt84
1 files changed, 84 insertions, 0 deletions
diff --git a/git-instaweb.txt b/git-instaweb.txt
new file mode 100644
index 000000000..7dd393b97
--- /dev/null
+++ b/git-instaweb.txt
@@ -0,0 +1,84 @@
+git-instaweb(1)
+===============
+
+NAME
+----
+git-instaweb - instantly browse your working repository in gitweb
+
+SYNOPSIS
+--------
+'git-instaweb' [--local] [--httpd=<httpd>] [--port=<port>] [--browser=<browser>]
+
+'git-instaweb' [--start] [--stop] [--restart]
+
+DESCRIPTION
+-----------
+A simple script to setup gitweb and a web server for browsing the local
+repository.
+
+OPTIONS
+-------
+
+-l|--local::
+ Only bind the web server to the local IP (127.0.0.1).
+
+-d|--httpd::
+ The HTTP daemon command-line that will be executed.
+ Command-line options may be specified here, and the
+ configuration file will be added at the end of the command-line.
+ Currently, lighttpd and apache2 are the only supported servers.
+ (Default: lighttpd)
+
+-m|--module-path::
+ The module path (only needed if httpd is Apache).
+ (Default: /usr/lib/apache2/modules)
+
+-p|--port::
+ The port number to bind the httpd to. (Default: 1234)
+
+-b|--browser::
+
+ The web browser command-line to execute to view the gitweb page.
+ If blank, the URL of the gitweb instance will be printed to
+ stdout. (Default: 'firefox')
+
+--start::
+ Start the httpd instance and exit. This does not generate
+ any of the configuration files for spawning a new instance.
+
+--stop::
+ Stop the httpd instance and exit. This does not generate
+ any of the configuration files for spawning a new instance,
+ nor does it close the browser.
+
+--restart::
+ Restart the httpd instance and exit. This does not generate
+ any of the configuration files for spawning a new instance.
+
+CONFIGURATION
+-------------
+
+You may specify configuration in your .git/config
+
+-----------------------------------------------------------------------
+[instaweb]
+ local = true
+ httpd = apache2 -f
+ port = 4321
+ browser = konqueror
+ modulepath = /usr/lib/apache2/modules
+
+-----------------------------------------------------------------------
+
+Author
+------
+Written by Eric Wong <normalperson@yhbt.net>
+
+Documentation
+--------------
+Documentation by Eric Wong <normalperson@yhbt.net>.
+
+GIT
+---
+Part of the gitlink:git[7] suite
+