How to Contribute to the Development of the PDT

Install Basic Software

  1. Install Eclipse, Kepler (version 4.3) or newer. Make sure that you don't use an Eclipse version with an installed PDT. This might lead to conflicts.
  2. Install SWI-prolog Version 6.6 (or newer) for your platform. ← Skip this step if you want to use another Prolog implementation, which you want to integrate with the PDT.
    • Windows: Add the “bin” directory of your SWI-Prolog installation to the system PATH.
    • Linux: Download the SWI-Prolog sources and see the README.linux file for further instructions. Make sure that all dependencies are loaded correctly (see http://www.swi-prolog.org/build/linuxdistro.txt).

Get the PDT Code

  1. Fork the PDT repository at GitHub (https://github.com/pdt-git/public) from your account
  2. Clone your GitHub fork to any place on your hard disk.

Set-up Eclipse for developing the PDT

On the first start of Eclipse you will see a welcome screen. To start working,
close this screen by clicking the arrow on the upper right corner.
After starting Eclipse 1), choose File → Import
Select General → Existing Projects into Workspace
Select the root directory (the location of the PDT sources).

Afterwards the list of projects will be filled automatically.
Here you should select all projects except
- PDT Tutorial
- pdt.graphicalviews
- pdt.updatesite

Click Finish and the projects will be imported to your Eclipse workspace.
Importing means that the files are linked from the workspace, not copied into it.
They remain at the location where you cloned them.
After importing, Eclipse will automatically compile the projects.
The progress will be displayed in the lower right corner.
Wait for compilation to finish.

Now you can start modifying the PDT.

If you missed the note above and include the “pdt.graphicalviews” plugin there will be a compilation error, since it depends on a licenced library that we may not share via GitHub. However, you can safely ignore it. Just close the “pdt.graphicalviews” project and go on happily. The PDT will work fine, just the graphical views (Context View, GlobalView, Load Graph and Logtalk Diagrams) will not be available.

Test your Current State of the PDT

Select any of the PDT projects in the Package Explorer, open its context menu and select
Run As → Eclipse Application
Another Eclipse instance will be started, which will run the PDT code from your development workspace but without the graphical views (see blue note above).
The new Eclipse instance will access a new workspace (the so called 'runtime workspace') located in the same folder as your development workspace. In the runtime workspace you can create test projects, import your most favourite Prolog code, etc. to test your changes to the PDT.

Make your Changes Available to us

When you're satisfied with your changes, please

  1. Push them to your GitHub repository

We'll review your contribution, possibly contact you to discuss it and and let you know when we have integrated it.

As soon as your changes are merged by us into the master brach of the GitHub repository, our integration server will generate a fully functional new release (including the graphical views). You will find it on the "latest" PDT update site.

Andreas, Fabian and Günter

1) You might need to close the “Welcome” page after Eclipse has finished starting.
Last modified: 2017/06/01 11:13
*