dc9e6e1604
* debian/rules
- doc/man/hbmk.1
+ doc/man/hbmk2.1
! Renamed to hbmk2 to be in sync with name of the tool.
* Makefile
! Fixed to always descend into utils directory,
because (in 'install' mode) hbrun and hbmk2 needs
to be built regardless of HB_BUILD_PARTS setting.
* contrib/hbfbird/hbfbird.hbi
! Fixed to set output libname. This is needed because
we can't rely on input filename due to mingw trick.
* config/global.mk
+ Show HB_BUILD_IMPLIB setting. Now there is nothing
hackish in it, so it can be fully supported setting.
* config/postinst.prg
% Minor optimizations in hbmk2 invocation lines.
(removed unnecessary spaces, using envvar macros,
deleted unnecessary double quotes)
! Fixed (in two places) to only invoke hbmk2 if
HB_HOST_BIN_DIR envvar is set.
! NSIS invocation command made more friendly to cross
platform environment by using native pathsep.
+ Will now echo the external commands issued to stdout.
159 lines
4.0 KiB
Groff
159 lines
4.0 KiB
Groff
.TH HBMK2 1
|
|
|
|
.SH NAME
|
|
hbmk2 \- Harbour Project Make
|
|
|
|
.SH SYNOPSIS
|
|
\fBhbmk2\fP \fB[options] [<script[s]>] <src[s][.prg|.c|.obj|.o|.rc|.res]>\fP
|
|
|
|
.SH DESCRIPTION
|
|
\fBhbmk2\fP is the Harbour Project make utility.
|
|
|
|
It's a wrapper to the Harbour compiler, a C compiler and linker.
|
|
|
|
.SH OPTIONS
|
|
.IP "\fB-help\fP" 10
|
|
Display full help
|
|
|
|
.IP "\fB-o<outname>\fP" 10
|
|
output file name
|
|
|
|
.IP "\fB-l<libname>\fP" 10
|
|
link with <libname> library
|
|
|
|
.IP "\fB-L<libpath>\fP" 10
|
|
additional path to search for libraries
|
|
|
|
.IP "\fB-static|-shared\fP" 10
|
|
link with static/shared libs
|
|
|
|
.IP "\fB-mt|-st\fP" 10
|
|
link with multi-thread/single-thread VM
|
|
|
|
.IP "\fB-gt<name>\fP" 10
|
|
link with GT<name> GT driver, can be repeated to link
|
|
with more GTs. First one will be the default at runtime
|
|
|
|
.IP "\fB-gui|-std\fP" 10
|
|
create GUI/console executable
|
|
|
|
.IP "\fB-main=<mainfunc>\fP" 10
|
|
override the name of starting function/procedure.
|
|
|
|
.IP "\fB-fullstatic\fP" 10
|
|
link with all static libs
|
|
|
|
.IP "\fB-nulrdd[-]\fP" 10
|
|
link with nulrdd
|
|
|
|
.IP "\fB-bldf[-]\fP" 10
|
|
inherit all/no (default) flags from Harbour build
|
|
|
|
.IP "\fB-bldf=[p][c][l]\fP" 10
|
|
inherit .prg/.c/linker flags (or none) from Harbour build
|
|
|
|
.IP "\fB-[no]debug\fP" 10
|
|
add/exclude debug info
|
|
|
|
.IP "\fB-[no]map\fP" 10
|
|
create (or not) a map file
|
|
|
|
.IP "\fB-[no]strip\fP" 10
|
|
strip (no strip) binaries
|
|
|
|
.IP "\fB-[no]fmstat\fP" 10
|
|
enable/disable runtime memory statistics (gcc builds only)
|
|
|
|
.IP "\fB-[no]trace\fP" 10
|
|
show commands executed
|
|
|
|
.IP "\fB-[no]run\fP" 10
|
|
run/don't run the created executable
|
|
|
|
.IP "\fB-nohbc\fP" 10
|
|
do not process .hbc files in current directory
|
|
|
|
.IP "\fB-hbcc, -hbcmp\fP" 10
|
|
stop after creating the object files
|
|
create link/copy hbmk2 to hbcc/hbcmp for the same effect
|
|
|
|
.IP "\fB-hblnk\fP" 10
|
|
act as linker. Currently this is the same as -q
|
|
|
|
.IP "\fB-plat=<plat>\fP" 10
|
|
assume specific platform. Same as HB_PLATFORM envvar
|
|
|
|
.IP "\fB-comp=<comp>\fP" 10
|
|
use specific compiler. Same as HB_COMPILER envvar
|
|
Special value:
|
|
- bld: use original build settings (default on *nix)
|
|
|
|
.IP "\fB-info\fP" 10
|
|
turn on informational messages
|
|
|
|
.IP "\fB-quiet\fP" 10
|
|
suppress all screen messages
|
|
|
|
<script> can be <@script> (.hbm file), <script.hbm> or <script.hbc>.
|
|
|
|
Regular Harbour compiler options are also accepted.
|
|
|
|
Multiple -l, -L and <script> parameters are accepted.
|
|
|
|
hbmk.cfg option file in hbmk2 directory is always processed if it exists.
|
|
On *nix platforms ~/.harbour, /etc/harbour, <base>/etc/harbour,
|
|
<base>/etc are checked (in that order) before the hbmk2 directory.
|
|
The file format is the same as .hbc.
|
|
|
|
.hbc option files in current dir are automatically processed.
|
|
|
|
.hbc options (they should come in separate lines):
|
|
libs=[<libname[s]>], gt=[gtname], prgflags=[Harbour flags]
|
|
cflags=[C compiler flags], ldflags=[Linker flags], libpaths=[lib paths]
|
|
gui|mt|shared|nulrdd|debug|map|strip|run=[yes|no]
|
|
Lines starting with '#' char are ignored
|
|
|
|
Platform filters are accepted in each .hbc line and with -l options.
|
|
Filter format: {[!][<plat|comp>]}. Filters can be combined
|
|
using '&', '|' operators and grouped by parantheses.
|
|
Ex.: {win}, {gcc}, {linux|darwin}, {win&!pocc}, {(win|linux)&!watcom}
|
|
|
|
Defaults and feature support vary by platform/compiler.
|
|
|
|
Supported <comp> values for each supported <plat> value:
|
|
linux: gcc, gpp, watcom, icc
|
|
darwin: gcc
|
|
win: mingw, msvc, bcc, watcom, icc, pocc, cygwin, msvc64, msvcia64, pocc64
|
|
wce: mingwarm, msvcarm, poccarm
|
|
os2: gcc, watcom
|
|
dos: djgpp, watcom
|
|
bsd, hpux, sunos: gcc
|
|
|
|
.SH FILES
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
.IP "\fBHB_CCPATH\fP" 10
|
|
.IP "\fBHB_CCPREFIX\fP" 10
|
|
.IP "\fBHB_PLATFORM\fP" 10
|
|
.IP "\fBHB_COMPILER\fP" 10
|
|
.IP "\fBHB_INSTALL_PREFIX\fP" 10
|
|
.IP "\fBHB_BIN_INSTALL\fP" 10
|
|
.IP "\fBHB_INC_INSTALL\fP" 10
|
|
.IP "\fBHB_LIB_INSTALL\fP" 10
|
|
.IP "\fBHB_MT\fP" 10
|
|
.IP "\fBHB_GUI\fP" 10
|
|
.IP "\fBHB_SHARED\fP" 10
|
|
.IP "\fBHB_DEBUG\fP" 10
|
|
.IP "\fBHB_NULRDD\fP" 10
|
|
.IP "\fBHB_GT\fP" 10
|
|
.IP "\fBHB_USER_PRGFLAGS\fP" 10
|
|
.IP "\fBHB_USER_LIBS\fP" 10
|
|
.IP "\fBHB_USER_RESFLAGS\fP" 10
|
|
.IP "\fBHB_USER_CFLAGS\fP" 10
|
|
.IP "\fBHB_USER_LDFLAGS\fP" 10
|
|
|
|
.SH AUTHOR
|
|
|
|
Viktor Szakats, The Harbour Project (http://www.harbour-project.org)
|