greenrd 01/01/11 11:04:34
Modified: xdocs installing.xml faq.xml
Log:
more hints for newbies
Revision Changes Path
1.43 +19 -0 xml-cocoon/xdocs/installing.xml
Index: installing.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/installing.xml,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -r1.42 -r1.43
--- installing.xml 2001/01/11 14:04:19 1.42
+++ installing.xml 2001/01/11 19:04:30 1.43
@@ -15,6 +15,25 @@
<body>
+ <s1 title="Notes for Upgraders">
+
+ <p>If you are upgrading Cocoon from a previous version, please note three
+ important points:</p>
+
+ <ul>
+ <li>It is likely to cause errors if you use your old cocoon.properties
file.
+ Instead, copy the new one from the Cocoon distribution and make changes
to it
+ if necessary.
+ </li>
+ <li>If you use the ESQL taglib, the
+ <connect href="esql.xml">syntax has changed</connect> between Cocoon
1.8 and
+ Cocoon 1.8.1</li>
+ <li>The most common upgrading and installation mistakes can be rectified
by carefully
+ reading the instructions below.</li>
+ </ul>
+
+ </s1>
+
<s1 title="System Requirements">
<p>
Cocoon requires the following systems to be already installed in your
1.40 +27 -8 xml-cocoon/xdocs/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-cocoon/xdocs/faq.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -r1.39 -r1.40
--- faq.xml 2001/01/11 01:14:33 1.39
+++ faq.xml 2001/01/11 19:04:31 1.40
@@ -395,6 +395,20 @@
</faqsection>
<faqsection title="Database Access">
+ <faq id="dbdoesnothing">
+ <question>My database page throws a NullPointerException,
+ or just outputs the driver, username, etc. as if
+ Cocoon hadn't processed it at all</question>
+ <answer>
+ <p>Firstly, have you checked that cocoon is working by going to
Cocoon.xml ?</p>
+ <p>Secondly, if you have upgraded to Cocoon 1.8.1 and are using esql,
+ <connect href="esql.xml">esql has changed</connect>
+ since the previous release, so you need to rewrite your esql pages.</p>
+ <p>If that isn't the problem, you've probably misspelled or left out
necessary
+ database namespaces or tags. Consult the documentation or the
samples.</p>
+ </answer>
+ </faq>
+
<faq id="illegalcharacter">
<question>When I use the SQL/EQSL taglib or the SQL procesor, I get an
exception
<em>DOM-002: Illegal Character</em> - what does this mean?</question>
@@ -413,19 +427,24 @@
change your stylesheet, if necessary, to match on the new element
name.)</p>
</answer>
</faq>
+</faqsection>
- <faq id="dbdoesnothing">
- <question>My database access page just outputs the driver, username, etc.
as if
- Cocoon hadn't processed it at all</question>
+<faqsection title="Output Formatting and Internationalization">
+ <faq id="entities">
+ <question>
+ Why doesn't Cocoon recognise HTML entities like &nbsp; ?
+ </question>
<answer>
- <p>Firstly, have you checked that cocoon is working by going to
Cocoon.xml ?</p>
- <p>If that isn't the problem, you've probably misspelled or left out the
necessary
- database namespace. Consult the documentation or the samples.</p>
+ <p>In HTML documents a large set of entities are implicitly defined, but
in XML documents
+ only a few are defined. So you must either use the numerical character
codes, or
+ declare the entities explicitly. A limited list is supplied in
+ <code>xdocs/dtd/characters.ent</code>. For example, one way to write a
non-breaking
+ space is to write <code>&#160;</code> - just <code>&nbsp;</code>
won't work, unless you
+ explicitly define <code>&nbsp;</code>.
+ Anyway this is a basic XML question, so please don't ask on cocoon-users
about it!</p>
</answer>
</faq>
-</faqsection>
-<faqsection title="Output Formatting and Internationalization">
<faq id="xspencoding2">
<question>
When I use XSP and non-English characters, they just come out as question
marks
