[jboss-cvs] JBossAS SVN: r104902 - in projects/snowdrop/branches/enterprise: Snowdrop_1.1_User_Guide and 1 other directories.

jboss-cvs-commits at lists.jboss.org jboss-cvs-commits at lists.jboss.org
Tue May 18 01:03:20 EDT 2010


Author: laubai
Date: 2010-05-18 01:03:19 -0400 (Tue, 18 May 2010)
New Revision: 104902

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

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Author_Group.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Author_Group.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Author_Group.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1_User_Guide/en-US/Book_Info.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Book_Info.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Book_Info.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1 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.1 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.1_User_Guide/en-US/Configuration.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Configuration.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Configuration.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,356 @@
+<?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>Component usage</title>
+
+  <para>
+    This chapter details how to use each of the components
+    included in Snowdrop.
+  </para>
+
+  <section>
+    <title>VFS-enabled Application Contexts</title>
+
+    <note>
+      <para>
+        From Spring 3.0 onward, the <classname>ApplicationContext</classname>
+        implementations shipped with the Spring framework are VFS-compatible.
+        The components described in this section are included with Snowdrop
+        to provide backwards compatibility, but are not necessarily required.
+      </para>
+    </note>
+
+    <para>
+      The <filename>snowdrop-vfs.jar</filename> library supports resource
+      scanning in the JBoss Virtual File System (VFS).
+    </para>
+
+    <para>
+      When Spring 2.5 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 provides
+      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 <filename>snowdrop-vfs.jar</filename>:
+    </para>
+
+    <variablelist>
+      <varlistentry>
+        <term><classname>org.jboss.spring.vfs.context.VFSClassPathXmlApplicationContext</classname></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" ?>
+
+      <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>
+
+    <para>
+      To change the type of application context created by the
+      <classname>DispatcherServlet</classname>, use the same 
+      <classname>contextClass</classname> parameter on the 
+      <classname>DispatcherServlet</classname> definition as shown:
+    </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" ?>-->
+
+    <important>
+      <title>Important: <exceptionname>ZipException</exceptionname></title>
+      <para>
+        If you encounter the <exceptionname>ZipException</exceptionname> when
+        attempting to start the application, you need to replace the default
+        <classname>ApplicationContext</classname> 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>
+    </important>
+  </section>
+
+  <section>
+    <title>Load-time weaving</title>
+
+    <note>
+      <para>
+        From Spring 3.0 onward, load-time weaving on JBoss Enterprise Application
+        Platform and JBoss Enterprise Web Platform is supported out of the box.
+        The component described in this section can be used to facilitate backwards 
+        compatibility, but configuring a custom load-time weaver is not required 
+        when using Spring 3.0.
+      </para>
+    </note>
+
+    <para>
+      Load-time weaving support is provided by the 
+      <filename>snowdrop-weaving.jar</filename> library.
+    </para>
+
+    <para>
+      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. For JBoss Enterprise Application Platform,
+      JBoss Enterprise Web Platform and JBoss Enterprise Web Server, 
+      a classloader-specific <classname>LoadTimeWeaver</classname> is necessary.
+    </para>
+
+    <para>
+      Define the <classname>JBoss5LoadTimeWeaver</classname> in the 
+      <literal>www</literal> Spring application context as shown here:
+    </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 Spring deployer allows you to bootstrap a
+      Spring application context, bind it in JNDI, and use it to
+      provide Spring-configured business object instances.
+    </para>
+
+    <section>
+      <title>JBoss + Spring + EJB 3.0 Integration</title>
+
+      <para>
+        Snowdrop contains a JBoss deployer that supports Spring
+        packaging in JBoss Enterprise Application Platform,
+        JBoss Enterprise Web Platform and JBoss Enterprise Web Server. 
+        This means it is possible to create JAR archives with a
+        <filename>META-INF/jboss-spring.xml</filename> file to have your
+        Spring bean factories deploy automatically.
+      </para>
+      
+      <para>
+        EJB 3.0 integration is also supported. You can deploy Spring archives
+        and inject beans created in these deployments directly into an EJB by
+        using the <varname>@Spring</varname> annotation.
+      </para>
+    </section>
+
+    <section>
+      <title>Installation</title>
+
+      <para>
+        To install the Snowdrop JBoss deployer, unzip the
+        <filename>jboss-spring-deployer.zip</filename> in the
+        <filename>$JBOSS_HOME/server/$PROFILE/deployers</filename> directory of
+        your JBoss Enterprise Application Platform or JBoss Enterprise Web Platform
+        installation.
+      </para>
+
+<!--      <itemizedlist>
+        <listitem>
+          <para>org.springframework.beans-3.0.2.RELEASE.jar;</para>
+        </listitem>
+
+        <listitem>
+          <para>org.springframework.context-3.0.2.RELEASE.jar;</para>
+        </listitem>
+
+        <listitem>
+          <para>org.springframework.core-3.0.2.RELEASE.jar.</para>
+        </listitem>
+      </itemizedlist>-->
+    </section>
+
+    <section>
+      <title>Spring deployments</title>
+
+      <para>
+        You can create Spring deployments that work similarly to JARs, EARs, and WARs
+        with the JBoss Spring deployer. Spring JARs are created with the following 
+        structure:
+      </para>
+
+      <screen>my-app.spring/
+  org/
+    acme/
+      MyBean.class
+      MyBean2.class
+  META-INF/
+    jboss-spring.xml</screen>
+
+      <para>
+        <filename>my-app.spring</filename> is a JAR that contains classes. A 
+        <filename>jboss-spring.xml</filename> file exists in the 
+        <filename>META-INF</filename> directory of the JAR. By default, the
+        JBoss Spring deployer registers the bean factory defined in 
+        <filename>jboss-spring.xml</filename> into JNDI in a non-serialized
+        form. The default JNDI name is the short name of the deployment file &#8212;
+        in this case, <literal>my-app</literal>.
+      </para>
+
+      <para>
+        You do not have to create an archive. Instead, you can place your JAR
+        libraries under <filename>$JBOSS_HOME/server/$PROFILE/lib</filename> and
+        add an XML file of the form <literal>&lt;name&gt;-spring.xml</literal>,
+        for example, <filename>my-app-spring.xml</filename>, into the
+        <filename>deploy</filename> directory of your JBoss Enterprise Application
+        Platform or JBoss Enterprise Web Platform installation. The default JNDI
+        name will be the short name of the XML file; in this case,
+        <literal>my-app</literal>.
+      </para>
+    </section>
+
+    <section>
+      <title>Deployment</title>
+
+      <para>
+        Once you have created a <filename>.spring</filename> or a 
+        <emphasis>-spring.xml</emphasis> file, copy it into the 
+        <filename>deploy</filename> directory of your JBoss Enterprise Application
+        Platform or JBoss Enterprise Web Platform installation to deploy
+        it into the JBoss runtime. You can also embed these deployments in an
+        EAR, EJB-SAR, SAR, etc. since JBoss Enterprise Application Platform and
+        JBoss Enterprise Web Platform support 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>
+        <literal>MyApp</literal> 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, like so:
+      </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 <classname>ApplicationContext</classname> has been successfully bootstrapped,
+        the Spring beans defined in it can be used for injection into EJBs.
+        To do this, the EJBs must be intercepted with the
+        <classname>SpringLifecycleInterceptor</classname>, as in the following example:
+      </para>
+
+      <programlisting>@Stateless
+ at Interceptors(SpringLifecycleInterceptor.class)
+public class InjectedEjbImpl implements InjectedEjb
+{
+ @Spring(bean = "springBeanName", jndiName = "SpringDao")
+ private SpringBean springBean;
+
+ /* rest of the class definition ommitted */
+}</programlisting>
+    </section>
+  </section>
+</chapter>

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Feedback.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Feedback.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Feedback.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1 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.1_User_Guide/en-US/Fulltext.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Fulltext.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Fulltext.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="chap-Snowdrop_1.1_User_Guide-Test_Chapter">
+	<title>Test Chapter</title>
+	<para>
+		This is a test paragraph
+	</para>
+	<section id="sect-Snowdrop_1.1_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.1_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.1_User_Guide/en-US/Introduction.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Introduction.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Introduction.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,48 @@
+<?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.1_User_Guide/en-US/Preface.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Preface.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Preface.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1_User_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-Snowdrop_1.1_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.1_User_Guide/en-US/Revision_History.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Revision_History.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Revision_History.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,26 @@
+<?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>Tue May 18 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.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.ent
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.ent	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.ent	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss Web Framework Kit">
+<!ENTITY BOOKID "Snowdrop_1.1_User_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "Red Hat, Inc">

Added: projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/Snowdrop_1.1_User_Guide.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -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.1_User_Guide/en-US/This_Guide.xml
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/This_Guide.xml	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/en-US/This_Guide.xml	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,52 @@
+<?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>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.1_User_Guide/publican.cfg
===================================================================
--- projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/publican.cfg	                        (rev 0)
+++ projects/snowdrop/branches/enterprise/Snowdrop_1.1_User_Guide/publican.cfg	2010-05-18 05:03:19 UTC (rev 104902)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Mon May 17 11:41:58 2010
+
+xml_lang: en-US
+type: Book
+brand: JBoss
+




More information about the jboss-cvs-commits mailing list