2941e5b354
Change-Id: I488def80e855624ffd85a0b6c4cc19819c39ed01
123 lines
5.6 KiB
Text
123 lines
5.6 KiB
Text
NAME
|
|
gbuild - GNU make based build system for LibreOffice
|
|
|
|
SYNOPSIS
|
|
make [ -f makefile ] [ options ] [ variable=value ... ] [ targets ] ...
|
|
|
|
IMPORTANT OPTIONS
|
|
-s Silent operation; do not print the commands as they are executed.
|
|
|
|
-n Print the commands that would be executed, but do not execute them.
|
|
-k Continue as much as possible after an error.
|
|
|
|
-j Specifies the number of jobs (commands) to run simultaneously.
|
|
-l Specifies that no new jobs (commands) should be started if there are
|
|
others jobs running and the load average is at least load.
|
|
|
|
-t Touch files (mark them up to date without really changing them)
|
|
instead of running their commands.
|
|
-W Pretend that the target file has just been modified.
|
|
-o Do not remake the file file even if it is older than its
|
|
dependencies, and do not remake anything on account of changes in file.
|
|
|
|
-p Print the data base (rules and variable values) that results from
|
|
reading the makefiles.
|
|
--debug=b debug make run, see GNU make man page for details
|
|
|
|
(descriptions from GNU make man page)
|
|
|
|
AVAILABLE TARGETS
|
|
all build product and run unit tests (default goal)
|
|
build build product
|
|
unitcheck run unit tests
|
|
slowcheck run slow unit tests
|
|
subsequentcheck run system tests (requires full installation)
|
|
check run unit tests and if in toplevel subsequentcheck
|
|
clean remove all generated files
|
|
debugrun starts the dev-install instance and allows tests to be run
|
|
against it
|
|
<module> build the named module
|
|
<module>.check run unittests of the named module
|
|
<module>.clean clean the named module
|
|
<module>.all build the named module and the pre-requisite modules for it
|
|
<module>.showdeliverables show the targets delivered to OUTDIR and their
|
|
source
|
|
cmd execute the command contained in the variable cmd=""
|
|
in a shell with config_host.mk or config_build.mk
|
|
environement set. (see gb_SIDE)
|
|
<target> build gbuild target (such as Library_vbaswobj or
|
|
CppunitTest_sw_macros_test)
|
|
<target>.clean clean gbuild target
|
|
<class>_<target> for all targets and for the following classes:
|
|
o AllLangResTarget
|
|
o AllLangZip
|
|
o CliLibrary
|
|
o CliNativeLibrary
|
|
o CliUnoApi
|
|
o Configuration
|
|
o CppunitTest
|
|
o CustomTarget
|
|
o Dictionary
|
|
o Executable
|
|
o Extension
|
|
o ExternalPackage
|
|
o ExternalProject
|
|
o Gallery
|
|
o Helper
|
|
o InstallModule
|
|
o InstallScript
|
|
o InternalUnoApi
|
|
o Jar
|
|
o JunitTest
|
|
o Library
|
|
o Package
|
|
o Pagein
|
|
o Pyuno
|
|
o Rdb
|
|
o StaticLibrary
|
|
o UI
|
|
o UnoApi
|
|
o UnpackedTarball
|
|
o WinResTarget
|
|
o Zip
|
|
|
|
INTERACTIVE VARIABLES:
|
|
DEBUG / debug If not empty, build as with --enable-debug.
|
|
ENABLE_SYMBOLS / enable_symbols
|
|
If not empty, build as with --enable-symbols.
|
|
DBGLEVEL / dbglevel
|
|
If not empty, force the debug level to the specified value. The
|
|
debug level is passed to the source code through OSL_DEBUG_LEVEL
|
|
macro.
|
|
0 = no debug (as with --disable-debug)
|
|
1 = debugging information + no optimizations (as with --enable-debug)
|
|
(Note that levels higher than 2 are used only by obsolete debugging
|
|
features. Use SAL_INFO/SAL_WARN with a specific area for extra debug
|
|
output in new code.)
|
|
2 = debugging information + no optimizations + extra
|
|
debug output. OSL_TRACE starts being active on this
|
|
level.
|
|
3... = debugging information + no optimizations + extra
|
|
debug output (usually extremely verbose). Levels
|
|
> 2 are not used very much.
|
|
TIMELOG / timelog
|
|
If not empty enable the RTL_LOGFILE_* time logging facility.
|
|
export RTL_LOGFILE=rtl_logfile.nopid when running office, to
|
|
get timestamps written out.
|
|
PARALLELISM If not empty, pass argument on as the -j switch
|
|
to recursive make invocations. Useful to
|
|
lower/increase build parallelism individually.
|
|
LEXFLAGS Add as flags for LEX scanner generator invocation.
|
|
YACCFLAGS Add as flags for YACC parser generator invocation.
|
|
CPPFLAGS Add as preprocessor flags for C/C++/ObjC/ObjC++ compilation.
|
|
CFLAGS Add as compiler flags for plain C compilation.
|
|
CXXFLAGS Add as compiler flags for C++ compilation.
|
|
OBJCFLAGS Add as compiler flags for Objective C compilation.
|
|
OBJCXXFLAGS Add as compiler flags for Objective C++ compilation.
|
|
LDFLAGS Add as linker flags.
|
|
gb_FULLDEPS Generate and use dependencies (on by default, handle with care).
|
|
gb_COLOR Use ASCII color output.
|
|
gb_TITLES Show progress in terminal title.
|
|
gb_Side Either "host" of "build" (default to "host").
|
|
determine if config_host.mk or config_build.mk is used to
|
|
set the build environment.
|