Return-Path: Delivered-To: apmail-incubator-abdera-commits-archive@locus.apache.org Received: (qmail 10077 invoked from network); 14 Jul 2006 21:03:18 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 14 Jul 2006 21:03:18 -0000 Received: (qmail 74288 invoked by uid 500); 14 Jul 2006 21:03:17 -0000 Delivered-To: apmail-incubator-abdera-commits-archive@incubator.apache.org Received: (qmail 74277 invoked by uid 500); 14 Jul 2006 21:03:17 -0000 Mailing-List: contact abdera-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: abdera-dev@incubator.apache.org Delivered-To: mailing list abdera-commits@incubator.apache.org Received: (qmail 74268 invoked by uid 99); 14 Jul 2006 21:03:17 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 14 Jul 2006 14:03:17 -0700 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [140.211.166.113] (HELO eris.apache.org) (140.211.166.113) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 14 Jul 2006 14:03:17 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id 0D2B31A981A; Fri, 14 Jul 2006 14:02:57 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r422045 - /incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java Date: Fri, 14 Jul 2006 21:02:56 -0000 To: abdera-commits@incubator.apache.org From: rooneg@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20060714210257.0D2B31A981A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Author: rooneg Date: Fri Jul 14 14:02:56 2006 New Revision: 422045 URL: http://svn.apache.org/viewvc?rev=422045&view=rev Log: Clean up the javadocs for ExtensionFactory. [ in core/src/main/java/org/apache/abdera/factory ] * ExtensionFactory.java: Add some html markup to the javadocs... Modified: incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java Modified: incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java URL: http://svn.apache.org/viewvc/incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java?rev=422045&r1=422044&r2=422045&view=diff ============================================================================== --- incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java (original) +++ incubator/abdera/java/trunk/core/src/main/java/org/apache/abdera/factory/ExtensionFactory.java Fri Jul 14 14:02:56 2006 @@ -25,25 +25,33 @@ import java.util.List; /** - * Extension Factories are used to provide a means of dynamically resolving - * builders for namespaced extension elements + *

+ * Extension Factories are used to provide a means of dynamically resolving + * builders for namespaced extension elements + *

+ * + *

There are four ways of supporting extension elements.

* - * There are four ways of supporting extension elements. + *
    + *
  1. Implement your own Factory (hard)
  2. + *
  3. Subclass the default Axiom-based Factory (also somewhat difficult)
  4. + *
  5. Implement and register an ExtensionFactory (wonderfully simple)
  6. + *
  7. Use the Feed Object Model's dynamic support for extensions (also very simple)
  8. + *
* - * 1. Implement your own Factory (hard) - * 2. Subclass the default Axiom-based Factory (also somewhat difficult) - * 3. Implement and register an ExtensionFactory (wonderfully simple) - * 4. Use the Feed Object Model's dynamic support for extensions (also very simple) + *

+ * Registering an Extension Factory requires generally nothing more than + * implementing ExtensionFactory and then creating the file + * META-INF/services/org.apache.abdera.factory.ExtensionFactory and listing + * the class names of each ExtensionFactory you wish to register. + *

* - * Registering an Extension Factory requires generally nothing more than - * implementing ExtensionFactory and then creating the file - * META-INF/services/org.apache.abdera.factory.ExtensionFactory and listing - * the class names of each ExtensionFactory you wish to register. - * - * Note that at this time, ExtensionFactories are specific to the parser - * implementation used. That is, if you're using the default StAX-based - * FOMParser and FOMFactory implementation, your ExtensionFactores will - * need to also implement FOMExtensionFactory. + *

+ * Note that at this time, ExtensionFactories are specific to the parser + * implementation used. That is, if you're using the default StAX-based + * FOMParser and FOMFactory implementation, your ExtensionFactores will + * need to also implement FOMExtensionFactory. + *

*/ public interface ExtensionFactory {