Author: ochikvina
Date: 2010-03-04 08:23:05 -0500 (Thu, 04 Mar 2010)
New Revision: 20657
Added:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds2.png
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds4.png
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs2.png
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs4.png
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/migration-guide-step-1.png
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/introduction.xml
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/issues.xml
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/migration.xml
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml
Log:
<html><head><meta name="qrichtext" content="1"
/></head><body style="font-size:9pt;font-family:Sans Serif">
<
p>https://jira.jboss.org/jira/browse/JBDS-1107 -Updated docs source files here with
the ones for JBDS 3.0.0 GA release. </p>
<p></p>
</body></html>
Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds2.png
___________________________________________________________________
Name: svn:executable
+ *
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds4.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jbds4.png
___________________________________________________________________
Name: svn:executable
+ *
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs2.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs2.png
___________________________________________________________________
Name: svn:executable
+ *
Name: svn:mime-type
+ application/octet-stream
Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs4.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/jdbs4.png
___________________________________________________________________
Name: svn:executable
+ *
Name: svn:mime-type
+ application/octet-stream
Added:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/images/migration-guide-step-1.png
===================================================================
(Binary files differ)
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/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/modules/introduction.xml
===================================================================
---
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/introduction.xml
(rev 0)
+++
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/introduction.xml 2010-03-04
13:23:05 UTC (rev 20657)
@@ -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/modules/introduction.xml
___________________________________________________________________
Name: svn:executable
+ *
Added:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/issues.xml
===================================================================
--- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/issues.xml
(rev 0)
+++
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/issues.xml 2010-03-04
13:23:05 UTC (rev 20657)
@@ -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/modules/issues.xml
___________________________________________________________________
Name: svn:executable
+ *
Added:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/migration.xml
===================================================================
---
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/migration.xml
(rev 0)
+++
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/en/modules/migration.xml 2010-03-04
13:23:05 UTC (rev 20657)
@@ -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/modules/migration.xml
___________________________________________________________________
Name: svn:executable
+ *
Added: branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml
===================================================================
--- branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml
(rev 0)
+++ branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml 2010-03-04
13:23:05 UTC (rev 20657)
@@ -0,0 +1,162 @@
+<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.tools</groupId>
+ <artifactId>exadel-migration-guide${translation}</artifactId>
+ <version>1.0-SNAPSHOT</version>
+ <packaging>jdocbook</packaging>
+ <name>Exadel_2.1_to_3.0_Migration_Guide</name>
+
+ <profiles>
+ <profile>
+ <id>release</id>
+ <properties>
+ <master>master_output.xml</master>
+ <xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single-release.xsl</xsl-single>
+ <xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml-release.xsl</xsl-chunked>
+ <xsl-pdf>classpath:/xslt/com/jboss/tools/pdf.xsl</xsl-pdf>
+ </properties>
+ </profile>
+ <profile>
+ <id>releaseTest</id>
+ <properties>
+ <master>master_output.xml</master>
+ <xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single-release-nomarker.xsl</xsl-single>
+ <xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml-release-nomarker.xsl</xsl-chunked>
+ <xsl-pdf>classpath:/xslt/com/jboss/tools/pdf.xsl</xsl-pdf>
+ </properties>
+ </profile>
+ <profile>
+ <id>releaseJBDS</id>
+ <properties>
+ <master>master.xml</master>
+ <xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single-release.xsl</xsl-single>
+ <xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml-release.xsl</xsl-chunked>
+ <xsl-pdf>classpath:/xslt/com/jboss/tools/pdf.xsl</xsl-pdf>
+ <cssdir>../../../documentation/jbosstools-jdocbook-style/src/main/com/css/</cssdir>
+ </properties>
+ </profile>
+
+ <profile>
+ <id>diffmk</id>
+ <properties>
+ <master>master_output.xml</master>
+ <xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single-diff.xsl</xsl-single>
+ <xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml-diff.xsl</xsl-chunked>
+ <xsl-pdf>classpath:/xslt/com/jboss/tools/pdf-diff.xsl</xsl-pdf>
+ </properties>
+ </profile>
+ </profiles>
+
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.jboss.maven.plugins</groupId>
+ <artifactId>maven-jdocbook-plugin</artifactId>
+ <version>2.1.0-200803311251UTC-MPJDOCBOOK-8</version>
+ <extensions>true</extensions>
+ <dependencies>
+ <dependency>
+ <groupId>com.jboss</groupId>
+ <artifactId>jbossent-docbook-xslt</artifactId>
+ <version>1.0.0</version>
+ </dependency>
+ <dependency>
+ <groupId>com.jboss</groupId>
+ <artifactId>jbossent-jdocbook-style</artifactId>
+ <version>1.0.0</version>
+ <type>jdocbook-style</type>
+ </dependency>
+ <dependency>
+ <groupId>org.jboss</groupId>
+ <artifactId>jbossorg-jdocbook-style</artifactId>
+ <version>1.1.0</version>
+ <type>jdocbook-style</type>
+ </dependency>
+ <dependency>
+ <groupId>org.jboss.tools</groupId>
+ <artifactId>jbosstools-docbook-xslt</artifactId>
+ <version>1.0.0-SNAPSHOT</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.xmlgraphics</groupId>
+ <artifactId>fop</artifactId>
+ <version>0.95</version>
+ </dependency>
+ </dependencies>
+ <configuration>
+ <sourceDocumentName>${master}</sourceDocumentName>
+ <sourceDirectory>${pom.basedir}/en</sourceDirectory>
+ <imageResource>
+ <directory>${pom.basedir}/en</directory>
+ <includes>
+ <include>images/**/*</include>
+ </includes>
+ </imageResource>
+ <cssResource>
+ <directory>${pom.basedir}/${cssdir}</directory>
+ </cssResource>
+
+ <formats>
+ <format>
+ <formatName>pdf</formatName>
+ <stylesheetResource>${xsl-pdf}</stylesheetResource>
+ <finalName>${pom.name}.pdf</finalName>
+ </format>
+ <format>
+ <formatName>html</formatName>
+ <stylesheetResource>${xsl-chunked}</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ <format>
+ <formatName>html_single</formatName>
+ <stylesheetResource>${xsl-single}</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ <format>
+ <formatName>eclipse</formatName>
+ <stylesheetResource>classpath:/xslt/com/jboss/tools/eclipse.xsl</stylesheetResource>
+ <finalName>index.html</finalName>
+ </format>
+ </formats>
+ <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>
+ </options>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
+
+ <distributionManagement>
+ <repository>
+ <!-- Copy the dist to the local checkout of the JBoss maven2 repo
${maven.repository.root} -->
+ <!-- It is anticipated that ${maven.repository.root} be set in user's
settings.xml -->
+ <!-- todo : replace this with direct svn access once the svnkit providers are
available -->
+ <id>repository.jboss.org</id>
+ <url>file://${maven.repository.root}</url>
+ </repository>
+ <snapshotRepository>
+ <id>snapshots.jboss.org</id>
+ <name>JBoss Snapshot Repository</name>
+ <
url>dav:https://snapshots.jboss.org/maven2</url>
+ </snapshotRepository>
+ </distributionManagement>
+
+ <properties>
+ <xsl-single>classpath:/xslt/com/jboss/tools/xhtml-single.xsl</xsl-single>
+ <xsl-chunked>classpath:/xslt/com/jboss/tools/xhtml.xsl</xsl-chunked>
+ <xsl-pdf>classpath:/xslt/com/jboss/tools/pdf.xsl</xsl-pdf>
+ <stylesdir>../../../documentation/jbosstools-docbook-xslt/src/main/resources/</stylesdir>
+ <cssdir>../../../documentation/jbosstools-jdocbook-style/src/main/com/css/</cssdir>
+ <master>master.xml</master>
+ <translation>en-US</translation>
+ </properties>
+
+</project>
Property changes on:
branches/jbosstools-3.1.x/documentation/guides/MigrationGuide/pom.xml
___________________________________________________________________
Name: svn:executable
+ *