From a844768d08e0bf4220f7d60e732a4868ce8c87f5 Mon Sep 17 00:00:00 2001
From: "Fedor A. Fetisov" <faf@ossg.ru>
Date: Mon, 12 May 2014 15:31:19 +0400
Subject: [PATCH] Improve README file

---
 src/mibew/README | 82 ++++++++++++++++++++++++++++++++++--------------
 1 file changed, 58 insertions(+), 24 deletions(-)

diff --git a/src/mibew/README b/src/mibew/README
index c9ddd38f..a196b36e 100644
--- a/src/mibew/README
+++ b/src/mibew/README
@@ -9,33 +9,67 @@ REQUIREMENTS
 
 INSTALLATION
 
-1. Create folder with name 'mibew' in the root of your website.
-2. Upload all the files contained in this archive (retaining the directory structure) into created folder.
-   Be sure to chmod the mibew folder to 755 and the install folder to 644.
-3. Add a MySQL database with the name 'mibew'
-4. Edit /mibew/libs/config.php to the information needed to connect to the database
-5. Using your web browser visit http://<yourdomain>/mibew/install/ and
-   hit 'Create tables'
-6. Remove /mibew/install/ directory from your server
-7. Logon as
+ 1. Create folder with name 'mibew' in the root of your website.
+
+ 2. Upload all files contained in this archive (retaining the directory
+    structure) into the created folder.
+
+ 3. Make sure that the user, under which the web server is running (for
+    instance, www), is able to access and read all files in mibew folder
+    and all of its subfolders.
+
+    On *nix systems the simplest way is to use this pair of commands:
+
+    find -type f | xargs chmod 0644
+    find -type d | xargs chmod 0755
+
+ 4. Add a MySQL database to be used with Mibew Messenger (for instance, with
+    the name 'mibew').
+
+ 5. Edit mibew/libs/config.php to specify the information needed to connect
+    to the database.
+
+ 6. Using your web browser visit http://<yourdomain>/mibew/install/ and
+    hit 'Create tables'.
+
+ 7. Remove mibew/install/ directory from your server.
+
+ 8. On *nix platforms change the owner of mibew/images/avatar folder
+    to the user, under which the web server is running (for instance, www):
+
+    chown www mibew/images/avatar
+
+    The owner should have all rights on the folder mibew/images/avatar:
+
+    chmod u+rwx mibew/images/avatar
+
+
+ 9. Log in as
                   user: admin
                   password: <empty>
-8. Get button code and setup it on your site.
-9. Change your password and name.
-10. Wait for your visitors on 'Pending users' page.
 
-On unix/linux platforms change the owner of /mibew/images/avatar folder 
-to the user, under which the web server is running (for instance, www).
-The owner should have all rights on the folder /mibew/images/avatar 
-(chmod 700 /mibew/images/avatar).
+10. Get button code and set it up on your site.
+
+11. Change your password and name.
+
+12. Wait for your visitors on the 'Pending users' page.
 
 UPDATE
 
-1. Backup your /mibew/libs/config.php
-2. Backup your /mibew/images/avatar folder.
-3. Delete the items in the mibew folder on the server.
-4. Upload all the files contained in the downloaded archive (retaining the directory structure) into mibew folder.
-5. Re-edit the MySQL database settings you config.php
-6. Visit http://<yourdomain>/mibew/install/ and follow the instructions to update database (if needed).
-7. Remove /mibew/install/ directory from your server
-8. Restore contents of /mibew/images/avatar folder.
\ No newline at end of file
+  1. Backup your mibew/libs/config.php
+
+  2. Backup your mibew/images/avatar folder.
+
+  3. Delete all items in mibew folder on the server.
+
+  4. Upload all files contained in the downloaded archive (retaining the
+     directory structure) into mibew folder.
+
+  5. Restore the MySQL database settings in mibew/libs/config.php
+
+  6. Visit http://<yourdomain>/mibew/install/ and follow the instructions
+     to update the database tables (if needed).
+
+  7. Remove mibew/install/ directory from your server.
+
+  8. Restore contents of mibew/images/avatar folder.