From 2807d040834ea9fcd825d5b1c9b3e1e005d81664 Mon Sep 17 00:00:00 2001
From: Christian Weiske
Date: Sat, 6 Aug 2011 10:34:13 +0200
Subject: Fix bug #3384416: Update documentation to explain HTTP/HTTPS root
 problem

---
 doc/ChangeLog         |  1 +
 doc/configuration.rst | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)

(limited to 'doc')

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 860a213..b7bf843 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -7,6 +7,7 @@ ChangeLog for SemantiScuttle
 -------------------
 - Fix bug #3385724: Rename tag ends with XML Parsing Error
 - Fix bug #3386178: "system:unfiled" secret tag does not work
+- Fix bug #3384416: Update documentation to explain HTTP/HTTPS root problem
 
 Run ``scripts/fix-unfiled-tags.php`` to fix old bookmarks that miss the
 ``system:unfiled`` tags.
diff --git a/doc/configuration.rst b/doc/configuration.rst
index f457ebb..c34318a 100644
--- a/doc/configuration.rst
+++ b/doc/configuration.rst
@@ -56,3 +56,24 @@ per-host configuration files:
 - ``data/config.$hostname.php``
 - ``/etc/semanticscuttle/config.$hostname.php``
 
+
+
+Configuration options
+=====================
+``$root`` URL
+-------------
+Normally, this configuration setting is detected automatically and will
+work for both HTTP and HTTPS installations.
+
+If your installation is available on **HTTP only**, then you need to configure
+it.
+
+The value is the full URL to your installation, including a trailing
+slash::
+
+    $root = "http://homepage.example.org/semanticscuttle/";
+
+or::
+
+    $root = "http://bookmarks.example.org/";
+
-- 
cgit v1.2.3-54-g00ecf