Author: irooskov(a)redhat.com Date: 2010-03-11 18:58:46 -0500 (Thu, 11 Mar 2010) New Revision: 20773 Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Author_Group.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Book_Info.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Preface.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Revision_History.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds2.png branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds4.png branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs2.png branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs4.png branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/introduction.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/issues.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/master.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/migration.xml branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/publican.cfg Removed: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/ Modified: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml Log: modified book to build with publican Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Author_Group.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Author_Group.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Author_Group.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Book_Info.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Book_Info.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Book_Info.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.ent 2010-03-11 23:58:46 UTC (rev 20773) @@ -0,0 +1,4 @@ +<!ENTITY PRODUCT "JBoss"> +<!ENTITY BOOKID "Migration_Guide"> +<!ENTITY YEAR "2010"> +<!ENTITY HOLDER "Red Hat"> Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Migration_Guide.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Preface.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Preface.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Preface.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Revision_History.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Revision_History.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/Revision_History.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds2.png =================================================================== (Binary files differ) Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds2.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds4.png =================================================================== (Binary files differ) Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jbds4.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs2.png =================================================================== (Binary files differ) Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs2.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs4.png =================================================================== (Binary files differ) Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/jdbs4.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png =================================================================== (Binary files differ) Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/images/migration-guide-step-1.png ___________________________________________________________________ Name: svn:executable + * Name: svn:mime-type + application/octet-stream Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/introduction.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/introduction.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/introduction.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/introduction.xml ___________________________________________________________________ Name: svn:executable + * Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/issues.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/issues.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/issues.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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> Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/issues.xml ___________________________________________________________________ Name: svn:executable + * Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/master.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/master.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/master.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/master.xml ___________________________________________________________________ Name: svn:executable + * Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/migration.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/migration.xml (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/migration.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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> Property changes on: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en-US/migration.xml ___________________________________________________________________ Name: svn:executable + * Modified: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml 2010-03-11 23:57:54 UTC (rev 20772) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml 2010-03-11 23:58:46 UTC (rev 20773) @@ -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: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/publican.cfg =================================================================== --- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/publican.cfg (rev 0) +++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/publican.cfg 2010-03-11 23:58:46 UTC (rev 20773) @@ -0,0 +1,7 @@ +# Config::Simple 4.59 +# Fri Nov 20 13:19:45 2009 + +xml_lang: en-US +type: Book +brand: JBoss +