"How to Use the Vortex Compiler and Environments"
The directories ${VORTEX_HOME}/bin and ${VORTEX_HOME}/Cecil/bin contain utilities that support Vortex application development. Some of these utilities can be invoked from within Vortex, which is responsible for ensuring that the environment is set up correctly. To use these programs at a Unix prompt, source ${VORTEX_HOME/bin/shell/vortex.cshrc from your ~/.cshrc to define the appropriate environment variables and add the appropriate directories to your path. Some of the most useful utilities are:
_foo.cecil.c.lock is a lock file for foo.cecil.c) that are created and removed in the gen directory during phase 2 compilation. The scripts pm, pmwait, and pzap are used to drive parallel compilation. To immediately spawn parallel compiles, use pm; pmwait waits until the current phase 1 compilation completes (time stamp on Makefile in the gen directory changes) and then spawns the parallel compile jobs; pzap kills the spawned compile jobs.
call-chain.perl, call-site.perl, and summary.perl all invoke pic-filter.perl to format raw profile data into the form expected by Vortex (see section 2.6).
${VORTEX_HOME}/Cecil/bin/shell/cecil-mode.el.
run-vortex script invokes Vortex after modifying the environment. It enables "casual" Cecil programmers to run Vortex without having to modify their environments or explicitly source vortex.cshrc.