Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 275582

Summary: Rewrite Getting Started Guide
Product: z_Archived Reporter: David Carver <d_a_carver>
Component: Dash AthenaAssignee: Nick Boldt <nboldt>
Status: RESOLVED DUPLICATE QA Contact:
Severity: normal    
Priority: P3 CC: dash.commonbuilder-inbox, nboldt
Version: unspecified   
Target Milestone: ---   
Hardware: PC   
OS: Linux   
Whiteboard:

Description David Carver CLA 2009-05-10 22:07:19 EDT
Currently the Builds require running an initial setup script that is written in a unix script.  However this does not make for an easy out of the box setup and go experience.    This script should be rewritten using Ant, so that it can be run regardless of which platform is setup.   Existing build.properties file can be used to store the necessary properties that need to be configured.   Also if it is not already setup the name of the properties files should be able to be set as an Ant property.   This allows for multiple build.properties files to be used and tweaked for various types of builds.

http://wiki.eclipse.org/Common_Build_Infrastructure/Getting_Started
Comment 1 Nick Boldt CLA 2009-05-11 00:37:05 EDT
Really the issue is the docs need updating.

To run using Ant, see:

http://wiki.eclipse.org/Common_Build_Infrastructure/Getting_Started/Build_In_Eclipse

To run commandline (eg., in Hudson) you need shell, though arguably with some refactoring (and refactoring of the plugin dependencies & ant tasks in basebuilder to pure antlibs instead of plugin.xml extensions) you could point Hudson at foo.releng/build.xml and it would run the same way it does in Eclipse w/ AntRunner.

Me, I don't see much value in refactoring so that a PDE builds doesn't need PDE, so I'm retitling this bug and assigning it to myself as a reminder that the Getting Started guide needs to be cleaned up, since that localhost.setup.sh thing was pretty much only useful for build.eclipse.org, and isn't needed anymore.
Comment 2 David Carver CLA 2009-05-11 08:52:54 EDT
(In reply to comment #1)
> Really the issue is the docs need updating.
> 
> To run using Ant, see:
> 
> http://wiki.eclipse.org/Common_Build_Infrastructure/Getting_Started/Build_In_Eclipse

Actually I have followed that particular guide, and still get a malformed URL exception about the $eclipseBaseURL variable.  So unless I missed something it looks like the setup scripts still need to be run first.

> 
> To run commandline (eg., in Hudson) you need shell, though arguably with some
> refactoring (and refactoring of the plugin dependencies & ant tasks in
> basebuilder to pure antlibs instead of plugin.xml extensions) you could point
> Hudson at foo.releng/build.xml and it would run the same way it does in Eclipse
> w/ AntRunner.

Actually I'm not mentioning refactoring the entire thing out so that you don't run eclipse headless with ant to run the build.    Currently the *.sh files are used to download and setup the necessary dependencies.   This can all be done with ANT instead of relying on a Start.sh.   If done, this then simplifies the necessary OS specific batch startup jobs that need to be created to a single command line.

The first part of the Custom Eclipse Builder (http://ceb.sourceforge.net/) project checks and downloads all the necessary components in Ant and is configured uisng property files.  You might be able to contact the author of those scripts and see if he is interested in making a contribution.   I believe he is the sole writer of the scripts there.

They might also be able to give some ideas on how to implement something similar.  This way you get all the necessary download steps in a multi-platform implementation.

Comment 3 Nick Boldt CLA 2009-05-11 12:00:19 EDT
As discussed, you grabbed the wrong org.eclipse.gef.releng; use the one referenced in the guide, which points to the Athena version of gef.releng. 

http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.dash/athena/org.eclipse.dash.commonbuilder/org.eclipse.dash.commonbuilder.releng/psf/gef.psf?root=Technology_Project&view=co

The one in /cvsroot/tools/org.eclipse.gef/org.eclipse.gef.releng is for the older Modeling build, not the Athena build.
Comment 4 Nick Boldt CLA 2009-05-11 12:01:19 EDT

*** This bug has been marked as a duplicate of bug 252041 ***