[jboss-cvs] JBossAS SVN: r110685 - in projects/docs/enterprise/WFK: Spring_Developer_Guide and 2 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Wed Feb 16 02:03:55 EST 2011
Author: marius.bogoevici
Date: 2011-02-16 02:03:54 -0500 (Wed, 16 Feb 2011)
New Revision: 110685
Added:
projects/docs/enterprise/WFK/Spring_Developer_Guide/
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Author_Group.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Book_Info.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Getting_Started_Introductory_Example.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Migration_Guide.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Preface.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Revision_History.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.ent
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_On_JBoss_Best_Practices.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Conventions.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Feedback.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Legal_Notice.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Acknowledgements.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Share_and_Share_Alike.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_A.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_B.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_C.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_D.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/pom.xml
projects/docs/enterprise/WFK/Spring_Developer_Guide/publican.cfg
Log:
First version of the Developer's Guide - Structure and Preliminary content
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Author_Group.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Author_Group.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Author_Group.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,33 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<authorgroup>
+ <author>
+ <firstname>Marius</firstname>
+
+ <surname>Bogoevici</surname>
+
+ <affiliation>
+ <orgname>Red Hat, Inc</orgname>
+ </affiliation>
+
+ <email>mariusb at redhat.com</email>
+ </author>
+
+ <editor>
+ <firstname>Rebecca</firstname>
+
+ <surname>Newton</surname>
+
+ <affiliation>
+ <orgname>Red Hat, Inc</orgname>
+
+ <orgdiv>Engineering Content Services</orgdiv>
+ </affiliation>
+
+ <email>rnewton at redhat.com</email>
+ </editor>
+</authorgroup>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Book_Info.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Book_Info.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Book_Info.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,42 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<bookinfo id="book-JBoss_Sample_Project-JBoss_Sample_Project">
+ <title>Spring Developer's Guide</title>
+
+ <subtitle>An Introduction to developing Spring-based applications for the
+ JBoss platform</subtitle>
+
+ <productname>Web Framework Kit</productname>
+
+ <productnumber>1.2</productnumber>
+
+ <edition>2</edition>
+
+ <pubsnumber>0</pubsnumber>
+
+ <abstract>
+ <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:fallback>
+ <xi:include href="fallback_content/Legal_Notice.xml" />
+ </xi:fallback>
+ </xi:include>
+
+ <xi:include href="Author_Group.xml"
+ xmlns:xi="http://www.w3.org/2001/XInclude" />
+</bookinfo>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Getting_Started_Introductory_Example.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Getting_Started_Introductory_Example.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Getting_Started_Introductory_Example.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,43 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="Getting_Started_Introductory_Example">
+ <title>Getting started - an introductory example</title>
+
+ <para>This chapter will provide a quick walkthrough on developing a simple
+ Spring MVC application on JBoss AS, using the JBoss Developer Studio.</para>
+
+ <section>
+ <title>The tools: prerequisites</title>
+
+ <para>During this tutorial, we are using:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Maven 3.0.1 (optional)</para>
+ </listitem>
+
+ <listitem>
+ <para>Spring 3.0.5.RELEASE (although the content is not specific to
+ this particular version of Spring)</para>
+ </listitem>
+
+ <listitem>
+ <para>JBoss Developer Studio 3</para>
+ </listitem>
+
+ <listitem>
+ <para>JBoss Enterprise Application Platform 5.1.1</para>
+ </listitem>
+ </itemizedlist>
+ </section>
+
+ <section>
+ <title>Creating a project</title>
+
+ <para></para>
+ </section>
+</chapter>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Migration_Guide.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Migration_Guide.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Migration_Guide.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,21 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="Migration_Guide">
+ <title>Migrating examples</title>
+
+ <para>In this chapter we will illustrate how Spring applications which have
+ been originally designed to run on servlet containers such as Tomcat or
+ Jetty can be migrated to take advantage of the JBoss middleware service
+ support and infrastructure. In order to do so, we will use the sample
+ applications provided by the Spring framework.</para>
+
+ <section>
+ <title>Spring's PetClinic</title>
+
+ <para></para>
+ </section>
+</chapter>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Preface.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Preface.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Preface.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,22 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<preface id="pref-JBoss_Sample_Project-Preface">
+ <title>Preface</title>
+ <!-- for publican -->
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Common_Content/Conventions.xml">
+ <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude">
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="fallback_content/Conventions.xml"/>
+ </xi:fallback>
+ </xi:include>
+ <!-- for publican -->
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Feedback.xml">
+ <xi:fallback xmlns:xi="http://www.w3.org/2001/XInclude">
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="fallback_content/Feedback.xml"/>
+ </xi:fallback>
+ </xi:include>
+
+</preface>
+
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Revision_History.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Revision_History.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Revision_History.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,14 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<appendix>
+ <title>Revision History</title>
+ <simpara>
+ <revhistory>
+
+ </revhistory>
+ </simpara>
+</appendix>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.ent
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.ent (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.ent 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "Documentation">
+<!ENTITY BOOKID "Spring_Developer_Guide">
+<!ENTITY YEAR "2011">
+<!ENTITY HOLDER "Red Hat Inc.">
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_Developer_Guide.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<book>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Book_Info.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Preface.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Getting_Started_Introductory_Example.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Spring_On_JBoss_Best_Practices.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Migration_Guide.xml"/>
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Revision_History.xml"/>
+ <!-- <index/> -->
+</book>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_On_JBoss_Best_Practices.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_On_JBoss_Best_Practices.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/Spring_On_JBoss_Best_Practices.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,199 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<chapter id="Spring_On_JBoss_Best_Practices">
+ <title>Best practices and integration guidelines</title>
+
+ <para>The Spring Framework is a flexible environment for developing
+ enterprise applications, with respect to the middleware integration.This
+ means that the developer has the benefit of being able to choose between a
+ number of alternatives when it comes to accessing middleware services.
+ </para>
+
+ <para>JBoss is a feature-rich application server, that provides a complex
+ and performant set of middleware services. Spring developers can take
+ advantage of those services by opting to use the dedicated Java EE
+ integration features of Spring.</para>
+
+ <section>
+ <title>Setting up data access</title>
+
+ <para>Spring applications can either deploy their own data access
+ infrastructure, or rely on a managed infrastructure provided by the
+ application server. The recommended practice for JBoss is to use the
+ server-provided infrastructure. In general we recommend using a managed
+ infrastructure using JTA transaction management.</para>
+
+ <para>The following subsections will detail the configuration strategy
+ for:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>datasources;</para>
+ </listitem>
+
+ <listitem>
+ <para>Hibernate SessionFactories;</para>
+ </listitem>
+
+ <listitem>
+ <para>JPA EntityManagers and EntityManagerFactories;</para>
+ </listitem>
+
+ <listitem>
+ <para>transaction management;</para>
+ </listitem>
+ </itemizedlist>
+
+ <section>
+ <title>Database access through managed datasources</title>
+
+ <para>On JBoss we recommend using managed datasources, which are
+ accessible via JNDI, and can be deployed through a simple configuration
+ file.</para>
+
+ <para>The definition for such a datasource would be included in a file
+ whose name ends in -ds.xml (e.g. sportsclub-ds.xml) and can either
+ copied in the deploy directory of the target JBoss AS configuration,
+ case in which it will be deployed at startup, or it can be included in
+ the META-INF directory of the application, case in which the managed
+ datasource will be created after deployment.</para>
+
+ <example>
+ <title>Managed datasource configuration</title>
+
+ <programlisting><datasources>
+ <local-tx-datasource>
+
+ <jndi-name>ExampleDsJndiName</jndi-name>
+
+ <connection-url> example JDBC URL </connection-url>
+ ...
+ </local-tx-datasource>
+</datasources></programlisting>
+ </example>
+
+ <para>The datasource will be bound in JNDI at java:/ExampleDsJndiName.
+ It can be referenced from a Spring ApplicationContext by using the
+ following definition:</para>
+
+ <example>
+ <title>Defining a managed datasource Spring bean</title>
+
+ <para><jee:jndi-lookup id="dataSource"
+ jndi-name="java:/ExampleDsJndiName"/></para>
+ </example>
+ </section>
+
+ <section>
+ <title>Defining a Hibernate SessionFactory</title>
+
+ <para>Applications that use Hibernate directly (as opposed to JPA)
+ should take advantage of the fact that Hibernate is already included in
+ the application server. Therefore, applications do not need to include a
+ Hibernate distribution.</para>
+
+ <para>Spring applications can one of the Spring's
+ SessionFactory-instantiating FactoryBeans, and a managed datasource (see
+ previous section for details).</para>
+
+ <example>
+ <title>SessionFactory bean definition</title>
+
+ <para><programlisting><bean id="sessionFactory" class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">
+ <property name="dataSource" ref="dataSource"/>
+ ...
+</bean></programlisting></para>
+ </example>
+
+ <para>We recommend JTA transaction management and Hibernate-JTA session
+ management integration by setting up the following properties:</para>
+
+ <example>
+ <title>JTA session management setup properties</title>
+
+ <programlisting>hibernate.current_session_context_class=jta
+hibernate.transaction.manager_lookup_class=org.hibernate.transaction.JBossTransactionManagerLookup
+hibernate.transaction.factory_class=org.hibernate.transaction.JTATransactionFactory</programlisting>
+ </example>
+ </section>
+
+ <section>
+ <title>Defining JPA persistence unit</title>
+
+ <para>Spring applications that use JPA are advised to managed
+ persistence unit and access them from JNDI. In order to bind the entity
+ manager or entity manager factory under a well-established name,
+ applications can use special Hibernate configuration properties.</para>
+
+ <example>
+ <title>Persistence unit definition</title>
+
+ <programlisting><persistence xmlns="http://java.sun.com/xml/ns/persistence" version="1.0">
+ <persistence-unit name="sportsclubPU">
+ <jta-data-source>java:/ExampleDsJndiName</jta-data-source>
+ <properties>
+ <property name="jboss.entity.manager.jndi.name" value="java:/example/em"/>
+ <property name="jboss.entity.manager.factory.jndi.name" value="java:/example/emf"/>
+ ...
+ </properties>
+ </persistence-unit>
+</persistence></programlisting>
+ </example>
+
+ <para>Spring applications can use either container-managed entity
+ managers or, if necessary, application-managed entity managers (case in
+ which they will be provided with the corresponding entity manager
+ factories).</para>
+
+ <example>
+ <title>Spring bean representing a container-managed entity
+ manager</title>
+
+ <programlisting><jee:jndi-lookup id="entityManager" jndi-name="java:/example/em"/></programlisting>
+ </example>
+
+ <example>
+ <title>Spring bean representing an entity manager factory</title>
+
+ <programlisting><jee:jndi-lookup id="entityManagerFactory" jndi-name="java:/example/emf"/></programlisting>
+ </example>
+ </section>
+
+ <section>
+ <title>Transaction management</title>
+
+ <para>The recommended transaction management strategy for JBoss is by
+ using JTA whose performance is close to native JDBC in single-resource
+ scenarios and XA-capable in multiple-resource scenarios. One of the
+ significant advantages of JTA is integration with other components of
+ the application stack - such as EJBs and third-party components. </para>
+
+ <para>This can be simply achieved by using the standard Spring JTA
+ transaction manager definition. </para>
+
+ <example>
+ <title>JTA transaction manager definition in Spring</title>
+
+ <programlisting><tx:jta-transaction-manager/></programlisting>
+ </example>
+
+ <para>The use of this transaction manager allows Spring to create JTA
+ transactions (for example, through Spring declarative transaction
+ management) or to enroll in existing transactions, if any. It requires
+ the use of managed datasources, JTA-integrated session factories or
+ container-deployed persistence units and ensures that the underlying
+ database connections, sessions and persistence contexts are managed
+ transparently and shared with other components.</para>
+ </section>
+ </section>
+
+ <section>
+ <title>Messaging integration</title>
+
+ <para></para>
+ </section>
+</chapter>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Conventions.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Conventions.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Conventions.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,153 @@
+<?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 "../Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section>
+ <title>Document Conventions</title>
+ <para>This manual uses several conventions to highlight certain words and phrases and draw attention to specific pieces of information.
+ </para>
+ <para>In PDF and paper editions, this manual uses typefaces drawn from the <ulink url="https://fedorahosted.org/liberation-fonts/">Liberation Fonts</ulink> set. The Liberation Fonts set is also used in HTML editions if the set is installed on your system. If not, alternative but equivalent typefaces are displayed.
+ </para>
+ <section>
+ <title>Typographic Conventions</title>
+ <para>The following <application>typographic</application> conventions are used to call attention to specific words and phrases. These conventions, and the circumstances they apply to, are as follows.
+ </para>
+ <para>System input, including shell commands, file names and paths, and key caps and key-combinations are presented as follows.
+ </para>
+ <blockquote>
+ <para>
+ To see the contents of the file <filename>my_next_bestselling_novel</filename> in your current working directory, enter the <command>cat my_next_bestselling_novel</command> command at the shell prompt and press <keycap>Enter</keycap> to execute the command.
+ </para>
+ </blockquote>
+ <para>The above includes a file name, a shell command and a key cap, all distinguishable thanks to context.
+ </para>
+ <para>Key-combinations can be distinguished from key caps by the symbol connecting each part of a key-combination. For example:
+ </para>
+ <blockquote>
+ <para>
+ Press <keycap>Enter</keycap> to execute the command.
+ </para>
+ <para>
+ Press <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Alt</keycap>
+ <keycap>F1</keycap>
+ </keycombo> to switch to the first virtual terminal. Press <keycombo>
+ <keycap>Ctrl</keycap>
+ <keycap>Alt</keycap>
+ <keycap>F7</keycap>
+ </keycombo> to return to your X-Windows session.
+ </para>
+ </blockquote>
+ <para>The first sentence highlights the particular key cap to press. The second highlights two sets of three key caps, each set pressed simultaneously.
+ </para>
+ <para>If source code is discussed, class names, methods, functions, variable names and returned values mentioned within a paragraph are presented as follows.
+ </para>
+ <blockquote>
+ <para>
+ File-related classes include <classname>filesystem</classname> for file systems, <classname>file</classname> for files, and <classname>dir</classname> for directories. Each class has its own associated set of permissions.
+ </para>
+ </blockquote>
+ <para>Words or phrases encountered on a system, including application names; dialog box text; labeled buttons; check-box and radio button labels; menu titles and sub-menu titles are presented as follows.
+ </para>
+ <blockquote>
+ <para>Choose <menuchoice>
+ <guimenu>System</guimenu>
+ <guimenuitem>Preferences</guimenuitem>
+ <guisubmenu>Mouse</guisubmenu>
+ </menuchoice> from the main menu bar to launch <application>Mouse Preferences</application>. In the <guilabel>Buttons</guilabel> tab, click the <guilabel>Left-handed mouse</guilabel> check box and click <guibutton>Close</guibutton> to switch the primary mouse button from the left to the right (making the mouse suitable for use in the left hand).
+ </para>
+ <para>To insert a special character into a <application>gedit</application> file, choose <menuchoice>
+ <guimenu>Applications</guimenu>
+ <guimenuitem>Accessories</guimenuitem>
+ <guisubmenu>Character Map</guisubmenu>
+ </menuchoice> from the main menu bar. Next, choose <menuchoice>
+ <guimenu>Search</guimenu>
+ <guimenuitem>Find</guimenuitem>
+ </menuchoice> from the <application>Character Map</application> menu bar, type the name of the character in the <guilabel>Search</guilabel> field and click <guibutton>Next</guibutton>. The character you sought will be highlighted in the <guilabel>Character Table</guilabel>. Double-click this highlighted character to place it in the <guilabel>Text to copy</guilabel> field and then click the <guibutton>Copy</guibutton> button. Now switch back to your document and choose <menuchoice>
+ <guimenu>Edit</guimenu>
+ <guimenuitem>Paste</guimenuitem>
+ </menuchoice> from the <application>gedit</application> menu bar.
+ </para>
+ </blockquote>
+ <para>The above text includes application names; system-wide menu names and items; application-specific menu names; and buttons and text found within a GUI interface, all distinguishable by context.
+ </para>
+ <para>Note the shorthand used to indicate traversal through a menu and its sub-menus. This is to avoid the difficult-to-follow 'Select <guimenuitem>Mouse</guimenuitem> from the <guimenu>Preferences</guimenu> sub-menu in the <guimenu>System</guimenu> menu of the main menu bar' approach.
+ </para>
+ <para>Italics denotes text you do not input literally or displayed text that changes depending on circumstance. Replaceable or variable text is presented as follows.
+ </para>
+ <blockquote>
+ <para>To connect to a remote machine using ssh, type <command>ssh <replaceable>username</replaceable>@<replaceable>domain.name</replaceable></command> at a shell prompt. If the remote machine is <filename>example.com</filename> and your username on that machine is john, type <command>ssh john at example.com</command>.
+ </para>
+ <para>
+ The <command>mount -o remount <replaceable>file-system</replaceable></command> command remounts the named file system. For example, to remount the <filename>home</filename> file system, the command is <command>mount -o remount /home</command>.
+ </para>
+ <para>
+ To see the version of a currently installed package, use the <command>rpm -q <replaceable>package</replaceable></command> command. It will return a result as follows: <command>
+ <replaceable>package-version-release</replaceable>
+ </command>.
+ </para>
+ </blockquote>
+ <para>Note the words in bold italics above — username, domain.name, file-system, package, version and release. Each word is a placeholder, either for text you enter when issuing a command or for text displayed by the system.
+ </para>
+ </section>
+ <section>
+ <title>Pull-quote Conventions</title>
+ <para>
+ Two, commonly multi-line, data types are set off visually from the surrounding text.
+ </para>
+ <para>
+ Output sent to a terminal is presented as follows:
+ </para>
+ <screen>
+books Desktop documentation drafts mss photos stuff svn
+books_tests Desktop1 downloads images notes scripts svgs
+</screen>
+ <para>
+ Source-code listings are presented and highlighted as follows:
+ </para>
+ <programlisting language="Java" role="JAVA">
+package org.jboss.book.jca.ex1;
+
+import javax.naming.InitialContext;
+
+public class ExClient
+{
+ public static void main(String args[])
+ throws Exception
+ {
+ InitialContext iniCtx = new InitialContext();
+ Object ref = iniCtx.lookup("EchoBean");
+ EchoHome home = (EchoHome) ref;
+ Echo echo = home.create();
+
+ System.out.println("Created Echo");
+
+ System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
+ }
+
+}
+</programlisting>
+ </section>
+ <section>
+ <title>Notes and Warnings</title>
+ <para>Finally, we use three visual styles to draw attention to information that might otherwise be overlooked.
+ </para>
+ <warning>
+ <title>Warning</title>
+ <para>A Warning should not be ignored. Ignoring warnings will most likely cause data loss.
+ </para>
+ </warning>
+ <important>
+ <title>Important</title>
+ <para>Important boxes detail things that are easily missed: configuration changes that only apply to the current session, or services that need restarting before an update will apply. Ignoring Important boxes won't cause data loss but may cause irritation and frustration.
+ </para>
+ </important>
+ <note>
+ <title>Note</title>
+ <para>A note is a tip or shortcut or alternative approach to the task at hand. Ignoring a note should have no negative consequences, but you might miss out on a trick that makes your life easier.
+ </para>
+ </note>
+ </section>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Feedback.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Feedback.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Feedback.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,14 @@
+<?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 "../Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+
+]>
+<section>
+ <title id="section-Feedback_">Your feedback is vital</title>
+ <para>If you believe the JBoss Documentation Guide can be improved in any way, we want to hear from you! </para>
+ <para>Please submit a documentation issue using the JIRA tracking system against the project <application>&PRODUCT;</application>
+ and the component <citetitle>&BOOKID;</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/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Legal_Notice.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Legal_Notice.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/Legal_Notice.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,10 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE legalnotice PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "../Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<legalnotice>
+ <para>
+ Copyright.
+ </para>
+</legalnotice>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Acknowledgements.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Acknowledgements.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Acknowledgements.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,12 @@
+<?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 "../JBoss_Documentation_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section>
+ <title>Acknowledgements</title>
+ <para>Many thanks to the following Red Hat Engineering Content Services contributors for adding valuable content to this reference.</para>
+ <para>Darrin Mison contributed the base technical information for <xref linkend="iim-Interop_Install_Maven"/>, and <xref linkend="pwj-Publish_With_jDocBook"/>.</para>
+ <para>Sean Rogers contributed heavily to <xref linkend="sg-Structure_Guidelines"/> with reworked and detailed XML element guidelines from the ECS wiki. These guidelines were originally written by David O'Brien.</para>
+ <para>Many thanks to Ruediger Landmann and the Publican Team for allowing us to directly include <xref linkend="sect-Users_Guide-Disallowed_elements_and_attributes-Disallowed_attributes"/>, <xref linkend="sect-Users_Guide-Disallowed_elements_and_attributes-Disallowed_elements"/>, and <xref linkend="sge-Structure_Guidlines_Entities"/> from the Publican User Guide. </para>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Share_and_Share_Alike.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Share_and_Share_Alike.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/fallback_content/section-Share_and_Share_Alike.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,8 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!-- This document was created with Syntext Serna Free. --><!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "../JBoss_Documentation_Guide.ent">
+%BOOK_ENTITIES;]>
+<section id="sasa-Share_and_Share_Alike">
+ <title>License</title>
+ <para>This document is licensed under the Creative Commons <ulink url="http://creativecommons.org/about/license/">CC-BY-SA license</ulink>. You are welcome to utilize any content contained in this user guide according to the terms of this license. </para>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_A.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_A.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_A.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,55 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="Obtaining_Spring-section">
+ <title>Obtaining Spring</title>
+
+ <para>You can obtain a certified version of the Spring Framework in a few
+ different ways:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Downloading it from the <ulink url="http://www.springsource.org/download">Spring Framework</ulink> site;</para>
+ </listitem>
+
+ <listitem>
+ <para>Downloading it from a public repository (Maven or Ivy).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The following versions of the Spring Framework are certified:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>2.5.6.SEC01</para>
+ </listitem>
+
+ <listitem>
+ <para>3.0.2.RELEASE</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Instructions on how to download and to set up repositories for using
+ the community versions of Spring can be found in the <ulink url="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/overview.html#dependency-management"> Spring Reference documentation </ulink>. While the instructions above have been written taking Spring 3 into consideration, they are applicable to version 2.5.6.SEC01 as well.</para>
+
+ <simplesect>
+ <title>How to find the Spring JARs in a downloaded distribution</title>
+
+ <para>The downloadable distributions of the Spring Framework may or may
+ not include dependencies required by Spring to integrate with third party
+ frameworks. A significant portion of these dependencies are already
+ provided by JBoss. The scope of this document encompasses only the Spring
+ JARs and a few special dependencies. The Spring JARs can be found in the
+ <filename>dist/</filename> folder of the downloaded distribution for both the 2.5.6.SEC01 and
+ 3.0.2.RELEASE distributions.</para>
+
+ <para>Other dependencies potentially required by the Spring Framework and
+ provided by the Spring distribution are the AOP Alliance APIs and AspectJ
+ (if using AspectJ in your applications). In general, the AOP Alliance APIs
+ are required even by transaction management scenarios, so it is a good
+ idea to include them as well.</para>
+ </simplesect>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_B.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_B.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_B.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,29 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="sect-JBoss_Sample_Project-Test_Section_B">
+ <title>Packaging Options</title>
+
+ <para>When using the Spring Framework in an application, one problem that is
+ often encountered is how to package and distribute the framework. The main
+ options are:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Installing the framework libraries as shared libraries on the
+ platform,</para>
+ </listitem>
+
+ <listitem>
+ <para>Packaging the framework libraries together with the
+ application.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>In the following chapters, we will discuss both of these options,
+ explaining how they can be implemented, as well as their relative advantages
+ and disadvantages. </para>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_C.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_C.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_C.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,55 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="Best_Practice_1">
+ <title>Obtaining Spring</title>
+
+ <para>You can obtain a certified version of the Spring Framework in a few
+ different ways:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Downloading it from the <ulink url="http://www.springsource.org/download">Spring Framework</ulink> site;</para>
+ </listitem>
+
+ <listitem>
+ <para>Downloading it from a public repository (Maven or Ivy).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The following versions of the Spring Framework are certified:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>2.5.6.SEC01</para>
+ </listitem>
+
+ <listitem>
+ <para>3.0.2.RELEASE</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Instructions on how to download and to set up repositories for using
+ the community versions of Spring can be found in the <ulink url="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/overview.html#dependency-management"> Spring Reference documentation </ulink>. While the instructions above have been written taking Spring 3 into consideration, they are applicable to version 2.5.6.SEC01 as well.</para>
+
+ <simplesect>
+ <title>How to find the Spring JARs in a downloaded distribution</title>
+
+ <para>The downloadable distributions of the Spring Framework may or may
+ not include dependencies required by Spring to integrate with third party
+ frameworks. A significant portion of these dependencies are already
+ provided by JBoss. The scope of this document encompasses only the Spring
+ JARs and a few special dependencies. The Spring JARs can be found in the
+ <filename>dist/</filename> folder of the downloaded distribution for both the 2.5.6.SEC01 and
+ 3.0.2.RELEASE distributions.</para>
+
+ <para>Other dependencies potentially required by the Spring Framework and
+ provided by the Spring distribution are the AOP Alliance APIs and AspectJ
+ (if using AspectJ in your applications). In general, the AOP Alliance APIs
+ are required even by transaction management scenarios, so it is a good
+ idea to include them as well.</para>
+ </simplesect>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_D.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_D.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/en-US/section-Section_D.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,55 @@
+<?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 "Spring_Developer_Guide.ent">
+%BOOK_ENTITIES;
+]>
+<section id="Best_Practice_2">
+ <title>Obtaining Spring</title>
+
+ <para>You can obtain a certified version of the Spring Framework in a few
+ different ways:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Downloading it from the <ulink url="http://www.springsource.org/download">Spring Framework</ulink> site;</para>
+ </listitem>
+
+ <listitem>
+ <para>Downloading it from a public repository (Maven or Ivy).</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The following versions of the Spring Framework are certified:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>2.5.6.SEC01</para>
+ </listitem>
+
+ <listitem>
+ <para>3.0.2.RELEASE</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>Instructions on how to download and to set up repositories for using
+ the community versions of Spring can be found in the <ulink url="http://static.springsource.org/spring/docs/3.0.x/spring-framework-reference/html/overview.html#dependency-management"> Spring Reference documentation </ulink>. While the instructions above have been written taking Spring 3 into consideration, they are applicable to version 2.5.6.SEC01 as well.</para>
+
+ <simplesect>
+ <title>How to find the Spring JARs in a downloaded distribution</title>
+
+ <para>The downloadable distributions of the Spring Framework may or may
+ not include dependencies required by Spring to integrate with third party
+ frameworks. A significant portion of these dependencies are already
+ provided by JBoss. The scope of this document encompasses only the Spring
+ JARs and a few special dependencies. The Spring JARs can be found in the
+ <filename>dist/</filename> folder of the downloaded distribution for both the 2.5.6.SEC01 and
+ 3.0.2.RELEASE distributions.</para>
+
+ <para>Other dependencies potentially required by the Spring Framework and
+ provided by the Spring distribution are the AOP Alliance APIs and AspectJ
+ (if using AspectJ in your applications). In general, the AOP Alliance APIs
+ are required even by transaction management scenarios, so it is a good
+ idea to include them as well.</para>
+ </simplesect>
+</section>
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/pom.xml
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/pom.xml (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/pom.xml 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,188 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>org.jboss.project</groupId>
+ <artifactId>${docname}-${translation}</artifactId>
+ <version>1.0</version>
+ <packaging>jdocbook</packaging>
+ <name>${bookname}-(${translation})</name>
+
+ <properties>
+ <translation>en-US</translation>
+ <docname>Spring_Developer_Guide</docname>
+ <bookname>Spring Developer's Guide</bookname>
+ </properties>
+
+ <profiles>
+
+ <!-- mvn compile -->
+ <profile>
+ <id>all</id>
+ <activation>
+ <activeByDefault>true</activeByDefault>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.2.0</version>
+ <extensions>true</extensions>
+ <configuration>
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource>
+ <finalName>${docname}.pdf</finalName>
+ </format>
+ <format>
+ <formatName>html</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ <format>
+ <formatName>html_single</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ </formats>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+
+ <!-- mvn compile -Phtml -->
+ <profile>
+ <id>html</id>
+ <activation>
+ <activeByDefault>false</activeByDefault>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.2.0</version>
+ <extensions>true</extensions>
+ <configuration>
+ <formats>
+ <format>
+ <formatName>html</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ </formats>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+
+ <!-- mvn compile -Phtml-single -->
+ <profile>
+ <id>html-single</id>
+ <activation>
+ <activeByDefault>false</activeByDefault>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.2.0</version>
+ <extensions>true</extensions>
+ <configuration>
+ <formats>
+ <format>
+ <formatName>html_single</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ </formats>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+
+ <!-- mvn compile -Ppdf -->
+ <profile>
+ <id>pdf</id>
+ <activation>
+ <activeByDefault>false</activeByDefault>
+ </activation>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.2.0</version>
+ <extensions>true</extensions>
+ <configuration>
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <stylesheetResource>classpath:/xslt/org/jboss/pdf.xsl</stylesheetResource>
+ <finalName>${docname}.pdf</finalName>
+ </format>
+ </formats>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+ </profiles>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.2.0</version>
+ <extensions>true</extensions>
+ <dependencies>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-docbook-xslt</artifactId>
+ <version>1.1.0</version>
+ </dependency>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-jdocbook-style</artifactId>
+ <version>1.1.0</version>
+ <type>jdocbook-style</type>
+ </dependency>
+ </dependencies>
+ <configuration>
+ <sourceDocumentName>${docname}.xml</sourceDocumentName>
+ <sourceDirectory>.</sourceDirectory>
+ <imageResource>
+ <directory>${translation}</directory>
+ <includes>
+ <include>images/*</include>
+ </includes>
+ </imageResource>
+ <options>
+ <xincludeSupported>true</xincludeSupported>
+ <xmlTransformerType>saxon</xmlTransformerType>
+ <!-- needed for uri-resolvers; can be ommitted if using 'current' uri scheme -->
+ <!-- could also locate the docbook dependency and inspect its version -->
+ <docbookVersion>1.72.0</docbookVersion>
+ <transformerParameters>
+ <property>
+ <name>javax.xml.parsers.DocumentBuilderFactory</name>
+ <value>org.apache.xerces.jaxp.DocumentBuilderFactoryImpl</value>
+ </property>
+ <property>
+ <name>javax.xml.parsers.SAXParserFactory</name>
+ <value>org.apache.xerces.jaxp.SAXParserFactoryImpl</value>
+ </property>
+ </transformerParameters>
+ </options>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+</project>
+
Added: projects/docs/enterprise/WFK/Spring_Developer_Guide/publican.cfg
===================================================================
--- projects/docs/enterprise/WFK/Spring_Developer_Guide/publican.cfg (rev 0)
+++ projects/docs/enterprise/WFK/Spring_Developer_Guide/publican.cfg 2011-02-16 07:03:54 UTC (rev 110685)
@@ -0,0 +1,9 @@
+# Config::Simple 4.59
+# Wed Nov 11 16:16:32 2009
+
+debug: 1
+xml_lang: en-US
+
+type: Book
+brand: JBoss
+
More information about the jboss-cvs-commits
mailing list