diff options
Diffstat (limited to 'doc/README.html.in')
| -rw-r--r-- | doc/README.html.in | 52 |
1 files changed, 29 insertions, 23 deletions
diff --git a/doc/README.html.in b/doc/README.html.in index 575ffd9..4d69132 100644 --- a/doc/README.html.in +++ b/doc/README.html.in @@ -10,7 +10,7 @@ <body> <h1><a name="top">mod_mime_xattr @PACKAGE_VERSION@</a></h1> -<p><i>Copyright 2004 Lennart Poettering <@PACKAGE_BUGREPORT@></i></p> +<p><i>Copyright 2004-2006 Lennart Poettering <@PACKAGE_BUGREPORT@></i></p> <ul class="toc"> <li><a href="#license">License</a></li> @@ -42,6 +42,10 @@ permissions and limitations under the License.</p> <h2><a name="news">News</a></h2> +<div class="news-date">Mon Jan 23 2004: </div> <p class="news-text"><a +href="@PACKAGE_URL@mod_mime_xattr-0.3.tar.gz">Version +0.3</a> released; changes include: ported to Apache 2.0 - For Apache 1 use versions <= 0.2</p> + <div class="news-date">Sun Mar 28 2004: </div> <p class="news-text"><a href="@PACKAGE_URL@mod_mime_xattr-0.2.tar.gz">Version 0.2</a> released; changes include: look for both <tt>user.mime_type</tt> and <tt>user.mime-type</tt> for compliance with XDG</p> @@ -53,7 +57,7 @@ href="@PACKAGE_URL@mod_mime_xattr-0.1.tar.gz">Version <h2><a name="overview">Overview</a></h2> <p><tt>mod_mime_xattr</tt> is a module for the <a -href="http://httpd.apache.org/">Apache HTTPD</a> 1.3 which may be used to +href="http://httpd.apache.org/">Apache HTTPD</a> 2.0 which may be used to set a range of MIME properties of files served from a document tree with extended attributes (EAs) as supported by the underlying file system. The current version of <tt>mod_mime_xattr</tt> has support for @@ -83,38 +87,38 @@ MIME database specification</a> as published by <a href="http://www.freedesktop. <p>Enable the module by adding a new <tt>LoadModule</tt> to the Apache configuration files:</p> <pre> -LoadModule config_log_module /usr/lib/apache/1.3/mod_log_config.so -LoadModule mime_module /usr/lib/apache/1.3/mod_mime.so -<b>LoadModule mime_xattr_module /usr/lib/apache/1.3/mod_mime_xattr.so</b> -LoadModule negotiation_module /usr/lib/apache/1.3/mod_negotiation.so +... +LoadModule mime_xattr_module /usr/lib/apache2/modules/mod_mime_xattr.so +... </pre> -<p>If you add the new line before <tt>mod_mime</tt>, the latter will -overwrite the MIME type settings <tt>mod_mime_xattr</tt> -detected. Thus the extension of a file is more important than the EA <tt>user.mime_type</tt>. If specified in the opposite -order (which is recommended), the values set in the EAs take -precedence.</p> - <p>When enabled in the Apache configuration files, <tt>mod_mime_xattr</tt> introduces two new directory dependent configuration directives:</p> <ul> - <li><tt>XAttrMimeType [On/Off]</tt>; Enable or disable the use of the <tt>user.mime_type</tt>, <tt>user.charset</tt> and <tt>user.mime_encoding</tt> EAs.</li> - <li><tt>XAttrHandler [On/Off]</tt>; Enable or disable the use of the <tt>user.apache_handler</tt> EA</li> + <li><tt>XAttrMimeType [On/Off]</tt>; Enable or disable the interpretation of the <tt>user.mime_type</tt>, <tt>user.charset</tt> and <tt>user.mime_encoding</tt> EAs.</li> + <li><tt>XAttrHandler [On/Off]</tt>; Enable or disable the interpretation of the <tt>user.apache_handler</tt> EA</li> </ul> -<p>A simple usage example:</p> +<p>A simple example:</p> <pre>... <Directory /var/www> XAttrMimeType On XAttrHandler On </Directory> -... -</pre> +...</pre> -<h2>Usage</h2> +<p>In case you want to enable support for extended attributes for the entire server, use something like this:</p> + +<pre>... +<Directory /> + XAttrMimeType On +</Directory> +...</pre> + +<h3>Usage</h3> <p>You may get/set an extended attribute for a file with the Linux command line utilities <tt>getfattr</tt>/<tt>setfattr</tt>:</p> @@ -127,7 +131,7 @@ check if an EA is set for the symlink itself, and second for the file the link points to. The <tt>user.charset</tt> EA is only used when the <tt>user.mime_type</tt> EA is set as well.</p> -<h2>CGI and PHP scripts</h2> +<h3>CGI and PHP scripts</h3> <p>You may use the <tt>user.apache_handler</tt> EA to mark a file as CGI script:</p> @@ -149,7 +153,7 @@ executable CGI or PHP scripts with the technique described above.</p> <h2><a name="requirements">Requirements</a></h2> -<p>A current release of Apache 1.3 with <tt>apxs</tt>, the development +<p>A current release of Apache 2.0 (2.2 probably works, too) with <tt>apxs</tt>, the development headers and libraries installed. You need to install <tt>libattr</tt> and its development package.</p> @@ -157,7 +161,7 @@ and its development package.</p> easy to do, however. Feel free to send me patches!</p> <p><tt>mod_mime_xattr</tt> was developed and tested on Debian GNU/Linux -"testing" from March 2004, it should work on most other Linux +"testing" from January 2006, it should work on most other Linux distributions since it uses GNU autoconf source code configuration.</p> <h2><a name="installation">Installation</a></h2> @@ -178,12 +182,14 @@ compilation and <tt>make install</tt> (as root) for installation of <p>The current release is <a href="@PACKAGE_URL@mod_mime_xattr-@PACKAGE_VERSION@.tar.gz">@PACKAGE_VERSION@</a></p> -<p>Get <tt>mod_mime_xattr</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="https://seth.intheinter.net:8081/svn/mod_mime_xattr/">repository</a>.</p> +<p>Get <tt>mod_mime_xattr</tt>'s development sources from the <a href="http://subversion.tigris.org/">Subversion</a> <a href="svn://svn.0pointer.net/mod_mime_xattr">repository</a> (<a href="http://0pointer.net/cgi-bin/viewcvs.cgi/?root=mod_mime_xattr">viewcvs</a>): </p> + +<pre>svn checkout svn://svn.0pointer.net/mod_mime_xattr/trunk mod_mime_xattr</pre> <p>If you want to be notified whenever I release a new version of this software use the subscription feature of <a href="http://freshmeat.net/projects/mod_mime_xattr/">Freshmeat</a>.</p> <hr/> -<address class="grey">Lennart Poettering <@PACKAGE_BUGREPORT@>, March 2004</address> +<address class="grey">Lennart Poettering <@PACKAGE_BUGREPORT@>, January 2006</address> <div class="grey"><i>$Id$</i></div> </body> |