The IDE supports two 'top level' objects: Projects and Archive Projects.
Creating Projects
You create a project by right-clicking anywhere within the Diamond source view and selecting Create project:
The project name appears in the Diamond source view once it has been created. At any time you can double-click the project name to bring up the project window where you can set various project-wide options. These options are described under configurer options.
The Active Project
At any time, there is one project selected as the active project. Clicking a project does not make it the active project; this is to allow you to explore another project, perhaps to extract pieces of code or to make references to other files, without changing the active project. You can make another project the active one by right-clicking it and selecting Select active project.
Projects
A project is used to define and build a Diamond application.
Archive projects
An archive project is a place-holder for material that is shared across projects.
Cleaning projects and archives
Projects can become cluttered with files and objects created as part of the build process: object files, temporary files, and so on. You can remove this clutter by cleaning the project. This deletes all generated files and anything that is not seen as being part of the project. It also results in everything being rebuilt when you next build the project.
Cleaning also deletes files that have found their way into the directory structure but which have not been formally added into the project.
You can clean a project by clicking Project from the menu at the top of the workspace and selecting Clean...
This brings up the following dialog.
Select the projects you wish to clean and then click OK. There is an option to rebuild the project once the cleaning operation has completed. You can prevent this before clicking OK by clearing the tick from the box labelled Start a build immediately.