What is the current correct way to build an Eclipse update site?
I am trying to understand what is the recommend/best practices way to create an update site for installing a plugin using Eclipse's built-in plugin installer.

The PDE plugin provides an *Update Site Project* which produces an update site that appears to work with recent versions of Eclipse (3.7.1).

At the same time, from [Equinox/p2/Getting Started for Releng](http://wiki.eclipse.org/Equinox/p2/Getting_Started_for_Releng) it sounds like P2 is the new and improved way to do installation in Eclipse but it looks like my Update Site Project is producing the old-fashioned Update Manager configuration.

I have no prior knowledge of how Eclipse Update Manager works and I am having trouble because the documentation I find for P2 is either reference documentation or intended to show the differences between the old system and P2. Since I am a novice at this I cannot tell which documentation has been obsoleted.

I am wondering if I should use the PDE's *Update Site Project* or if it is waiting for an update to P2 and if anyone can recommend a good, up to date, document on the right way to create an Eclipse update site.  For example, I want to install some extra files not included in the plugin jar and there seem to be at two different ways to do this, using `install-handler` in the feature manifest or, maybe, a *touchpoint*.

Which installation facility should I use, or are they not mutually exclusive?

What is the current correct way to build an Eclipse update site?
===

I am trying to understand what is the recommend/best practices way to create an update site for installing a plugin using Eclipse's built-in plugin installer.

The PDE plugin provides an *Update Site Project* which produces an update site that appears to work with recent versions of Eclipse (3.7.1).

At the same time, from [Equinox/p2/Getting Started for Releng](http://wiki.eclipse.org/Equinox/p2/Getting_Started_for_Releng) it sounds like P2 is the new and improved way to do installation in Eclipse but it looks like my Update Site Project is producing the old-fashioned Update Manager configuration.

I have no prior knowledge of how Eclipse Update Manager works and I am having trouble because the documentation I find for P2 is either reference documentation or intended to show the differences between the old system and P2. Since I am a novice at this I cannot tell which documentation has been obsoleted.

I am wondering if I should use the PDE's *Update Site Project* or if it is waiting for an update to P2 and if anyone can recommend a good, up to date, document on the right way to create an Eclipse update site.  For example, I want to install some extra files not included in the plugin jar and there seem to be at two different ways to do this, using `install-handler` in the feature manifest or, maybe, a *touchpoint*.

Which installation facility should I use, or are they not mutually exclusive?
