View source for Spaces/Building from source

The plug-ins and the spaces project update site can be built using [http://www.eclipse.org/buckminster Buckminster]. Here is a step by step instruction on how to do that. Detailed instructions can be found [http://wiki.eclipse.org/Getting_started_with_Buckminster here].

=Installing Buckminster=
See to that you have Buckminster installed. You must have a version where core feature is of 1.0.0.r08888 or later. In addition to the core feature, you will need support for PDE and SVN (Subclipse or Subversive doesn't matter. Pick your favorite but not both).

=Getting all the source=
#Use '''File''' -> '''Open a Component Query''' and enter the following URL: <nowiki>http://www.eclipse.org/spaces/queries/spaces.cquery</nowiki>.
#The Buckminster CQUERY opens up. Click on the button '''Resolve and Materialize'''. This should bring all projects from the spaces SVN repository into your workspace.

=Properties needed for the build=
<p>The build will require two properties to be set:
<pre>qualifier.replacement.*=generator:lastRevision
generator.lastRevision.format=r{0,number,00000}</pre>
and the output can be controlled using a third property:
<pre>buckminster.output.root=&lt;a folder of choice&gt;</pre>
This property will default to the folder '''${user.temp}/buckminster.</p>'''
<p>There are multiple ways to assign properties to a build. You can either appoint a file that contains these properties when you execute the action (the file '''build.properties''' is provided in the ''org.eclipse.spaces.update'' project for this purpose), or you can specify them as ''string substitutions'' under the '''Run/Debug''' preference page.</p>

=Building=
#Right click on the project ''org.eclipse.spaces.update''
#Choose ''Buckminster''
#Choose ''Invoke action...''
#In the action dialog, select ''build.site''
#Enter the name of the properties file (this step is optional if you have your properties defined as string substitutions
#Click ''OK''.

=Deploying=
The resulting product is found here <pre>${buckminster.output.root}/org.eclipse.spaces.update_0.1.0-buckminster/site</pre>. It will be one single file with a name similar to ''spaces.archivedsite-0.1.0.r10449_incubation.zip'' The version qualifier at the end reflects the revision of the SVN repository and will thus change over time.

You can use this update site directly by doing the following:
#''Help'' -> ''Software Updates'' -> ''Find and Install''
#Check ''Search for new features to install''. You do this <u>even if you are updating</u>.
#Click ''Next''
#Click on the button ''New Archived Site...''
#In the dialog that pops up, enter the path of the archived site that was the product of your build.
#Click ''Open''
#Accept the default name by clicking ''OK''
#Continue the install as you normally would.

That's all folks.