X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README;h=33e62bde3dc975ddb65e845b248a1ef28f185298;hb=0c3a1f2ba836df0e4eedadce5c2f7f2749ca5604;hp=61bb97c241bdac8243268e610040eac6a5ac2f7a;hpb=5111a8abac4a2ebace393327e51599f4fbd213ff;p=catagits%2FGitalist.git

diff --git a/README b/README
index 61bb97c..33e62bd 100644
--- a/README
+++ b/README
@@ -23,8 +23,8 @@ INSTALL
     repositories the directory above the checkout.
 
 DESCRIPTION
-    Gitalist is a web frontend for git repositories based on <gitweb.cgi>
-    and backed by Catalyst.
+    Gitalist is a web frontend for git repositories based on gitweb.cgi
+    <https://git.wiki.kernel.org/index.php/Gitweb> and backed by Catalyst.
 
   History
     This project started off as an attempt to port *gitweb.cgi* to a
@@ -122,8 +122,8 @@ RUNNING
     than using the single threaded developement server.
 
     The recommended deployment method for Gitalist is FastCGI, although
-    Gitalist can also be run under <mod_perl> or as pure Perl with
-    Catalyst::Engine::PreFork.
+    Gitalist can also be run under mod_perl <https://perl.apache.org/> or as
+    pure Perl with Catalyst::Engine::PreFork.
 
     Assuming that you have installed Gitalist's dependencies into a
     local::lib, and you are running from a git checkout, adding a trivial
@@ -137,6 +137,12 @@ RUNNING
 
         http://example.gitalist.com
 
+  Plack
+    If you would like to run Gitalist under Plack then one need only make
+    use of plackup and the ".psgi" found under "scripts/":
+
+        plackup script/gitalist_app.psgi
+
 CONFIGURATION
     The Gitalist config is loaded with Catalyst::Plugin::ConfigLoader and
     the available config options are:
@@ -147,8 +153,8 @@ CONFIGURATION
     repo_dir
         A directory containing the directories to show.
 
-        If no repositories are found in this directory then Gitalist will
-        search recursively in that directory for repositories.
+    repos
+        A list of directories containing repositories to show.
 
     search_recursively
         A boolean indicating whether to always search recursively for
@@ -168,15 +174,18 @@ CONFIGURATION
         visible. This is similar to "gitweb"'s functionality.
 
   paging
-    log The number of commits to show in the
+    log The number of commits to show in the summary, shortlog and longlog
+        views.
 
   FASTCGI
     Running Gitalist in FastCGI mode requires a webserver with FastCGI
-    support (such as apache with <mod_fcgi> or <mod_fcgid>). Below is a
-    sample configuration using Apache2 with mod_fcgid in a dynamic
-    configuration (as opposed to static or standalone mode). More
-    information on these modes and their configuration can be found at
-    "Standalone server mode" in Catalyst::Engine::FastCGI.
+    support (such as apache with mod_fcgi
+    <http://www.fastcgi.com/drupal/node/3> or mod_fcgid
+    <https://httpd.apache.org/mod_fcgid/>). Below is a sample configuration
+    using Apache2 with mod_fcgid in a dynamic configuration (as opposed to
+    static or standalone mode). More information on these modes and their
+    configuration can be found at "Standalone server mode" in
+    Catalyst::Engine::FastCGI.
 
     In Apache's mime.conf, add "AddHandler fcgid-script .fcgi" (or
     "AddHandler fastcgi-script .fcgi" for mod_fcgi).
@@ -203,7 +212,8 @@ CONFIGURATION
     Now to access your Gitalist instance, you'll go to
     "gitalist.yourdomain.com/gitalist.fcgi/" (do not forget that trailing
     "/"). If you'd like a different URL, of course, you'll likely want to
-    use <mod_rewrite> or equivalent.
+    use mod_rewrite <https://httpd.apache.org/docs/mod/mod_rewrite.html> or
+    equivalent.
 
     If you find the need to do some troubleshooting, you can call
     "http://url_to_gitalist.fcgi?dump_info=1" and/or add export