commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From simonetrip...@apache.org
Subject svn commit: r1078309 - in /commons/sandbox/digester3/trunk/src/site/fml: ./ guide/ guide/faq.fml
Date Sat, 05 Mar 2011 16:15:31 GMT
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>



Mime
View raw message