Table of Contents        Previous topic       Next topic       

Projects and Workspaces->Build Settings->Custom Build Steps->Adding Removing and Saving Custom Build Steps

Adding a Command

To add a command, click Add.  

In the Description field, enter the description that you wish to be displayed when the command is run.  

In the Command field, enter the name of the command to be run.  If this command is not in a directory pointed to by the PATH setting of your systems environment or is not in the initial directory, then you must include the full path of the command.

In the Arguments field, enter any command line arguments that you wish to pass to the command.

In the Initial Directory field, enter the directory that should be made the current directory before the command is run.

The command, arguments, and initial directory fields can contain the following macros which will be replaced by the appropriate text as follows:
    

$(TargetDir)	The directory of the current target program or library.
$(TargetExt)	The filename extension of the current target program or library.
$(TargetName)	The filename of the current target.
$(TargetPath)	The filename (without extension) of the current target program or library.
$(ProjectDir)	The directory of the current project that contains the .XMK file.
$(ProjectName)	The current project name (without the .XMK extension).
$(MapPath)	The complete filename of the current map file
$(VariantPath)	The full path of the directory specified by the VariantPath setting for the family member.

Win32 long filenames will be used in the above.  Alternative macros are provided which will use the shortened MS-DOS path and these should be used for commands that cannot handle long filenames.  These are:
    

$(DosTargetDir)	The directory of the current target program or library.
$(DosTargetExt)	The filename extension of the current target program or library.
$(DosTargetName)	The filename (without extension) of the current target program or library.
$(DosTargetPath)	The complete filename of the current target program or library.
$(DosProjectDir)	The directory of the current project that contains the .XMK file.
$(DosProjectName)	The current project name (without the .XMK extension).
$(DosMapPath)	The complete filename of the current map file
$(DosVariantPath)	The full path of the directory specified by the VariantPath setting for the family member.

Removing a Command


To remove a command, select it in the Commands list and click Remove.



Move up/Move down

To change the order in which the commands are executed, select each command that you wish to move in the Commands list and use the Move Up and Move Down buttons to reposition it.


Save With

By default, a custom command will be saved with the project.  However, you can instead save a command with the application, with the target family or, if the VariantPath for the family member has been defined, with the family member.

Note that if commands are saved in separate locations, the order that you set up in the list (and hence the order of execution) may change.