Renesas High-performance Embedded Workshop V.4.05, Руководство пользователя

Страница: 434 / 439

High-performance Embedded Workshop 13. HMAKE User Guide
REJ10J1837-0100 Rev.1.00 Nov. 16, 2008
419
13. HMAKE User Guide
13.1 Command line
The following section describes the command line that should be used to execute the hmake program on a file using
none or more of the available options.
Basic structure
The command line must be of the following syntax:
hmake <make file you wish to execute> <parameter list>
If a file is specified without an extension then “.mak” will be appended to it. The parameter list may include none or
more of the parameters listed in the following section. The parameters list may appear before the make file name if you
wish. Each parameter must be separated by at least one white space character. Parameters are not case sensitive. If no
parameters are given and no file is given then help information will be displayed.
Exit codes
If there are any syntax errors in the make file being executed or if any process executed whilst running the make file
returns an invalid error code then hmake will exit with code 1. Otherwise hmake will exit with code 0 (See below for
file syntax and how to specify exit code conditions).
Parameters
The following table shows the available parameters and their function:
Parameter Function
/A Execute all commands regardless of input/output file status. Equivalent to a Build All.
/N Use status of input/output files to calculate what commands need to be executed (as normal) and then display the
commands but do not execute them.
/? Displays help info.
13.2 File syntax
There are four basic types of statement used in a hmake file, the variable declaration the description block, the comment
and the message command. These can be combined in any order to produce a hmake file but a variable must be declared
in a variable declaration before it is used in a description block or other variable declaration. The first “all” statement
used in nmake files is not required in a hmake file. Commands are executed in order, as they appear in the make file.
Note : the “
→
” character is used to show were a tab character must be used in order to keep the make file syntactically
correct.
Variable declarations
A variable declaration declares a variable which can then be used in any statement throughout the rest of the hmake file.
A declaration has the following syntax:
<variable name> = <value>
Any number of white space characters are allowed between the variable name and the ‘=’ sign and the value and the ‘=’
sign. The value may be split over several lines using a ‘\’ character. If the value contains ‘\’ characters within the main
text then these are taken literally. Only ‘\’ characters followed by a new line are considered to indicate a value wrapping
over more than one line.