open-project

Function

Package: common-graphics

ToC

DocOverview

CGDoc

RelNotes

Index

PermutedIndex

Allegro CL version 6.2
Unrevised from 6.1

open-project

Arguments: pathname-or-namestring &key action

This function opens a project (identified by the arguments) for further development in the IDE. The project becomes the current project (as returned by current-project). This function returns the project that was opened, unless no project is opened for some reason (such as failure to specify an existing project definition file), in which case nil is returned. If the project is opened successfully, then the function current-project will continue to return the project until another opened project (or a new project) takes its place. (Therefore, if this function fails to open a project, the previously open project remains the current project.)

Projects are typically opened interactively by using the File | Open Project command (which calls this function), but it may be useful to call this function directly (for example) in the startup.cl file, perhaps as part of code that conditionally decides which project to initially open in the IDE. (startup.cl is loaded during IDE startup. See About IDE startup in cgide.htm.)

To simply use an existing project in the IDE without opening it for further development, call load-project instead.

Arguments

pathname-or-namestring may be either a pathname or string naming a .lpr project definition file that was automatically created by saving a project in the IDE. It may alternately be nil, in which case the file-selection Common Dialog is invoked to prompt for the .lpr file to open.

action may be either one of the following values:

nil (the default): the current open-project-action configuration option is used. (This option is found in the Open group box on the Project tab of the Options dialog.)

:full-compile: all of the source code files of the project are compiled, and all of the resulting fasl files are loaded.