From 96fe64e393e0956d3f0b9de4afa3971cb1169b26 Mon Sep 17 00:00:00 2001
From: cweiske <cweiske@b3834d28-1941-0410-a4f8-b48e95affb8f>
Date: Mon, 8 Feb 2010 07:32:53 +0000
Subject: [PATCH] explain people how to setup their installation to get rid of
 www/ in URLs.

git-svn-id: https://semanticscuttle.svn.sourceforge.net/svnroot/semanticscuttle/trunk@644 b3834d28-1941-0410-a4f8-b48e95affb8f
---
 doc/INSTALL.txt | 44 +++++++++++++++++++++++++++++++++++++++++++-
 doc/UPGRADE.txt |  6 ++++++
 2 files changed, 49 insertions(+), 1 deletion(-)

diff --git a/doc/INSTALL.txt b/doc/INSTALL.txt
index 1c25b2d..b2dd3b2 100644
--- a/doc/INSTALL.txt
+++ b/doc/INSTALL.txt
@@ -22,4 +22,46 @@ Installation instructions
    For example, run
    > chmod 0777 cache
    on the shell.
-5. Set the www/ directory as document root in your web server.
+5. Set the www/ directory as document root in your web server,
+   restart the web server.
+
+
+Ugly www directory in URLs
+--------------------------
+In case point 5 of the installation instructions cannot be put into
+practice by you because you are not able to change the web server
+configuration, you are not lost! There is a way to get rid of
+www/ in your URL!
+
+Imagine following directory layout:
+ /home/customer123/
+   www/
+     subdomain1/
+     subdomain2/
+     subdomain3/
+
+Create a SemanticScuttle directory somewhere outside www if possible
+and put all directories except www/ in there. Move all files and
+directories from www/ into your subdomain directory. Then modify
+subdomain/www-header.php to include the correct file path.
+
+The new directory layout should look that way:
+ /home/customer123/
+   semanticscuttle/
+     doc/
+     data/
+     src/
+   www/
+     subdomain1/
+     subdomain2/ (this is the semanticscuttle subdomain)
+       about.php
+       admin.php
+       ..
+       www-header.php
+     subdomain3/
+
+Now open www-header.php and replace
+  require_once '../src/SemanticScuttle/header.php';
+with
+  require_once '../../semanticscuttle/src/SemanticScuttle/header.php';
+
diff --git a/doc/UPGRADE.txt b/doc/UPGRADE.txt
index 3e23640..371c302 100644
--- a/doc/UPGRADE.txt
+++ b/doc/UPGRADE.txt
@@ -10,6 +10,12 @@ API:
 The method signatures of addBookmark() and updateBookmark()
 changed due to the addition of the $short parameter.
 
+We got complaints about the changed file structure, and people told
+us that they just cannot set the document root to www/, because they
+are not admins on their http server. This is a valid point, and
+with 0.96.0 you can easily change it. See INSTALL.txt for more information
+about moving www/.
+
 
 From version 0.94 to 0.95
 --------------------------