1f010d6bdf
We presently use the ".txt" extension for our AsciiDoc files. While not wrong, most editors do not associate this extension with AsciiDoc, meaning that contributors don't get automatic editor functionality that could be useful, such as syntax highlighting and prose linting. It is much more common to use the ".adoc" extension for AsciiDoc files, since this helps editors automatically detect files and also allows various forges to provide rich (HTML-like) rendering. Let's do that here, renaming all of the files and updating the includes where relevant. Adjust the various build scripts and makefiles to use the new extension as well. Note that this should not result in any user-visible changes to the documentation. Signed-off-by: brian m. carlson <sandals@crustytoothpaste.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
95 lines
2.3 KiB
Plaintext
95 lines
2.3 KiB
Plaintext
git-instaweb(1)
|
|
===============
|
|
|
|
NAME
|
|
----
|
|
git-instaweb - Instantly browse your working repository in gitweb
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git instaweb' [--local] [--httpd=<httpd>] [--port=<port>]
|
|
[--browser=<browser>]
|
|
'git instaweb' [--start] [--stop] [--restart]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
A simple script to set up `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 apache2, lighttpd, mongoose, plackup, python and
|
|
webrick are supported.
|
|
(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 that should be used to view the gitweb
|
|
page. This will be passed to the 'git web{litdd}browse' helper
|
|
script along with the URL of the gitweb instance. See
|
|
linkgit:git-web{litdd}browse[1] for more information about this. If
|
|
the script fails, the URL will be printed to stdout.
|
|
|
|
start::
|
|
--start::
|
|
Start the httpd instance and exit. Regenerate configuration files
|
|
as necessary for spawning a new instance.
|
|
|
|
stop::
|
|
--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::
|
|
Restart the httpd instance and exit. Regenerate configuration files
|
|
as necessary 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
|
|
|
|
-----------------------------------------------------------------------
|
|
|
|
If the configuration variable `instaweb.browser` is not set,
|
|
`web.browser` will be used instead if it is defined. See
|
|
linkgit:git-web{litdd}browse[1] for more information about this.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkgit:gitweb[1]
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|