[Libreoffice-commits] .: Makefile solenv/gbuild
Norbert Thiebaud
nthiebaud at kemper.freedesktop.org
Wed Feb 8 08:16:45 PST 2012
Makefile | 9 ++++
solenv/gbuild/gbuild.help.txt | 76 +++++++++++++++++++++++++++++++++++++++
solenv/gbuild/gbuild.mk | 81 ------------------------------------------
3 files changed, 86 insertions(+), 80 deletions(-)
New commits:
commit d85a108a1b37b9dbaf151d4141e21674ab53f569
Author: Norbert Thiebaud <nthiebaud at gmail.com>
Date: Wed Feb 8 10:16:23 2012 -0600
re-enable make help from the top-level make
diff --git a/Makefile b/Makefile
index 45b7053..24b2a5b 100644
--- a/Makefile
+++ b/Makefile
@@ -440,4 +440,13 @@ debugrun:
endif # not clean or distclean
+#########################
+# help
+#
+.PHONY: help
+help:
+ @cat $(SRCDIR)/solenv/gbuild/gbuild.help.txt
+ @true
+
+
# vim: set noet sw=4 ts=4:
diff --git a/solenv/gbuild/gbuild.help.txt b/solenv/gbuild/gbuild.help.txt
new file mode 100644
index 0000000..d93285f
--- /dev/null
+++ b/solenv/gbuild/gbuild.help.txt
@@ -0,0 +1,76 @@
+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
+ subsequentcheck run system tests (requires full installation)
+ check run unit tests and if in toplevel subsequentcheck
+ clean remove all generated files
+ showdeliverables show the targets delivered to OUTDIR and their source
+ debugrun starts the dev-install instance and allows tests to be run
+ against it
+ <module> build the named module
+ <module>.clean clean the named module
+ <module>.all for dmake modules only, build the named module and
+ the pre-requisite modules for this module
+ <module>.deliver for dmake modules only, deliver the named module
+ 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)
+
+INTERACTIVE VARIABLES:
+ DEBUG / debug If not empty, build with DBGLEVEL=1 (see below).
+ ENABLE_SYMBOLS / enable_symbols
+ If not empty, build with debug symbols. Automatically
+ enabled by DEBUG/debug.
+ 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
+ 1 = symbols + no optimizations
+ 2 = symbols + no optimizations + extra debug output. OSL_TRACE
+ starts being active on this level.
+ 3... = symbols + no optimizations + extra debug output (usually
+ extremely verbose). Levels > 2 are not used very much.
+
+ 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.
diff --git a/solenv/gbuild/gbuild.mk b/solenv/gbuild/gbuild.mk
index 1658704..65d5a80 100644
--- a/solenv/gbuild/gbuild.mk
+++ b/solenv/gbuild/gbuild.mk
@@ -330,88 +330,9 @@ gb_PYTHONTARGET := $(OUTDIR)/bin/python
gb_PYTHON := $(gb_PYTHON_PRECOMMAND) $(gb_PYTHONTARGET)
endif
-define gb_HelpMessage
-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
- subsequentcheck run system tests (requires full installation)
- check run unit tests and if in toplevel subsequentcheck
- clean remove all generated files
- showdeliverables show the targets delivered to OUTDIR and their source
- debugrun starts the dev-install instance and allows tests to be run
- against it
- <module> build the named module
- <module>.clean clean the named module
- <module>.all for dmake modules only, build the named module and
- the pre-requisite modules for this module
- <module>.deliver for dmake modules only, deliver the named module
- 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)
-
-INTERACTIVE VARIABLES:
- DEBUG / debug If not empty, build with DBGLEVEL=1 (see below).
- ENABLE_SYMBOLS / enable_symbols
- If not empty, build with debug symbols. Automatically
- enabled by DEBUG/debug.
- 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
- 1 = symbols + no optimizations
- 2 = symbols + no optimizations + extra debug output. OSL_TRACE
- starts being active on this level.
- 3... = symbols + no optimizations + extra debug output (usually
- extremely verbose). Levels > 2 are not used very much.
-
- 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.
-endef
-
.PHONY: help
help:
- $(info $(gb_HelpMessage))
+ @cat $(SRCDIR)/solenv/gbuild/gbuild.help.txt
@true
# vim: set noet sw=4:
More information about the Libreoffice-commits
mailing list