Commands
Here are some descriptions of general commands. You can get the list of the all
commands with a short description by zenmake help
or zenmake --help
.
To get help on selected command you
can use zenmake help <selected command>
or
zenmake <selected command> --help
. Some commands have short aliases.
For example you can use bld
instead of build
and dc
instead of distclean
.
- configure
Configure the project. In most cases you don’t need to call this command directly. The
build
command calls this command by itself if necessary. This command processes most of values from buildconf of a project. Any change in buildconf leads to call of this command. You can change this behaviour with parameterautoconfig
in buildconf general features.- build
Build the project in the current directory. It’s the main command. To see all possible parameters use
zenmake help build
orzenmake build --help
. For example you can use-v
to see more info about building process or-p
to use progress bar instead of text logging. By default it calls theconfigure
command by itself if necessary.- test
Build (if necessery) and run tests in the current directory. If the project has no tests it’s almost the same as running the
build
command. Thetest
command builds and runs tests by default while thebuild
command doesn’t.- run
Build the project (if necessery) and run one executable target from the build directory. You can specify build task/target to run if the project has more than one executable targets or omit it if the project has only one executable target. To provide command line args directly to your program you can put them after ‘–’ in command line after all args for ZenMake. This command is for fast checking of the built project.
- clean
Remove build files for selected
buildtype
of the project. It doesn’t touch other build files.- cleanall
Remove the build directory of the project with everything in it.
- install
Install the build targets in some destination directory using installation prefix. It builds targets by itself if necessary. You can control paths with environment variables or command line parameters (see
zenmake help install
). It looks like classicmake install
in common.- uninstall
Remove the build targets installed with the
install
command.