ROOT_TO_PROJDIR

It is assumed every project is uniquely identified by the logical path to its project directory. Normally all the source files in a project live in the tree rooted at the project directory.

Immediately after the definition of $TARGET_TYPE, an .xcpj file must define the variable $ROOT_TO_PROJDIR which specifies the logical path to the project directory. For example:


$ROOT_TO_PROJDIR = "Ceda/App/cxJigsaw"

A predefined variable named $PROJDIR_TO_ROOT is automatically calculated as the inverse of $ROOT_TO_PROJDIR. For example the inverse of "Ceda/App/cxJigsaw" is "../../.."

By convention the name of the project directory is regarded as the project name. In this case the project name is "cxJigsaw"

It is not assumed that project names are globally unique. However this assumption is made within a given solution. The project name is implied from the value of $ROOT_TO_PROJDIR (i.e. it is always the last directory name in this path). The project name is automatically made available in a variable named $PROJNAME.

Files that are not exported are conventionally stored under a directory named src under the project directory. For example if $PROJDIR_TO_ROOT="x/y/z" then $PROJNAME="z" and $PROJDIR_TO_ROOT="../../..". Also it is assumed that the associated .xcpj file will have logical path x/y/z/src/z.xcpj. This convention is used for all projects.