| Line 89... |
Line 89... |
| 89 |
#
|
89 |
#
|
| 90 |
my %composite_commands = (
|
90 |
my %composite_commands = (
|
| 91 |
#
|
91 |
#
|
| 92 |
# Composite commands
|
92 |
# Composite commands
|
| 93 |
#
|
93 |
#
|
| 94 |
'all' => [ 'install', 'package', 'deploy' ] ,
|
- |
|
| 95 |
'install' => [ 'build' ] ,
|
- |
|
| 96 |
'build' => [ 'mkdepends', 'generate', 'install_hdr', 'depend',
|
- |
|
| 97 |
'make_lib', 'install_lib', 'make_install_shlib',
|
- |
|
| 98 |
'make_prog', 'make_test', 'install_prog', 'install_class' ] ,
|
- |
|
| 99 |
'lint' => [ 'mkdepends', 'generate_debug', 'install_hdr_debug',
|
94 |
'lint' => [ 'mkdepends', 'generate_debug', 'install_hdr_debug',
|
| 100 |
'lint_lib', 'lint_shlib', 'lint_prog' ] ,
|
95 |
'lint_lib', 'lint_shlib', 'lint_prog' ] ,
|
| 101 |
'ctags' => [ 'mkdepends', 'generate_debug', 'ctags_debug' ] ,
|
96 |
'ctags' => [ 'mkdepends', 'generate_debug', 'ctags_debug' ] ,
|
| 102 |
'test' => [ 'make_test' ] ,
|
97 |
'test' => [ 'make_test' ] ,
|
| 103 |
'mkdepends' => [ 'makefiles', 'make_init'] ,
|
98 |
'mkdepends' => [ 'makefiles', 'make_init'] ,
|
| 104 |
'run_tests' => [ 'preprocess_tests', 'exec_tests',
|
99 |
'run_tests' => [ 'preprocess_tests', 'exec_tests',
|
| 105 |
'postprocess_tests', 'collate_test_results' ] ,
|
100 |
'postprocess_tests', 'collate_test_results' ] ,
|
| 106 |
'run_unit_tests' => [ 'preprocess_tests', 'exec_unit_tests',
|
101 |
'run_unit_tests' => [ 'preprocess_tests', 'exec_unit_tests',
|
| 107 |
'postprocess_tests', 'collate_test_results' ] ,
|
102 |
'postprocess_tests', 'collate_test_results' ] ,
|
| - |
|
103 |
# Convenient phases of the build
|
| - |
|
104 |
'hdrs' => [ 'mkdepends', 'generate', 'install_hdr'],
|
| - |
|
105 |
'libs' => [ 'hdrs', 'depend', 'make_lib', 'install_lib'],
|
| - |
|
106 |
'slibs' => [ 'libs', 'make_install_shlib'],
|
| - |
|
107 |
'progs' => [ 'slibs', 'make_prog', 'make_test', 'install_prog', 'install_class'],
|
| - |
|
108 |
'build' => [ 'progs'],
|
| 108 |
|
- |
|
| - |
|
109 |
'install' => [ 'build' ] ,
|
| - |
|
110 |
'all' => [ 'install', 'package', 'deploy' ] ,
|
| 109 |
);
|
111 |
);
|
| 110 |
|
112 |
|
| 111 |
my %commands = (
|
113 |
my %commands = (
|
| 112 |
#
|
114 |
#
|
| 113 |
# Basic commands / phases of the build process
|
115 |
# Basic commands / phases of the build process
|
| Line 1559... |
Line 1561... |
| 1559 |
all - build and install everything(p*)
|
1561 |
all - build and install everything(p*)
|
| 1560 |
build - build everything (pu)
|
1562 |
build - build everything (pu)
|
| 1561 |
debug - build all things for debug (pu)
|
1563 |
debug - build all things for debug (pu)
|
| 1562 |
prod - build all things for production (pu)
|
1564 |
prod - build all things for production (pu)
|
| 1563 |
install - install public components (pu*)
|
1565 |
install - install public components (pu*)
|
| - |
|
1566 |
ctags - Generate ctags over the source (assumes debug)(p)
|
| 1564 |
lint - lints the source (assumes debug)(p)
|
1567 |
lint - lints the source (assumes debug)(p)
|
| 1565 |
package - build all packages (pu*)
|
1568 |
package - build all packages (pu*)
|
| 1566 |
package-[set] - build specific package (see below) (pu*)
|
1569 |
package-[set] - build specific package (see below) (pu*)
|
| 1567 |
run_tests - Run the tests specified in the makefile
|
1570 |
run_tests - Run the tests specified in the makefile
|
| 1568 |
run_unit_tests - Run the automatic unit tests specified in the makefile
|
1571 |
run_unit_tests - Run the automatic unit tests specified in the makefile
|
| Line 1573... |
Line 1576... |
| 1573 |
rmlitter - remove build litter (core, tmp and err) (*)
|
1576 |
rmlitter - remove build litter (core, tmp and err) (*)
|
| 1574 |
clean - delete generate, obj, libraries and programs (p*)
|
1577 |
clean - delete generate, obj, libraries and programs (p*)
|
| 1575 |
clobber - delete everything which can be remade (p*)
|
1578 |
clobber - delete everything which can be remade (p*)
|
| 1576 |
help - A list of platforms and aliases
|
1579 |
help - A list of platforms and aliases
|
| 1577 |
show - A list of platforms, alias, and makefile paths
|
1580 |
show - A list of platforms, alias, and makefile paths
|
| - |
|
1581 |
Partial Builds
|
| - |
|
1582 |
hdrs - build to the headers phase (p*)
|
| - |
|
1583 |
libs - build to the static library stage (p*)
|
| - |
|
1584 |
slibs - build to the shared librray stage (p*)
|
| - |
|
1585 |
progs - build to the progs stage (p*)
|
| 1578 |
|
1586 |
|
| 1579 |
(u) undo target available (ie uninstall)
|
1587 |
(u) undo target available (ie uninstall)
|
| 1580 |
(p) optional [platform_] prefix targets (ie XXX_build)
|
1588 |
(p) optional [platform_] prefix targets (ie XXX_build)
|
| 1581 |
(*) optional [_debug|_prod] postfix targets (ie clean_debug)
|
1589 |
(*) optional [_debug|_prod] postfix targets (ie clean_debug)
|
| 1582 |
|
1590 |
|
| Line 1661... |
Line 1669... |
| 1661 |
Many targets operations can be limited toi either production of debug by
|
1669 |
Many targets operations can be limited toi either production of debug by
|
| 1662 |
adding '_prod' or '_debug' to the target. ie 'install_debug'
|
1670 |
adding '_prod' or '_debug' to the target. ie 'install_debug'
|
| 1663 |
|
1671 |
|
| 1664 |
=back
|
1672 |
=back
|
| 1665 |
|
1673 |
|
| - |
|
1674 |
=head1 PARTIAL BUILDS
|
| - |
|
1675 |
|
| - |
|
1676 |
Partial build targets allow the build process to be partialy completed. This may be of use during development.
|
| - |
|
1677 |
|
| - |
|
1678 |
The partial build phases are:
|
| - |
|
1679 |
|
| - |
|
1680 |
=over 4
|
| - |
|
1681 |
|
| - |
|
1682 |
=item hdrs
|
| - |
|
1683 |
|
| - |
|
1684 |
Generate header files. Install header files locally.
|
| - |
|
1685 |
|
| - |
|
1686 |
=item libs
|
| - |
|
1687 |
|
| - |
|
1688 |
Previous step plus build static libraries, merge static librarys and install static libraries locally.
|
| - |
|
1689 |
|
| - |
|
1690 |
=item slib
|
| - |
|
1691 |
|
| - |
|
1692 |
Previous step plus build shared libraries and install shared libraries.
|
| - |
|
1693 |
|
| - |
|
1694 |
=item progs
|
| - |
|
1695 |
|
| - |
|
1696 |
Previous step plus build programs and install programs (including test programs). This step is the same as 'build'.
|
| - |
|
1697 |
|
| - |
|
1698 |
=back
|
| - |
|
1699 |
|
| 1666 |
=head1 FLAGS
|
1700 |
=head1 FLAGS
|
| 1667 |
|
1701 |
|
| 1668 |
Flags are in the form TAG=value. This is a format that it used as they will be
|
1702 |
Flags are in the form TAG=value. This is a format that it used as they will be
|
| 1669 |
passed directly to the underlying makefiles. The recognised flags are:
|
1703 |
passed directly to the underlying makefiles. The recognised flags are:
|
| 1670 |
|
1704 |
|