UMK - Command line builder
1. Introduction
UMK (U++ MaKe) is a command line utility to build the U++ program, with U++ assembly/package/build method system.
umk assembly package build_method [-[a][b][e][r][s][S][v][m][d][M][l][x][X][Hn]] [+FLAG[,FLAG]...] [out]
assembly can be a predefined assembly (in .var file) which is in Win32 in directory where is located umk.exe or in POSIX systems in directories ~, ~/.upp/umk, ~/.upp/theide or ~/.upp/theide. Alternatively, it is a direct set of directories that represent U++ assembly separated by ','.
package is the main package (a program to build).
build_method is build method that is to be used to build the resulting executable, specified either as name of build method (which is then searched for in ~, ~/.upp/umk, ~/.upp/theide ~/.upp/theide directories) or it is a direct path to the .bm file.
FLAGs are compilation flags. If flags are not specified, the first main configuration entry in .upp file is used.
out is output file or directory.
Option
|
Description
|
a
|
Rebuild all.
|
b
|
Use BLITZ.
|
e
|
If building fails, stop with message box.
|
l
|
Silent mode.
|
m
|
Create a map file.
|
r
|
Release mode
|
d
|
Debug mode without debug symbols.
|
s
|
Use shared libraries.
|
S
|
Use shared libraries and build as shared libraries.
|
v
|
Be verbose.
|
M
|
Create makefile (to file out).
|
x
|
Export project (to directory out), export only files used.
|
X
|
Export project (to directory out), export all files.
|
xM
|
Export makefile (to directory out).
|
k
|
Do not delete target directory out when exporting.
|
Hn
|
Number of threads used for building (single digit). Default is number of logical cores available.
|
|
2. Examples
umk uppsrc ide GCC -br +GUI,SSE2,SHARED ~/theide
umk uppsrc ide /usr/share/upp/GCC.bm -br +GUI,SSE2,SHARED ~/theide
umk examples Bombs GCC -ab +GUI,SHARED ~/bombs
umk upp/examples,upp/uppsrc Bombs ~/GCC.bm -rv +GUI,SHARED ~/bin
|