A projects set projects (PS projects) is a specialized project with one project set file.
In the eclipse views a PS project is shown with the icon
Each PS project has a file named .psproject that holds the project relative name of the project set file. When renaming the project set file the file name in the .psproject file must be changed accordingly.
PS projects enables the user to nest project sets by using project set projects as entries in other project sets. Project sets can then be loaded recursively, that means if a project set X is loaded that contains a project y that is a project set projects then the projects specified in the project set file in y are also loaded.
Project set files can be used without a PS project but then they can't be nested and no error markers are created for them.
When using PS projects there can be conflicts. That means a project is specified with different tags. For example a project set contains a project X and a project Y that is a PS project that contains X with a different tag.
Conflicts can only be noticed if the PS project that contains the conflict is loaded with the specified tag, e.g. in the above example the conflict is not shown if the PS project Y is not loaded or loaded with a different tag.
To create a project set project use the menu "File > New > Other...", select the category "Project Set" and the type "Project Set Project"
The wizard for a project set project automatically created the .psproject file and the project set file with the projects specified in the wizard page. The name of the created project set file is the same as the name of the project but with the extension .psf.
On changes in the workspace (e.g. change a project set file in a project set or loading a projects) all PS projects will be checked for errors and warnings. For every PS project only the project set file specified in the .psproject file will be checked for conflicts and loading state. Other project set files in the PS project are not checked.
The messages for the errors and warnings are listed in the eclipse task view and the affected resource will be marked with one of the following icons: