Author: simonetripodi
Date: Sat Mar 5 16:15:31 2011
New Revision: 1078309
URL: http://svn.apache.org/viewvc?rev=1078309&view=rev
Log:
first checkin of FAQ
Added:
commons/sandbox/digester3/trunk/src/site/fml/
commons/sandbox/digester3/trunk/src/site/fml/guide/
commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml
Added: commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml
URL:
http://svn.apache.org/viewvc/commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml?rev=1078309&view=auto
==============================================================================
--- commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml (added)
+++ commons/sandbox/digester3/trunk/src/site/fml/guide/faq.fml Sat Mar 5
16:15:31 2011
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<faqs xmlns="http://maven.apache.org/FML/1.0.1";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/FML/1.0.1
http://maven.apache.org/xsd/fml-1.0.1.xsd";
+ title="Frequently Asked Questions"
+ toplink="false">
+
+ <part id="General">
+ <faq id="jaxp_1_1_warnings">
+ <question>Why do I get warnings when using a JAXP 1.1
parser?</question>
+ <answer>
+ <p>If you're using a JAXP 1.1 parser, you might see the
following warning (in your log):</p>
+<source>
+[WARN] Digester - -Error: JAXP SAXParser property not recognized:
http://java.sun.com/xml/jaxp/properties/schemaLanguage
+</source>
+<p>This property is needed for JAXP 1.2 (XML Schema support) as required
+for the Servlet Spec. 2.4 but is not recognized by JAXP 1.1 parsers.
+This warning is harmless.</p>
+ </answer>
+ </faq>
+
+ <faq id="schema_validation_out_box">
+ <question>Why Doesn't Schema Validation Work With Parser XXX Out
Of The Box?</question>
+ <answer><p>
+Schema location and language settings are often need for validation using
schemas.
+Unfortunately, there isn't a single standard approach to how these properties
are
+configured on a parser.
+Digester tries to guess the parser being used and configure it appropriately
+but it's not infallible.
+You might need to grab an instance, configure it and pass it to Digester.
+</p>
+<p>
+If you want to support more than one parser in a portable manner,
+then you'll probably want to take a look at the
+<code>org.apache.commons.digester.parsers</code> package
+and add a new class to support the particular parser that's causing problems.
+</p></answer>
+ </faq>
+
+ <faq id="help">
+ <question>Help!
+I'm Validating Against Schema But Digester Ignores Errors!</question>
+ <answer><p>
+Digester is based on <a href="http://www.saxproject.org";>SAX</a>. The
convention for
+SAX parsers is that all errors are reported (to any registered
+<code>ErrorHandler</code>) but processing continues. Digester (by default)
+registers its own <code>ErrorHandler</code> implementation. This logs details
+but does not stop the processing (following the usual convention for SAX
+based processors).
+</p>
+<p>
+This means that the errors reported by the validation of the schema will
appear in the
+Digester logs but the processing will continue. To change this behaviour, call
+<code>digester.setErrorHandler</code> with a more suitable implementation.
+</p></answer>
+ </faq>
+
+ <faq id="example_code">
+ <question>Where Can I Find Example Code?</question>
+ <answer><p>Digester ships with a sample application: a mapping for
the <em>Rich Site
+Summary</em> format used by many newsfeeds. Download the source distribution
+to see how it works.</p>
+<p>Digester also ships with a set of examples demonstrating most of the
+features described in this document. See the "src/examples" subdirectory
+of the source distribution.</p></answer>
+ </faq>
+
+ <faq id="support_rich_site">
+ <question>When Are You Going To Support <em>Rich Site Summary</em>
Version x.y.z?</question>
+ <answer><p>The <em>Rich Site Summary</em> application is intended
to be a sample application.
+It works but we have no plans to add support for other versions of the format.
+</p>
+<p>
+We would consider donations of standard digester applications but it's
unlikely that
+these would ever be shipped with the base digester distribution.
+If you want to discuss this, please post to <a
href="http://commons.apache.org/mail-lists.html";>
+commons dev mailing list</a>
+</p></answer>
+ </faq>
+ </part>
+</faqs>
