Development/buildsystemtargets
From The Document Foundation Wiki
Buildsystem targets
Contents |
status quo
There are currently these targets in our buildsystems:
gbuild
- all -- just build
- check -- PHONY in-build unit tests (not requiring a full install)
- subsequentcheck -- PHONY checks requiring a full install
- all check -- (default goal)
top-level Makefile
- all -- just build an installset
- install -- install the installset in /usr/local
- distro-pack-install -- ?
- dev-install -- development install into solver
- distclean -- clean up config
- clean -- clean up build
- fetch -- download external tarballs
- check -- run checks requiring a full install
- id -- generate GNU id utils index file
- tags -- generate ctags index file
- doc -- generate doxygen source code documentation
- findunusedcode -- find unused code
- helper targets:
- dmake -- make dmake
- src.downloaded -- download external tarballs
- Makefile -- for autotools foo
build.pl
- <plain> -- build module
- --all -- build up to module
Intended unification
gbuild
- build -- only build, dont test
- unitcheck -- PHONY run unittests (not requiring a full install)
- subsequentcheck -- PHONY run subsequentchecks (requiring a full install)
- check:
- in module: unitcheck
- outside module: unitcheck and subsequentcheck
- all -- build and unitcheck (default target)
top-level Makefile
- build -- just build an installset without unittests
- unitcheck -- PHONY run unittests (not requiring a full install)
- subsequentcheck -- PHONY run subsequentchecks (requiring a full install)
- check -- unitcheck and subsequentcheck
- dev-install -- development install into solver
- all -- build and unitcheck (default target)
- unchanged:
- dmake -- make dmake
- src.downloaded -- download external tarballs
- Makefile -- for autotools foo
- id -- generate GNU idutils index file
- tags -- generate ctags index file
- doc -- generate doxygen source code documentation
- findunusedcode -- find unused code
- distclean -- clean up config
- clean -- clean up build
- fetch -- download external tarballs
- install -- install the installset in /usr/local
- distro-pack-install -- ?
possible problems with the new setup / notes
- "make && make check" runs unittests twice -- if you want to separate checks from pure build, run "make build && make check"
- the new setup is careful about safe deps. You can skip duplication by using "-o": "make build && make dev-install -o build" should do no duplication.
- "make help" in gbuild has been updated
- old dmake modules still build their unittests in "make build" and not in "make unitcheck"