J6/Project Manager/Project File

From J Wiki
Jump to navigation Jump to search
J6/Project Manager | Overview | Build | Links | Project File | Snapshots | SVN | Tabs

A project file is a script file with extension .ijp that defines the project. It is created and maintained by the J6/Project Manager.

A project file defines the following nouns:

PRIMARYFILES Project-specific files, required for the application
PRIMARYFILES Project-specific files, required for the application
PRIMARYLIBS Standard libraries needed for the application
DEVFILES Project-specific files, required for development only
DEVLIBS Standard libraries required for development only
OTHERFILES Other files accessible in Project Manager
TARGETFILE Target file for the application
TARGETLOCALE Target locale
TARGETHEADER Header comments written to target file
TARGETEXTRA Extra code appended to target file
BUILDOPTS Build options (numeric list)
BUILDFILE Special build file
NOTES Free-form notes
WINDOWS Project open window positions
WINDOWSTATE Project open window state

The distinction between PRIMARY or DEVELOPMENT is that when you create an application from the project, only the primary files are used. The development files are assumed to be required for development purposes only.

FILES refer to files specific to the project, and LIBS to library files that are supplied with the J system. Library files are referenced by their short names. Note that library files stdlib.ijs, colib.ijs and winlib.ijs are assumed to be always available, and therefore do not appear in the selections for library files.

OTHERFILES is an additional list of files that you can access when using Project Manager. For example, these include the project file itself, the target file (if specified), and any other files that you want to access easily, but not load with the project.

The project system uses the jproject locale for storing the project definitions. However, the project scripts are loaded into the TARGETLOCALE or base locale if not given.

TARGETFILE is the file created when building the final application. If TARGETLOCALE is given, the locale is set after any library files are loaded. TARGETEXTRA is an optional line of code to be appended to the targetfile, typically to run the application when it is loaded. TARGETHEADER comments are lines prefixed by NB. that are added to the top of the file. Use this for the file description.

BUILDOPTS configure the targetfile. BUILDFILE is an optional script file run when building the application.

A project file is a plain text file and can be edited directly, as long as you preserve the original layout. You should not add new definitions to the file, since the Project Manager will overwrite them when you next use it. Instead, add any new definitions to other script files in the project.