attempt at documentation polishes.
paul


git-svn-id: https://svn.apache.org/repos/asf/commons/proper/jelly/trunk@895826 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/xdocs/faq.xml b/xdocs/faq.xml
index eb30026..9a706f9 100644
--- a/xdocs/faq.xml
+++ b/xdocs/faq.xml
@@ -87,6 +87,11 @@
           How do Jelly scripts handle CDATA sections?
         </a>
       </li>
+      <li>
+        <a href="#escapingJexl">
+          How does one write ${a.variable} to the output?
+        </a>
+      </li>
     </ol>
     <p><strong>Building Jelly</strong></p>
     <ol>
@@ -359,18 +364,21 @@
 &lt;/j:file>
 </source>
 </dd>
-<dd>
-   will produce this output:
+        <dt>
+          <a name="escapingJexl">
+          How does one write ${a.variable} to the output?
+          </a>
+        </dt>
+        <dd>
+          Use the double-dollar as in
         </dd>
-<dd>
-<source>
-&lt;?xml version="1.0" encoding="UTF-8"?>
-&lt;!DOCTYPE foo [
-    &lt;!ELEMENT foo (#PCDATA)>
-]>
+                <dd>
 
-&lt;foo/>
-</source>
+<source>
+<![CDATA[<?xml version="1.0"?>
+<j:jelly xmlns:j="jelly:core">
+  This is $${escaped}
+</j:jelly>]]></source>
 </dd>
       </dl>
     </section>
diff --git a/xdocs/gettingstarted.xml b/xdocs/gettingstarted.xml
index 850b8c2..de80b81 100644
--- a/xdocs/gettingstarted.xml
+++ b/xdocs/gettingstarted.xml
@@ -30,9 +30,9 @@
 
 <p>
 The easiest way to get started with Jelly is to try out the <a href="tutorial.html">tutorials</a>.    
-Before you try out any of the tutorials, you'll need to install Maven first.
+Before you try out any of the tutorials, you may need to install Maven-1.1 first.
 For more details on how to install Maven please refer to the 
-<a href="http://maven.apache.org/">Maven documentation</a>
+<a href="http://maven.apache.org/maven-1.x/">Maven documentation</a>
 </p>
 
 <p>
diff --git a/xdocs/index.xml b/xdocs/index.xml
index 4501ffd..b63b0de 100644
--- a/xdocs/index.xml
+++ b/xdocs/index.xml
@@ -25,6 +25,12 @@
 
 <body>
 
+<section name="Warning: low development activity">
+<p>Please note that Commons Jelly is enduring a phase 
+ with low activity of its developers.
+  </p>
+</section>
+
 <section name="Jelly : Executable XML">
 
 <p><em>Jelly</em> is a tool for turning XML into executable code.