The program seeks out the reference files of those modules which are imported by the base module, and the reference files of the modules which are imported by those modules, and so on. It creates and compiles a small program containing the initialization call chain, and creates a script for the UNIX linker ld. Reference files are found by first searching the current directory, followed by the the directories of the path $M2LIB, in order.
build accepts a number of options from the command line. The following conventions apply to the use of the options:
(i) options are the first argument after the command
(ii) the option string must start with a minus sign -
(iii) options may appear in a single group or individually
(iv) the order of the options is not important so that
build -vS foo
and build -S -v foo have the same effect.
-L dirname force Library path - the linker will search the named directory for archive libraries before searching the default directories
-q query - the builder prompts for the names of reference files which it cannot find. Only the file base-name is required, and querying may be aborted by entering a blank line
-S aSsembler - the initialization-call-chain code file and the linker script are persistent as files modbase.c and modbase respectively
-v verbose messages are displayed on the screen so that progress may be monitored, and the origin of any error messages determined
-V builder Version date and time are displayed, and screen messages are verbose. Also, the library files which are linked have their absolute path names and cryptographic key values displayed
To build a profiling version of a program, build is invoked under the name bldprf . This version of the load-builder generates a linkage to the standard UNIX profiling tool prof .
The source module must have been compiled with either the -g or -p options. After the program is executed the results of profiling may now be analysed using prof -g base .
The option and filename conventions for bldprf are identical to those of build .
Warning : modules compiled with the -p option cannot be built using build . Fortunately, build checks for this possibility and issues a specific diagnostic
For further information on profiling refer to the Appendix in
the Gardens Point Modula Reference Manual titled
Using the Profiling Tools
.