blob: e30e190c47a9ef420bff0926e3b642cf5d39b83e [file] [log] [blame]
<html>
<head>
<title>WTP Updates</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style>@import url("web/site.css");</style>
</head>
<body onload="init();">
<!-- custom messages here ... comes before header generated in xsl code -->
<DIV align="right" width=400>
<p><A align="right" alt"Example proposed WTP logo"
HREF="https://bugs.eclipse.org/bugs/show_bug.cgi?id=122593"><IMG
SRC="wtpdraft.jpg"></A></p>
<p><font size="small">Like this logo? Don't like this logo?
<br /> Want to propose another?
<br /> Comment on <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=122593">Bug 122593</a><br />.</font></p>
</DIV>
<h1 class="title">Eclipse Update Site for <br /> Web Tools Platform (WTP) </h1>
<p>This update site provides the features of the Eclipse Web
Tools Platform (WTP).</p>
<p>It not only provides the data for WTP updates, it also provides
"pointers" to the prerequisite projects (JDT, EMF, GEF, and JEM).</p>
<p>It does assume, however, that at least the Eclipse 3.1.2
Platform Feature is installed.
</p>
<p>Note, if you are starting with Eclipse 3.1.0, there are some separate and <a
href="http://www.eclipse.org/eclipse/platform-releng/updatesfor3.1.1.html">specific
instructions</a> for updating the base platform to the 3.1.1 or 3.1.2 level.</p>
<p>To use this update site in your existing installation of Eclipse,
add the following URL as a remote update site in your update manager.
<p>&nbsp;&nbsp;&nbsp;&nbsp;<b><code>http://download.eclipse.org/webtools/updates/</code></b></p>
<p><b>Tip: </b>any time you get a chance, export your bookmark files from the "add a site" dialog. Having them
saved away in a safe place makes it much easier to re-create another development environment.</p>
<p>See <a
href="http://help.eclipse.org/help31/index.jsp?topic=/org.eclipse.platform.doc.user/tasks/tasks-34.htm">Eclipse
Help</a> for general information about using Update Manager.</p>
<p><b>Tip: </b>To lessen download time (by installing the minimum number of features), first select the desired WTP feature in the
Eclipse update install dialog, then use the 'select required' button to
select only the minimum required prerequisite features.
</p>
<p><b>Tip: </b>If you are able, it may be easiest to
start a fresh development environment based on 3.1.2 and then update to use WTP 1.0.1 and its pre-reqs.
And, since the workbench may have to shutdown and restart several times (if updating several features),
you can you do the upgrade with an empty workspace and once satisfied all is well, then use
the -data option on the Eclipse command line (or shortcut) to point to your workspace of interest.
</p>
<h3>Known Problems and Issues</h3>
<p>
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=122783">bug 122784:</a>&nbsp;&nbsp; Even if you have
WTP 1.0.0 installed, you can not "search for updates of the currently installed features".
</p><p>
<b>Workaround: </b>add the webtools/update site as a remote update site and use it as you would any other
new feature.
</p><p>
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=123191">bug 123191:</a>&nbsp;&nbsp; If you
check "Filter features included in other features on the list", then even using
the 'select required' button may not "find" all the features required. Similar for
the 'show only the latest version of the feature'.
</p><p>
<b>Workaround: </b>do not check that box! :)
</p>
<p>As always, open bugs you find or open feature requests,
to help the project improve. Thanks for your help.</p>
<h3>Example of Update Dialog</h3>
<p>Here is an example screen shot highlighting the areas discussed in the
tips and workarounds. The example is from having startng with just the base 3.1.2 Platform Feature installed.</p>
<img alt"Example view of Update dialog" src="update2.gif" />
</body>
</html>