Build Events

There are three build events per code file. These are pre build, custom build and post build. Pre build events are processed before the actual build commences. A custom build replaces the in built build (for example no compile will be done by the internal compiler). You have to make sure to create a file with the exact configured output name though to have the followup event or running the build work. The post build event is run after a build. The post build is a good place to add crunching to your executable. Also here, make sure to give the final file the exact configured output name.

All the event scripts allow the use of macros to insert build specifica. A macro is inserted by adding $(Macro Name) in the script. These macros are currently supported:

Macro Output Meaning
$(Filename) d:\projects\lsmf\lsmfmain.asm Returns the fully qualified filename to the current document
$(FilenameWithoutExtension) d:\projects\lsmf\lsmfmain Returns the fully qualified filename to the current document, minus the file's extension
$(FilePath) d:\projects\lsmf Returns the fully qualified path to the current document
$(BuildTargetPath) depends on the target file configuration Returns the fully qualified path to the current document if no full path is configured. Returns the fully qualified path to the configured build target file
$(BuildTargetFullPath) depends on the target file configuration Returns the fully qualified filename to the configured build target file
$(BuildTargetFullPathWithoutExtension) depends on the target file configuration Returns the fully qualified filename without extension to the configured build target file
$(BuildTargetFilename) depends on the target file configuration Returns the target filename
$(BuildTargetFilenameWithoutExtension) depends on the target file configuration Returns the target filename without extension
$(DebugStartAddress) depends on the document configuration Returns the configured debug start address decimal
$(DebugStartAddressHex) depends on the document configuration Returns the configured debug start address hexadecimal
With a project file located at d:\projects\lsmf\lsmfmain.asm these settings are used.