[jboss-cvs] JBossAS SVN: r104846 - in projects/snowdrop/branches: enterprise and 2 other directories.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Mon May 17 01:04:40 EDT 2010


Author: laubai
Date: 2010-05-17 01:04:40 -0400 (Mon, 17 May 2010)
New Revision: 104846

Added:
   projects/snowdrop/branches/enterprise/
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Author_Group.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Book_Info.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Configuration.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Feedback.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Fulltext.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Introduction.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Preface.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Revision_History.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.ent
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/This_Guide.xml
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/images/
   projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/publican.cfg
Log:
Adding Publican-valid Snowdrop 1.0 User Guide.


Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Author_Group.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Author_Group.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Author_Group.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,20 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE authorgroup PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+	<author>
+		<firstname>Marius</firstname>
+		<surname>Bogoevici</surname>
+	</author>
+  <author>
+    <firstname>Aleš</firstname>
+    <surname>Justin</surname>
+  </author>
+  <editor>
+    <firstname>Laura</firstname>
+    <surname>Bailey</surname>
+  </editor>
+</authorgroup>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Book_Info.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Book_Info.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Book_Info.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE bookinfo PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<bookinfo id="book-Snowdrop_1.0_User_Guide-Snowdrop_1.0_User_Guide">
+	<title>Snowdrop 1.0 User Guide</title>
+	<productname>JBoss Web Framework Kit</productname>
+	<productnumber>1.1</productnumber>
+	<edition>1</edition>
+	<pubsnumber>0.1</pubsnumber>
+	<abstract>
+		<para>
+			This book is a user guide to Snowdrop 1.0 for use with JBoss Web Framework Kit 1.1.
+		</para>
+	</abstract>
+	<corpauthor>
+		<inlinemediaobject>
+			<imageobject>
+				<imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+			</imageobject>
+		</inlinemediaobject>
+	</corpauthor>
+	<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Configuration.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Configuration.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Configuration.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,337 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+
+<chapter>
+  <title>How to use Snowdrop components</title>
+
+  <para>
+    This chapter details how to use each of the components included
+    in Snowdrop.
+  </para>
+
+  <section>
+    <title>Application Context Support in the VFS</title>
+
+    <para>
+      The <filename>snowdrop-vfs.jar</filename> library supports resource
+      scanning in the JBoss Virtual File System (VFS).
+    </para>
+
+    <para>
+      When the Spring Framework performs resource scanning, it assumes that
+      resources are either from a directory or a packaged JAR, and treats
+      any URLs it encounters accordingly.
+    </para>
+    
+    <para>
+      This assumption is not correct for the JBoss VFS, so Snowdrop implements
+      a different underlying resource resolution mechanism by amending the 
+      functionality of the 
+      <classname>PathMatchingResourcePatternResolver</classname>.
+    </para>
+
+    <para>
+      This is done by using one of two <classname>ApplicationContext</classname>
+      implementations provided by the <filename>snowdrop-vfs.jar</filename>:
+    </para>
+
+    <variablelist>
+      <varlistentry>
+        <term>org.jboss.spring.vfs.context.VFSClassPathXmlApplicationContext</term>
+        <listitem>
+          <para>
+            Replaces the Spring 
+            <classname>org.springframework.context.support.ClassPathXmlApplicationContext</classname>.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><classname>org.jboss.spring.vfs.context.VFSXmlWebApplicationContext</classname></term>
+        <listitem>
+          <para>
+            Replaces the Spring
+            <classname>org.springframework.web.context.support.XmlWebApplicationContext</classname>.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <para>
+      In many cases, the
+      <classname>VFSClassPathXmlApplicationContext</classname> is
+      instantiated on its own, using something like:
+    </para>
+
+    <programlisting language="Java">ApplicationContext context = 
+new VFSClassPathXmlApplicationContext("classpath:/context-definition-file.xml");</programlisting>
+
+    <para>
+      The <classname>XmlWebApplicationContext</classname> is not 
+      instantiated directly. Instead, it is bootstrapped by either the 
+      <classname>ContextLoaderListener</classname> or the 
+      <classname>DispatcherServlet</classname>. In this case, the class used 
+      for bootstrapping must be used to trigger an instantiation of the
+      VFS-enabled context.
+    </para>
+
+    <para>
+      To change the type of application context created by the
+      <classname>ContextLoaderListener</classname>, add the 
+      <varname>contextClass</varname> parameter as shown in the
+      following example code:
+    </para>
+
+    <!--<?dbfo-need height="5in" ?>-->
+
+    <informalexample>
+      <programlisting language="XML">&lt;context-param&gt;
+&lt;param-name&gt;contextConfigLocation&lt;/param-name&gt;
+&lt;param-value&gt;classpath*:spring-contexts/*.xml&lt;/param-value&gt;
+&lt;/context-param&gt;
+<emphasis role="bold">&lt;context-param&gt;
+&lt;param-name&gt;contextClass&lt;/param-name&gt;
+&lt;param-value&gt;
+  org.jboss.spring.vfs.context.VFSXmlWebApplicationContext
+&lt;/param-value&gt;
+&lt;/context-param&gt;</emphasis>
+&lt;listener&gt;
+&lt;listener-class&gt;org.springframework.web.context.ContextLoaderListener&lt;/listener-class&gt;
+&lt;/listener&gt;</programlisting>
+    </informalexample>
+
+    <para>
+      For changing the type of application context created by the
+      DispatcherServlet, use the contextClass parameter again, but this time
+      on the <literal>DispatcherServlet</literal> definition (emphasized
+      portion again):
+    </para>
+
+    <programlisting language="XML">&lt;servlet&gt;
+&lt;servlet-name&gt;spring-mvc-servlet&lt;/servlet-name&gt;
+&lt;servlet-class&gt;org.springframework.web.servlet.DispatcherServlet&lt;/servlet-class&gt;
+&lt;init-param&gt;
+  &lt;param-name&gt;contextConfigLocation&lt;/param-name&gt;
+  &lt;param-value&gt;/WEB-INF/mvc-config.xml&lt;/param-value&gt;
+&lt;/init-param&gt;<emphasis role="bold">  
+&lt;init-param&gt;
+&lt;param-name&gt;contextClass&lt;/param-name&gt;
+  &lt;param-value&gt;
+    org.jboss.spring.vfs.context.VFSXmlWebApplicationContext
+  &lt;/param-value&gt;
+&lt;/init-param&gt;
+</emphasis>&lt;/servlet&gt;</programlisting>
+
+    <para>
+      Both configurations can be seen at work in the web-scanning
+      sample.
+    </para>
+
+    <?dbfo-need height="5in" ?>
+
+    <note>
+      <para>
+        In general, it is a good idea to pay attention to this error. If
+        encountered while the application is starting, you definitely need to
+        replace the default ApplicationContext with one of the VFS-enabled
+        implementations.
+      </para>
+
+      <programlisting language="Java">Caused by: java.util.zip.ZipException: error in opening zip file
+...
+at org.springframework.core.io.support.PathMatchingResourcePatternResolver
+.doFindPathMatchingJarResources(PathMatchingResourcePatternResolver.java:448)</programlisting>
+    </note>
+  </section>
+
+  <section>
+    <title>Load-time weaving</title>
+
+    <para>
+      In order to perform load-time weaving for the application classes
+      in Spring (either for using load-time support for AspectJ or for JPA
+      support), the Spring framework needs to install its own transformers in
+      the classloader. In certain cases (like for JBoss 5.x), a
+      classloader-specific LoadTimeWeaver is necessary. The functionalities
+      described in this chapter are included in the snowdrop-weaving.jar
+      file.
+    </para>
+
+    <para>
+      To that effect, if a load-time weaver needs to be defined in the
+      www Spring application context, use the JBoss5LoadTimeWeaver class, as
+      follows:
+    </para>
+
+    <programlisting language="Java">&lt;context:load-time-weaver weaver-class="org.jboss.instrument.classloading.JBoss5LoadTimeWeaver"/&gt;</programlisting>
+  </section>
+
+  <section>
+    <title>The Spring Deployer</title>
+
+    <para>
+      The role of the Spring Deployer is to allow the bootstrapping of a
+      Spring application context, binding it in JNDI and using it for
+      providing Spring-configured business object instances.
+    </para>
+
+    <section>
+      <title>JBoss + Spring + EJB 3.0 Integration</title>
+
+      <para>
+        This distribution contains a JBoss Deployer that supports Spring
+        packaging in JBoss. What this means is that you can create JAR
+        archives with a <filename>META-INF/jboss-spring.xml</filename> file
+        and your Spring bean factories will automatically be deployed. Also
+        supported in this distribution is EJB 3.0 integration. You can deploy
+        Spring archives and be able to inject beans created in these
+        deployment directly into an EJB using a @Spring annotation.
+      </para>
+    </section>
+
+    <section>
+      <title>Installation</title>
+
+      <para>
+        For installing the Snowdrop deployer, unzip the
+        jboss-spring-deployer.zip file in
+        JBOSS_HOME/server/&lt;configuration&gt;/deployers. The distribution
+        you are installing from may or may not contain the Spring jars. If the
+        archive does not contain the Spring jars, please include the following
+        files from the Spring 2.5.6.SEC01 distribution:
+      </para>
+
+      <itemizedlist>
+        <listitem>
+          <para>spring-beans.jar;</para>
+        </listitem>
+
+        <listitem>
+          <para>spring-context.jar;</para>
+        </listitem>
+
+        <listitem>
+          <para>spring-core.jar.</para>
+        </listitem>
+      </itemizedlist>
+    </section>
+
+    <section>
+      <title>Spring deployments</title>
+
+      <para>
+        You can create Spring deployments that work much in the same way
+        .sar's, .war's, .ear's, .har's, and .rar's work. Using the JBoss
+        Spring deployer you can create Spring jars:
+      </para>
+
+      <screen>my-app.jar/
+ org/
+    acme/
+        MyBean.class
+        MyBean2.class
+ META-INF/
+         jboss-spring.xml</screen>
+
+      <para>
+        So, my-app.JAR is a jar that contains classes, like any other
+        JAR and a jboss-spring.xml file in the META-INF/ of the jar. This
+        jboss-spring.xml file is like any other Spring xml file. By default,
+        the JBoss Spring Deployer will register this bean factory defined in
+        the XML file into JNDI. It will be registered in a non-serialized form
+        so you don't have to worry about JNDI serialization! The default JNDI
+        name will be the short name of the deployment file. So in this
+        example, the bean factory described in the
+        <filename>META-INF/jboss-spring.xml</filename> file will be registered
+        under the "my-app" JNDI name.
+      </para>
+
+      <para>
+        Alternatively, you do not have to create an archive. You can put
+        your jar libraries under server/&lt;config-name&gt;/lib and just put
+        an XML file of the form: &lt;name&gt;-spring.xml into the JBoss deploy
+        directory. For example, my-app-spring.xml. Again, the JNDI name will
+        be by default, the short name of the XML file, in the case
+        my-app-spring.xml will produce a JNDI binding of "my-app".
+      </para>
+    </section>
+
+    <section>
+      <title>Deployment</title>
+
+      <para>
+        Once you have created a <emphasis>.spring</emphasis> archive (or
+        a .jar) or a <emphasis>-spring.xml</emphasis> file, all you have to do
+        is put it in the JBoss deploy/ directory and it will be deployed into
+        the JBoss runtime. You can also embed these deployments inside an EAR,
+        EJB-JAR, SAR, etc. as JBoss supports nested archives.
+      </para>
+    </section>
+
+    <section>
+      <title>Defining the JNDI name</title>
+
+      <para>
+        You can specify the JNDI name explicitly by putting it in the
+        description element of the Spring XML.
+      </para>
+
+      <?dbfo-need height="5in" ?>
+
+      <programlisting language="XML">&lt;beans&gt;
+  &lt;description&gt;BeanFactory=(MyApp)&lt;/description&gt;
+  ...
+  &lt;bean id="springBean" class="example.SpringBean"/&gt;
+&lt;/beans&gt;</programlisting>
+
+      <para>
+        MyApp will be used as the JNDI name in this example.
+      </para>
+    </section>
+
+    <section>
+      <title>Parent Bean factories</title>
+
+      <para>
+        Sometimes you want your deployed Spring bean factory to be able
+        to reference beans deployed in another Spring deployment. You can do
+        this by declaring a parent bean factory in the description element in
+        the Spring XML.
+      </para>
+
+      <programlisting language="XML">&lt;beans&gt;
+&lt;description&gt;BeanFactory=(AnotherApp) ParentBeanFactory=(MyApp)&lt;/description&gt;
+...
+&lt;/beans&gt;</programlisting>
+    </section>
+
+    <section>
+      <title>Injection into EJBs</title>
+
+      <para>
+        Once an ApplicationContext has been successfully bootstrapped,
+        the Spring beans defined in it can be used for injection into EJBs. To
+        that end, the EJBs must be intercepted with the
+        SpringLifecycleInterceptor, as in the following example:
+      </para>
+
+      <programlisting>@Stateless
+ at Interceptors(SpringLifecycleInterceptor.class)
+public class InjectedEjbImpl implements InjectedEjb
+{
+ @Spring(bean = "springBean", jndiName = "MyApp")
+ private SpringBean springBean;
+
+ /* rest of the class definition ommitted */
+}</programlisting>
+
+      <para>
+        In this example, the EJB InjectedEjbImpl will be injected with
+        the bean named 'springBean', defined in the ApplicationContext
+        previously described in sections 3.3 and 3.5.
+      </para>
+    </section>
+  </section>
+</chapter>

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Feedback.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Feedback.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Feedback.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,23 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "../Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section>
+	<title>We Need Feedback!</title>
+	<indexterm>
+		<primary>feedback</primary>
+		<secondary>contact information for this manual</secondary>
+	</indexterm>
+	<para>
+		If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a report in JIRA: <ulink url="http://jira.jboss.org/">http://jira.jboss.org/</ulink> against the product <application>JBoss Enterprise Application Platform</application> and component <emphasis>Documentation</emphasis>.
+	</para>
+	<para>
+		When submitting a bug report, be sure to mention the manual's identifier: &PRODUCT; <citetitle>Snowdrop 1.0 User Guide</citetitle>.
+	</para>
+	<para>
+		If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.
+	</para>
+</section>
+
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Fulltext.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Fulltext.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Fulltext.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,33 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Snowdrop_1.0_User_Guide-Test_Chapter">
+	<title>Test Chapter</title>
+	<para>
+		This is a test paragraph
+	</para>
+	<section id="sect-Snowdrop_1.0_User_Guide-Test_Chapter-Test_Section_1">
+		<title>Test Section 1</title>
+		<para>
+			This is a test paragraph in a section
+		</para>
+	</section>
+	
+	<section id="sect-Snowdrop_1.0_User_Guide-Test_Chapter-Test_Section_2">
+		<title>Test Section 2</title>
+		<para>
+			This is a test paragraph in Section 2
+			<orderedlist>
+				<listitem>
+					<para>
+						listitem text
+					</para>
+				</listitem>
+			</orderedlist>
+		</para>
+	</section>
+
+</chapter>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Introduction.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Introduction.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Introduction.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,49 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+
+<chapter>
+  <title>Introduction</title>
+
+  <section>
+    <title>Package Structure</title>
+
+    <para>Snowdrop contains the following files:</para>
+
+    <variablelist>
+      <varlistentry>
+        <term><filename>snowdrop-vfs.jar</filename></term>
+        <listitem>
+          <para>
+            A library that contains the support classes
+            for resource scanning (scanning the classpath for
+            bean definitions, or using "classpath*:"-style
+            patterns).
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>snowdrop-weaving.jar</filename></term>
+        <listitem>
+          <para>
+            A library that contains the support
+            classes for load-time weaving.
+          </para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>spring-deployer.zip</filename></term>
+        <listitem>
+          <para>
+              The Spring deployer, which bootstraps and registers
+              the application contexts to be used by your
+              Java EE applications.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </section>
+</chapter>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Preface.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Preface.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Preface.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,13 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE preface PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-Snowdrop_1.0_User_Guide-Preface">
+	<title>Preface</title>
+	<xi:include href="Common_Content/Conventions.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude"><xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude"><xi:include href="Common_Content/Feedback.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	</xi:fallback>
+	</xi:include>
+</preface>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Revision_History.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Revision_History.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Revision_History.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,27 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<appendix id="appe-Snowdrop_1.0_User_Guide-Revision_History">
+	<title>Revision History</title>
+	<simpara>
+		<revhistory>
+			<revision>
+				<revnumber>0.1</revnumber>
+				<date>Mon May 17 2010</date>
+				<author>
+					<firstname>Laura</firstname>
+					<surname>Bailey</surname>
+					<email>lbailey at redhat.com</email>
+				</author>
+				<revdescription>
+					<simplelist>
+						<member>Converted book to Publican format.</member>
+					</simplelist>
+				</revdescription>
+			</revision>
+		</revhistory>
+	</simpara>
+</appendix>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.ent
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.ent	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.ent	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss Web Framework Kit">
+<!ENTITY BOOKID "Snowdrop_1.0_User_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "Red Hat, Inc">

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/Snowdrop_1.0_User_Guide.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,14 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+	<xi:include href="Book_Info.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="This_Guide.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Configuration.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Revision_History.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+</book>
+

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/This_Guide.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/This_Guide.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/en-US/This_Guide.xml	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,52 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "Snowdrop_1.0_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+
+<chapter>
+  <title>What This Guide Covers</title>
+
+  <para>
+    Snowdrop is a utility package that contains JBoss-specific
+    extensions to the Spring Framework. These extensions are
+    either:
+  </para>
+  <itemizedlist>
+    <listitem>
+      <para>
+        extensions to Spring Framework classes that can be used
+        wherever the generic implementations provided by the framework do
+        not integrate correctly with JBoss Web Framework Kit.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+        extensions for deploying and running Spring applications with
+        JBoss Enterprise Application Platform, JBoss Enterprise Web Platform,
+        and JBoss Enterprise Web Server.
+      </para>
+    </listitem>
+  </itemizedlist>
+
+  <para>
+    This user guide aims to cover the functionality of Snowdrop, to
+    describe its components, and to provide information on how to use it
+    optimally for running Spring applications in JBoss Enterprise Application
+    Platform, JBoss Enterprise Web Platform, and JBoss Enterprise Web Server.
+  </para>
+
+  <!--<para>
+    The current version of the package is supporting the following
+    configuration:
+  </para>
+
+  <itemizedlist>
+    <listitem>
+      <para>JBoss AS 5.x</para>
+    </listitem>
+    <listitem>
+      <para>Spring 2.5.x</para>
+    </listitem>
+  </itemizedlist>-->
+</chapter>

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/publican.cfg
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/publican.cfg	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.0_User_Guide/publican.cfg	2010-05-17 05:04:40 UTC (rev 104846)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Mon May 17 11:41:52 2010
+
+xml_lang: en-US
+type: Book
+brand: JBoss
+




More information about the jboss-cvs-commits mailing list