12:47 a.m.
Author: irooskov(a)redhat.com
Date: 2010-03-09 18:47:35 -0500 (Tue, 09 Mar 2010)
New Revision: 20718
Added:
trunk/documentation/guides/MigrationGuide/en-US/
trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml
trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml
trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent
trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml
trunk/documentation/guides/MigrationGuide/en-US/Preface.xml
trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml
trunk/documentation/guides/MigrationGuide/en-US/images/
trunk/documentation/guides/MigrationGuide/en-US/images/jdbs2.png
trunk/documentation/guides/MigrationGuide/en-US/images/jdbs4.png
trunk/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png
trunk/documentation/guides/MigrationGuide/en-US/introduction.xml
trunk/documentation/guides/MigrationGuide/en-US/issues.xml
trunk/documentation/guides/MigrationGuide/en-US/master.xml
trunk/documentation/guides/MigrationGuide/en-US/migration.xml
trunk/documentation/guides/MigrationGuide/publican.cfg
Removed:
trunk/documentation/guides/MigrationGuide/en/
Modified:
trunk/documentation/guides/MigrationGuide/pom.xml
Log:
updated book to build with publican and maven
Added: trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Author_Group.xml 2010-03-09 23:47:35
UTC (rev 20718)
@@ -0,0 +1,4 @@
+<?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" [
+]>
+<authorgroup><author><firstname>JBoss Tools
Team</firstname></author></authorgroup>
Added: trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Book_Info.xml 2010-03-09 23:47:35 UTC
(rev 20718)
@@ -0,0 +1,4 @@
+<?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" [
+]>
+<bookinfo><title>Migration Guide</title><subtitle>JBoss Developer
Studio 2.1 to 3.0.</subtitle><productname>JBoss Developer
Studio</productname><productnumber>3.0</productnumber><edition>1.0</edition><pubsnumber>0</pubsnumber><abstract><para>The
JBoss Developer Studio Migration Guide explains how to migrate from the previous version
of the JBoss Developer Studio to the latest
version.</para></abstract><corpauthor><inlinemediaobject><imageobject><imagedata
fileref="Common_Content/images/title_logo.svg"
format="SVG"></imagedata></imageobject></inlinemediaobject></corpauthor><xi:include
href="Common_Content/Legal_Notice.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
href="Author_Group.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
Added: trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent 2010-03-09
23:47:35 UTC (rev 20718)
@@ -0,0 +1,4 @@
+<!ENTITY PRODUCT "JBoss">
+<!ENTITY BOOKID "Migration_Guide">
+<!ENTITY YEAR "2010">
+<!ENTITY HOLDER "Red Hat">
Added: trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml 2010-03-09
23:47:35 UTC (rev 20718)
@@ -0,0 +1,11 @@
+<?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" [
+]>
+<book>
+<xi:include href="Book_Info.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="Preface.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="introduction.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="migration.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="issues.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+<xi:include href="Revision_History.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include>
+</book>
Added: trunk/documentation/guides/MigrationGuide/en-US/Preface.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Preface.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Preface.xml 2010-03-09 23:47:35 UTC
(rev 20718)
@@ -0,0 +1,4 @@
+<?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" [
+]>
+<preface><title>Preface</title><xi:include
href="Common_Content/Conventions.xml"
xmlns:xi="http://www.w3.org/2001/XInclude"></xi:include&g...
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:include&g...
Added: trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/Revision_History.xml 2010-03-09
23:47:35 UTC (rev 20718)
@@ -0,0 +1,4 @@
+<?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" [
+]>
+<appendix><title>Revision
History</title><simpara><revhistory><revision><revnumber>0</revnumber><date>Fri
Nov 20
2009</date><author><firstname>Isaac</firstname><surname>Rooskov</surname><email>irooskov@redhat.com</email></author><revdescription><simplelist><member>Initial
creation of book by
publican</member></simplelist></revdescription></revision></revhistory></simpara></appendix>
Added: trunk/documentation/guides/MigrationGuide/en-US/images/jdbs2.png
===================================================================
(Binary files differ)
Property changes on: trunk/documentation/guides/MigrationGuide/en-US/images/jdbs2.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/MigrationGuide/en-US/images/jdbs4.png
===================================================================
(Binary files differ)
Property changes on: trunk/documentation/guides/MigrationGuide/en-US/images/jdbs4.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png
===================================================================
(Binary files differ)
Property changes on:
trunk/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added: trunk/documentation/guides/MigrationGuide/en-US/introduction.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/introduction.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/introduction.xml 2010-03-09 23:47:35
UTC (rev 20718)
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="introduction" xreflabel="introduction">
+ <?dbhtml filename="introduction.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>JBDS</keyword>
+ <keyword>Exadel Studio Pro</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Introduction </title>
+ <para>This document is intended to help you to easily migrate from 2.1 to 3.0.0
+ <property>JBoss Developer Studio</property>.
+ It also describes some popular issues that can appear while the process of migration,
+ as well as the methods of their solving. </para>
+
+
+ <section>
+ <title>Other relevant resources on the topic</title>
+ <para>All JBoss Developer Studio release documentation you can find at <ulink
url="http://www.redhat.com/docs/en-US/JBoss_Developer_Studio/"&...
in the corresponding release directory.</para>
+ <para>For more information about JBoss Developer Studio please visit
+ <ulink
url="http://www.jboss.com/products/devstudio/">http://www.jb...
+ <para>If your problem is not described in the guide or you have questions or
suggestions concerned both the documentation and studio behavior, you are welcome at
<ulink
url="http://community.jboss.org/en/jbossdevstudio?view=discussions&q...
Users forum</ulink>.
+ </para>
+ </section>
+</chapter>
Property changes on: trunk/documentation/guides/MigrationGuide/en-US/introduction.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: trunk/documentation/guides/MigrationGuide/en-US/issues.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/issues.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/issues.xml 2010-03-09 23:47:35 UTC
(rev 20718)
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="issues" xreflabel="issues">
+ <?dbhtml filename="introduction.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>JBDS</keyword>
+ <keyword>Exadel Studio Pro</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Possible issues</title>
+ <para>In this chapter you will find a list of most popular
+ issues that can appear while the process of migration.
+ </para>
+
+
+ <section>
+ <title>Visual Editor starts with "Missing Natures" message
dialog</title>
+ <para>While opening existing projects or creating new ones
+ with some standard eclipse wizards this message can appear:</para>
+ <figure>
+ <title>"Missing Natures" message</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jbds4.png" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>This message shows that some functionality of Visual Editor may not
work if a project
+ doesn't have org.jboss.tools.jsf.jsfnature or
org.jboss.tools.jst.web.kb.kbnature
+ in .project configuration. To fix this problem and turn off the message box
execute the following steps:</para>
+ <itemizedlist>
+ <listitem><para>Right click the project in Package
Explorer.</para></listitem>
+ <listitem><para>Select <property>Configure -> Add JSF
Capabilities</property> from the context menu.</para></listitem>
+ <listitem><para>Configure your project using Add JSF Capabilities
wizard and press <property>Finish</property></para></listitem>
+ </itemizedlist>
+ </section>
+
+
+ <section>
+ <title>Visual Editor doesn't start and "XPCOM error
-2147467259" appears</title>
+ <para>This error shows that you have problems with your buildin XULRunner
plugin.To resolve the issue,please: </para>
+ <itemizedlist>
+ <listitem><para>Open <property>Help -> About JBoss
Developer Studio-> Installation Details... ->
Configuration</property></para></listitem>
+ <listitem><para>find org.eclipse.swt.browser.XULRunnerPath
and open this path in terminal</para></listitem>
+ <listitem><para>try xulrunner.exe -version or ./xulrunner
-version command and you will see what is needed for XULRunner to
work</para></listitem>
+ </itemizedlist>
+ </section>
+ <section>
+ <title>Problems with <emphasis>not "JBDS"</emphasis>
plugins</title>
+ <para>Some additional plugins that are not supplied by JBDS and work on
JBDS 2.X may not work on 3.0.0.GA</para>
+ <itemizedlist>
+ <listitem><para>To solve the problem check whether the plugin is
compatible with Eclipse 3.5.</para></listitem>
+ <listitem><para>But because such pugins are not supported by
JBDS, we can not guarantee its proper work.</para></listitem>
+ </itemizedlist>
+ </section>
+
+</chapter>
Added: trunk/documentation/guides/MigrationGuide/en-US/master.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/master.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/master.xml 2010-03-09 23:47:35 UTC
(rev 20718)
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+"http://www.docbook.org/xml/4.3/docbookx.dtd"
+
+[<!ENTITY introduction SYSTEM "introduction.xml">
+<!ENTITY migration SYSTEM "migration.xml">
+<!ENTITY issues SYSTEM "issues.xml">
+<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html">
+
+]>
+
+<book>
+ <bookinfo>
+ <title>JBoss Developer Studio 2.1 to 3.0 Migration Guide</title>
+
+
+ <copyright>
+ <year>2010</year>
+ <holder>JBoss by Red Hat</holder>
+ </copyright>
+ <releaseinfo>
+Version: 3.0.0.GA
+</releaseinfo>
+ </bookinfo>
+
+ <toc/>
+&introduction;
+&migration;
+&issues;
+</book>
Property changes on: trunk/documentation/guides/MigrationGuide/en-US/master.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: trunk/documentation/guides/MigrationGuide/en-US/migration.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/en-US/migration.xml
(rev 0)
+++ trunk/documentation/guides/MigrationGuide/en-US/migration.xml 2010-03-09 23:47:35 UTC
(rev 20718)
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter id="jsf_struts" xreflabel="jsf_struts">
+ <?dbhtml filename="jsf_struts.html"?>
+ <chapterinfo>
+ <keywordset>
+ <keyword>JBoss Developer Studio</keyword>
+ <keyword>JBDS</keyword>
+ <keyword>Exadel Studio Pro</keyword>
+ <keyword>Migration</keyword>
+ </keywordset>
+ </chapterinfo>
+
+ <title>Migration Process</title>
+ <para>In this chapter you can find concise description of JBoss Developer
Studio migration from
+ 2.1.0 to 3.0.0 version.</para>
+ <section id="migration">
+ <title>How to migrate from 2.1 to 3.0.0 JBoss Developer
Studio</title>
+ <para></para>
+ <para>To migrate from 2.1 to 3.0.0 you have to install a fresh JBDS 3.0.0
and go through all the steps of
+ installation process that is fully described in
+ <ulink url="gsglink">Getting Started with JBoss Developer
Studio</ulink> guide.</para>
+ <figure>
+ <title>Process of JBDS 3.0.0 installation </title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jbds2.png" />
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>Now you can not update your JBDS 2.X to 3.0.0 using update site
(https://devstudio.jboss.com/updates/3.0/ ), as it was available in previous
versions:</para>
+ <figure>
+ <title>Installation from the update site</title>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/migration-guide-step-1.png"
/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ <para>The reason is that JBDS 3.0 uses Eclipse 3.5, whereas JBDS 2.x uses
Eclipse 3.4.
+ Because of this platform change, a full installation is required to migrate.
</para>
+ <para>When the installation process is complete you can point your JBDS
3.0.0 at your old workspace directory and continue working with your projects created
using previous
+ JBDS/Tools versions, or create a new one and import old projects into the new
workspace.
+ </para>
+
+ <note>
+ <title>Note:</title>
+ <para>In JBDS 3.0.0 Linux users no longer need to install the library
libstdc+.so.5 on their mashines.
+ Now this library is not required and can be removed from the system.
+ </para>
+ </note>
+ </section>
+
+
+</chapter>
Modified: trunk/documentation/guides/MigrationGuide/pom.xml
===================================================================
--- trunk/documentation/guides/MigrationGuide/pom.xml 2010-03-09 21:06:09 UTC (rev 20717)
+++ trunk/documentation/guides/MigrationGuide/pom.xml 2010-03-09 23:47:35 UTC (rev 20718)
@@ -89,9 +89,9 @@
</dependencies>
<configuration>
<sourceDocumentName>${master}</sourceDocumentName>
- <sourceDirectory>${pom.basedir}/en</sourceDirectory>
+ <sourceDirectory>${pom.basedir}/en-US</sourceDirectory>
<imageResource>
- <directory>${pom.basedir}/en</directory>
+ <directory>${pom.basedir}/en-US</directory>
<includes>
<include>images/**/*</include>
</includes>
Added: trunk/documentation/guides/MigrationGuide/publican.cfg
===================================================================
--- trunk/documentation/guides/MigrationGuide/publican.cfg (rev
0)
+++ trunk/documentation/guides/MigrationGuide/publican.cfg 2010-03-09 23:47:35 UTC (rev
20718)
@@ -0,0 +1,7 @@
+# Config::Simple 4.59
+# Fri Nov 20 13:19:45 2009
+
+xml_lang: en-US
+type: Book
+brand: JBoss
+