Author: smukhina
Date: 2010-02-04 10:53:51 -0500 (Thu, 04 Feb 2010)
New Revision: 20131
Modified:
trunk/hibernatetools/docs/reference/en/modules/setup.xml
Log:
JBDS-1083 -Hibernate guide update - wrote Eclipse IDE chapter, fixed current JBossTools,
Hibernate Tools, Eclipse versions.
Modified: trunk/hibernatetools/docs/reference/en/modules/setup.xml
===================================================================
--- trunk/hibernatetools/docs/reference/en/modules/setup.xml 2010-02-04 15:38:58 UTC (rev
20130)
+++ trunk/hibernatetools/docs/reference/en/modules/setup.xml 2010-02-04 15:53:51 UTC (rev
20131)
@@ -1,81 +1,108 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<chapter id="setup">
<title>Download and install Hibernate Tools</title>
-
- <para><property>Hibernate Tools</property> can be used
"standalone" via Ant
- 1.6.x or fully integrated into an Eclipse + WTP based IDE, such as
<property>JBDS/JBoss
- Tools</property>, or a default Eclipse + WTP installation. The following
sections describe the
- install steps in these environments.</para>
-
+ <para><property>Hibernate Tools</property> can be used
"standalone" via Ant 1.6.x or
+ fully integrated into an Eclipse + WTP based IDE, such as <property>JBDS/JBoss
Tools</property>,
+ or a default Eclipse + WTP installation. The following sections describe the install
steps in
+ these environments.</para>
<note>
<title>Note:</title>
- <para>The <property>Hibernate Tools 3.2.4.GA</property> (the
current release version) requires
- Eclipse Ganymede 3.4.2.</para>
+ <para>The <property>Hibernate Tools 3.3.0</property> (the current
release version) requires
+ Eclipse Galileo 3.5.</para>
</note>
-
<section>
<title>JBoss Tools</title>
-
- <para><property>JBoss Tools 3.0.0.GA</property> (the latest
release) includes
- <property>Hibernate Tools 3.2.4.GA</property> and thus nothing is
required besides <ulink
-
url="http://jboss.org/tools/download/stable/3_0_0_GA.html">d...
and <ulink
- url="&gsglink;#JBossToolsInstall">installing JBoss
Tools</ulink>. If you need to update
- to a newer version of the <property>Hibernate Tools</property> just
follow the instructions in
- the Eclipse IDE section.</para>
+ <para><property>JBoss Tools 3.1.0</property> (the latest release)
includes <property>Hibernate
+ Tools 3.3.0</property> and thus nothing is required besides
<property>downloading</property>
+ and <property>installing JBoss Tools</property>. If you need to update
to a newer version of
+ the <property>Hibernate Tools</property> just follow the instructions
in the Eclipse IDE
+ section.</para>
</section>
-
<section>
<title>Eclipse IDE</title>
-
- <para>To install the <property>Hibernate Tools</property> into any
<property>Eclipse 3.4.x</property> based IDE you
- can either download the <property>Hibernate Tools</property>
distribution from the <ulink
-
url="http://jboss.org/tools/download/stable/3_0_0_GA.html">J...
Tools download page</ulink>
- or from the <ulink
url="http://download.jboss.org/jbosstools/updates/stable/">J... Tools
- Update Site</ulink>.</para>
-
- <para>If you download the <property>Hibernate Tools</property>
distribution you need to place
- the <emphasis>
- <property>/plugins</property>
- </emphasis> and <emphasis>
- <property>/feature</property>
- </emphasis> directory into your eclipse directory or eclipse extensions
directory. Sometimes
- Eclipse does not automatically detect new plugins and thus the tools will not be
activated. To
- ensure eclipse sees these changes just clean up the cached plugin information by
running
- eclipse with the <emphasis>
- <property>-clean</property>
- </emphasis> option, e.g. <emphasis>
- <property>eclipse -clean</property>.</emphasis> Using the
updatesite does not require any
- additional steps.</para>
-
+ <para>To install the <property>Hibernate Tools</property> into any
<property>Eclipse
+ 3.5</property> based IDE you can either use <ulink
+
url="http://download.jboss.org/jbosstools/updates/stable/">J...
Tools Update Site</ulink>
+ or install it manually.</para>
+ <para>If you want to install the <property>Hibernate
Tools</property> distribution manually you
+ need to:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Download from
www.eclipse.org:</para>
+ <itemizedlist>
+ <listitem>
+ <para>birt-report-framework-2_5_0.zip</para>
+ </listitem>
+ <listitem>
+ <para>birt-wtp-integration-sdk-2_3_2.zip</para>
+ </listitem>
+ <listitem>
+ <para>dtp-sdk_1.7.0.zip</para>
+ </listitem>
+ <listitem>
+ <para>eclipse-SDK-3.5-win32.zip</para>
+ </listitem>
+ <listitem>
+ <para>emf-runtime-2.5.0.zip</para>
+ </listitem>
+ <listitem>
+ <para>GEF-SDK-3.5.0.zip</para>
+ </listitem>
+ <listitem>
+
<para>org.eclipse.swtbot.eclipse.test-2.0.0.371-dev-e35.zip</para>
+ </listitem>
+ <listitem>
+ <para>org.eclipse.swtbot.eclipse-2.0.0.340-dev.zip</para>
+ </listitem>
+ <listitem>
+ <para>site-1.6.2.zip</para>
+ </listitem>
+ <listitem>
+ <para>tptp.sdk-TPTP-4.6.0.zip</para>
+ </listitem>
+ <listitem>
+ <para>wtp-sdk-R-3.1-20090616035105.zip</para>
+ </listitem>
+ <listitem>
+ <para>xsd-runtime-2.5.0.zip</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Then you should unpack these files into Eclipse install
folder.</para>
+ </listitem>
+ <listitem>
+ <para>From <ulink
url="https://www.hibernate.org/6.html">hibernate.org-Download
Overview</ulink> download <ulink
url="http://downloads.sourceforge.net/project/jboss/JBossTools/JBoss...
Tools</ulink>
+ .</para>
+
+ </listitem>
+ <listitem>
+ <para>Unpack <property>Hibernate Tools</property> in
eclipse/dropins folder</para>
+ </listitem>
+ </itemizedlist>
<note>
<title>Note:</title>
- <para>If you need more basic instructions on installing plugins and general
usage of eclipse
+ <para>If you need more detailed instructions on plugins installation and
general usage of eclipse
then check out <ulink
url="https://eclipse-tutorial.dev.java.net/"
url="https://eclipse-tutorial.dev.java.net/visual-tutorials/updatema...
covers using the update manager.</para>
</note>
-
<section>
<title>Usage of Eclipse WTP</title>
-
<para>The <property>Hibernate Tools</property> plugins currently
use <property>WTP
3.x</property> which at this time is the latest stable release from the
Eclipse Webtools
project.</para>
-
<para>Because the WTP project not always have had proper versioning of their
plugins there
might exist WTP plugins in your existing eclipse directory from other Eclipse
based projects
that are from an earlier WTP release but has either the same version number or
higher. It is
thus recommended that if you have issues with WTP provided features to try and
install the
plugins on a clean install of eclipse to ensure there are no version
collisions.</para>
-
</section>
</section>
-
<section>
<title>Ant</title>
-
<para>To use the tools via Ant you need the <emphasis>
<property>hibernate-tools.jar</property>
</emphasis> and associated libraries. The libraries are included in the
distribution from the