From fc0e4996faaf1c042524f64aca7f616401115eb8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20Mas=C3=A1r?= <helix84@centrum.sk>
Date: Thu, 22 Nov 2012 15:53:07 +0100
Subject: [PATCH] update comments in xmlui.xconf

---
 dspace/config/xmlui.xconf | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/dspace/config/xmlui.xconf b/dspace/config/xmlui.xconf
index fc106938a5..5c6f83aadd 100644
--- a/dspace/config/xmlui.xconf
+++ b/dspace/config/xmlui.xconf
@@ -68,7 +68,12 @@
         <!-- =====================
              Item Level Versioning
              ===================== -->
-        <!-- To enable Item Level Versioning features, uncomment this aspect. -->
+        <!--
+             To enable Item Level Versioning features, uncomment this aspect.
+             This is currently disabled by default because of two known issues:
+             DS-1382 and DS-1349. Please, review them to see whether they apply
+             to you before enabling versioning.
+        -->
         <!--<aspect name="Versioning Aspect" path="resource://aspects/Versioning/" />-->
         
         <!-- =====================
@@ -88,8 +93,11 @@
         <!-- By default, DSpace uses a Statistics engine based on SOLR -->
         <aspect name="Statistics" path="resource://aspects/Statistics/" />
 
-        <!-- If you prefer to use "Elastic Search" Statistics, you can uncomment the below
-             aspect and COMMENT OUT the default "Statistics" aspect above -->
+        <!--
+             If you prefer to use "Elastic Search" Statistics, you can uncomment the below
+             aspect and COMMENT OUT the default "Statistics" aspect above.
+             You must also enable the ElasticSearchLoggerEventListener.
+        -->
         <!-- <aspect name="Statistics - Elastic Search" path="resource://aspects/StatisticsElasticSearch/" /> -->
 
         <!-- =========================
@@ -99,7 +107,7 @@
         <aspect name="Original Workflow" path="resource://aspects/Workflow/" />
 
         <!-- If you prefer, a Configurable XML-based Workflow is available. To enable it, you can
-             uncomment the below aspect an comment out the "Original Workflow" aspect above.
+             uncomment the below aspect and comment out the "Original Workflow" aspect above.
              PLEASE NOTE: in order to use the configurable workflow you must also run the
              database migration scripts as detailed in the DSpace Documentation -->
         <!-- <aspect name="XMLWorkflow" path="resource://aspects/XMLWorkflow/" /> -->
@@ -127,6 +135,7 @@
         <!--
             This demo aspect tests the various possible DRI features.
             It may be useful to developers in developing new aspects or themes.
+            It's accessible for admins in the XMLTest menu or via the /XMLTest/ URL.
         -->
         <!-- <aspect name="XML Tests" path="resource://aspects/XMLTest/"/> -->
     </aspects>
@@ -174,5 +183,9 @@
         <!-- The Kubrick theme -->
         <!-- <theme name="Kubrick" regex=".*" path="Kubrick/" /> -->
 
+        <!--
+             For information on configuring the mobile theme, see:
+             dspace-xmlui/src/main/webapp/themes/mobile/readme.txt
+        -->
     </themes>
 </xmlui>