added docs for mod_dirlisting (fixes #136)

git-svn-id: svn://svn.lighttpd.net/lighttpd/branches/lighttpd-merge-1.4.x@978 152afb58-edef-0310-8abb-c4023f1b3aa9

doc/dirlisting.txt

@@ -0,0 +1,82 @@
+==================
+Directory Listings
+==================
+
+----------------------
+Module: mod_dirlisting
+----------------------
+
+:Author: Jan Kneschke
+:Date: $Date: 2004/11/03 22:26:05 $
+:Revision: $Revision: 1.2 $
+
+:abstract:
+  mod_dirlisting generates HTML based directory listings with full CSS
+  control
+  
+.. meta::
+  :keywords: lighttpd, directory listings, dirlisting
+  
+.. contents:: Table of Contents
+
+Description
+===========
+
+mod_dirlisting is one of the modules which is loaded by default and don't have to
+be specified on server.modules to work.
+
+A directory listing is generated if a directory is requested and no index-file
+was found in that directory.
+
+To enable directory listings globally: ::
+
+  dir-listing.active = "enable"
+
+If you need it only for a directory, use conditionals: ::
+
+  $HTTP["url"] =~ "^/download($|/)" {
+    dir-listing.active = "enable"
+  }
+
+You can also use a external generator for directory listings if you use
+mod_indexfile. ::
+
+  index-file.names = ( "/dir-generator.php" )
+
+If a directory is requested the dir-generator.php is called instead which can
+take the REQUEST_URI to see which directory was requested.
+
+For large folders this is highly recommend.
+
+Options
+=======
+
+dir-listing.activate
+  enables virtual directory listings if a directory is requested no
+  index-file was found 
+
+  Default: disabled
+
+dir-listing.hide-dotfiles
+  if enabled, does not list hidden files in directory listings generated
+  by the dir-listing option.
+
+  Default: enabled
+
+dir-listing.external-css
+  path to an external css stylesheet for the directory listing
+
+dir-listing.exclude
+  list of regular expressions.  Files that match any of the specified regular
+  expressions will be excluded from directory listings.
+
+dir-listing.encoding
+  set a encoding for the generated directory listing
+
+  If you file-system is not using ASCII you have to set the encoding of
+  the filenames as they are put into the HTML listing AS IS (with XML
+  encoding)
+
+  Example: ::
+   
+    dir-listing.encoding = "utf-8"