mod_url README document for Apache 2

# $Id: README,v 1.5 2016/02/02 17:40:41 oops Exp $

mod_url is Apache module that fix mismatched URL encoding between server and client.
This module is operated on Apache 2. For apache1 see also follow URL:
http://modurl.kldp.net/ or http://kldp.net/projects/modurl/

Current version is tested follw versions:
    2.0.64
    2.2.31
    2.4.18


1. Overview

   working follows. if your configuration as follows..

   SERVER_ENCODING EUC-KR
   CLIENT_ENCODING UTF-8

   1. Main server
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

   2. Virtual Host
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

   3. Virtual Host Alias module
      use 304 Redirection on fixups hook

   4. UserDir
      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      http://modurl.kldp.net/%ED%95%9C%EA%B8%80/info.php

      replace internal path of r->uri, r->unparsed_uri and r->parsed_uri.path
      On filename translation hook, replace %ED%95%9C%EA%B8%80 to
      %C7%D1%B1%DB.

      If apache server hasn't mod_userdir module, use 304 Redirection
      on fixups hook


2. Compile

   2.1 DSO build
       shell> apxs -i -c mod_url.c

       or do follow command on mod_url source directory

       shell> make

   2.2 static build
       shell> cp -r mod_url/ /path/apache-src/src/modules/url
       shell> rm /path/apache-src/src/modules/url/GNUmakefile
       shell> cd /path/apache-src
       shell> ./configure .... --enable-modules=all ..
              or
       shell> ./configure --enable-url=shared ...

2. Usage

   3.1 Edit your conf/httpd.conf file, and add a LoadModule line:

       LoadModule  redurl_module   modules/mod_url.so

   3.2 Activate the mod_url and set encoding variables properly:

       <IfModule mod_url.c>
           CheckURL On
           ServerEncoding EUC-KR
           ClientEncoding UTF-8
       </IfModule>

   3.3 support per directory config

       <Directory /path/some>
           <IfModule mod_url.c>
               CheckURL Off
           </IfModule>
       </Directory>

