Added README.russian_apache from Konstantin Riabitsev.

git-svn-id: https://svn.code.sf.net/p/squirrelmail/code/trunk/squirrelmail@413 7612ce4b-ef26-0410-bec9-ea0150e637f0

diff --git a/ChangeLog b/ChangeLog
index e5a3efd0755eaefed080519fbc418928660e688d..4791566662b34342328924eb8cc6d67e060ad16c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -13,6 +13,7 @@ Version 0.4pre1 -- Development
 - It doesn't bail out if PHP wasn't compiled with --with-gettext.  
     It only uses english in this case.
 - Added support for Cyrillic (thanks to Artem Botchkov for help)
 - It doesn't bail out if PHP wasn't compiled with --with-gettext.  
     It only uses english in this case.
 - Added support for Cyrillic (thanks to Artem Botchkov for help)

+- Included information on Russian Apache from Konstantin Riabitsev

 - Honoring charset parameter for the body.
 - Changed the way emptying of trash was done to work better
     across different IMAP servers
 - Honoring charset parameter for the body.
 - Changed the way emptying of trash was done to work better
     across different IMAP servers

diff --git a/INSTALL b/INSTALL
index 33c223a0e67c58e5e06f693673180ed62ec87836..38605af84de6d5b8fda7577018ab3a09fbb8b5f5 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -137,3 +137,10 @@ c. Setting up SquirrelMail
   Point your browser at the URL at which SquirrelMail is installed. It
   should be pretty stright forward to use. Some more documentation
   might show up onbe day or another.
   Point your browser at the URL at which SquirrelMail is installed. It
   should be pretty stright forward to use. Some more documentation
   might show up onbe day or another.

+
+
+5. RUSSIAN CHARSETS
+-------------------
+
+  For information on how to make SquirrelMail work with Russian
+  Apache, see the README.russian_apache in the doc/ subdirectory.

diff --git a/doc/README.russian_apache b/doc/README.russian_apache
new file mode 100644 (file)
index 0000000..d9f280f
--- /dev/null
+++ b/doc/README.russian_apache
@@ -0,0 +1,72 @@
+HOW TO CONFIGURE SQUIRREL-MAIL WITH RUSSIAN APACHE
+--------------------------------------------------
+
+This howto is for people who are using Russian Apache and
+who use charsets other than koi8-r for their source documents.
+If you _do_ use KOI8-R as default encoding for all your source
+documents, you don't need to do anything. Otherwise, here's
+a very simple way to make this work.
+
+The general idea is to tell Russian Apache that everything 
+residing in the squirrel-mail directory is in koi8-r. This
+way all input submitted by users will be automagically 
+converted by mod_charset from anything into koi8-r.
+Squirrel-Mail will then correctly stamp it with
+"Charset=koi8-r" and send off without any additional
+conversion.
+
+There are two equally efficient ways to do it:
+
+
+1. THE HTTPD.CONF WAY.
+-----------------------
+
+In your httpd.conf, add the following declaration for the
+server that handles the squirrel-mail:
+
+<Directory /path/to/your/squirrel-mail>
+CharsetSourceEnc koi8-r
+</Directory>
+
+Warning: If you use CharsetByExtension elsewhere, it will 
+override the CharsetSourceEnc directive. In that case you will 
+have to put this directive instead of the above:
+
+<Directory /path/to/your/squirrel-mail>
+CharsetByExtension koi8-r .php
+</Directory>
+
+It is advised to use the CharsetSourceEnc declaration instead
+of the other one. Use the CharsetByExtension only if the
+other fails.
+
+2. THE .HTACCESS WAY (PREFERRED).
+----------------------------------
+
+Create a .htaccess file in your squirrel-mail directory. In it,
+simply put this line:
+
+CharsetSourceEnc koi8-r
+
+That's it. Note the warning about the ChatsetByExtension directive
+in the previous section. If you used CharsetByExtension declaration
+elsewhere and it's active for this server, then you will have to
+put this line in your .htaccess instead:
+
+CharsetByExtension koi8-r .php
+
+But again, this is only if the CharsetSourceEnc fails.
+
+I mark this method "Preferred" simply because you don't have to 
+restart your server if you use .htaccess. However, if you've
+specified "AllowOverride None" in your Server config, then you
+will have to go with "the httpd.conf way".
+
+
+If you have any questions or problems, please address them to
+the squirrelmail-list@lists.sourceforge.net to have them 
+promptly answered. ;)
+
+--
+Konstantin Riabitsev (a.k.a. Graf)
+graf@relhum.org