Subversion Repositories DevTools

Rev

Rev 335 | Rev 363 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 335 Rev 361
Line 1433... Line 1433...
1433 
#   Documentation
 1433 
#   Documentation
1434 
#
 1434 
#
1435 
 
 1435 
 
1436 
=pod
 1436 
=pod
1437 
 
 1437 
 
- 
 
 1438 
=for htmltoc    JATS::make
- 
 
 1439 
 
1438 
=head1 NAME
 1440 
=head1 NAME
1439 
 
 1441 
 
1440 
jmake - JATS make support tool
 1442 
jmake - JATS make support tool
1441 
 
 1443 
 
1442 
=head1 SYNOPSIS
 1444 
=head1 SYNOPSIS
Line 1463... Line 1465...
1463 
    debug               - build all things for debug (pu)
 1465 
    debug               - build all things for debug (pu)
1464 
    prod                - build all things for production (pu)
 1466 
    prod                - build all things for production (pu)
1465 
    install             - install public components (pu*)
 1467 
    install             - install public components (pu*)
1466 
    lint                - lints the source (assumes debug)(p)
 1468 
    lint                - lints the source (assumes debug)(p)
1467 
    package             - build all packages (pu*)
 1469 
    package             - build all packages (pu*)
1468 
    package-{set}       - build specific package (see below) (pu*)
 1470 
    package-[set]       - build specific package (see below) (pu*)
1469 
    run_tests           - Run the tests specified in the makefile
 1471 
    run_tests           - Run the tests specified in the makefile
1470 
    run_unit_tests      - Run the automatic unit tests specified in the makefile
 1472 
    run_unit_tests      - Run the automatic unit tests specified in the makefile
1471 
    deploy              - Run the deployment scripts (p*)
 1473 
    deploy              - Run the deployment scripts (p*)
1472 
    rebuild             - recursively rebuild makefiles
 1474 
    rebuild             - recursively rebuild makefiles
1473 
    depend              - construct the dependencies (u*)
 1475 
    depend              - construct the dependencies (u*)
Line 1479... Line 1481...
1479 
 
 1481 
 
1480 
      (u) undo target available (ie uninstall)
 1482 
      (u) undo target available (ie uninstall)
1481 
      (p) optional [platform_] prefix targets (ie XXX_build)
 1483 
      (p) optional [platform_] prefix targets (ie XXX_build)
1482 
      (*) optional [_debug|_prod] postfix targets (ie clean_debug)
 1484 
      (*) optional [_debug|_prod] postfix targets (ie clean_debug)
1483 
 
 1485 
 
1484 
 
 - 
 
1485 
=head1 OPTIONS
 1486 
=head1 OPTIONS
1486 
 
 1487 
 
1487 
=over 8
 1488 
=over 8
1488 
 
 1489 
 
1489 
=item B<-help>
 1490 
=item B<-help>
Line 1517... Line 1518...
1517 
program. This may be useful for advanced debugging of makefiles. These options
 1518 
program. This may be useful for advanced debugging of makefiles. These options
1518 
include:
 1519 
include:
1519 
 
 1520 
 
1520 
=over 8
 1521 
=over 8
1521 
 
 1522 
 
- 
 
 1523 
=item
- 
 
 1524 
 
1522 
=item   * -h     - Display Make's own help
 1525 
B<-h>     - Display Make's own help
- 
 
 1526 
 
- 
 
 1527 
=item
- 
 
 1528 
 
- 
 
 1529 
B<-d>     - Display diagnostic information
- 
 
 1530 
 
- 
 
 1531 
=item
1523 
 
 1532 
 
1524 
=item   * -d     - Display diagnostic information
 1533 
B<-p>     - Print make's internal database.
1525 
 
 1534 
 
1526 
=item   * -p     - Print make's internal database.
 1535 
=item
1527 
 
 1536 
 
1528 
=item   * -k     - Keep going when some targets can't be made.
 1537 
B<-k>     - Keep going when some targets can't be made.
1529 
 
 1538 
 
1530 
=back
 1539 
=back
1531 
 
 1540 
 
1532 
=back
 1541 
=back
1533 
 
 1542 
 
Line 1587... Line 1596...
1587 
=item B<OPTIONS=list,list>
 1596 
=item B<OPTIONS=list,list>
1588 
 
 1597 
 
1589 
This flags passes a list of comma seperated options into the makefile. The exact
 1598 
This flags passes a list of comma seperated options into the makefile. The exact
1590 
set of available options is target specific. Refer to the JATS manual.
 1599 
set of available options is target specific. Refer to the JATS manual.
1591 
 
 1600 
 
- 
 
 1601 
=back
- 
 
 1602 
 
- 
 
 1603 
=head1 EXAMPLES
- 
 
 1604 
 
- 
 
 1605 
=over 4
- 
 
 1606 
 
- 
 
 1607 
=item jats all
- 
 
 1608 
 
- 
 
 1609 
This command will perform a B<jats build> if the build.pl file has been modified
- 
 
 1610 
since the last build. It will then C<make> all the build targets.
- 
 
 1611 
 
- 
 
 1612 
=item jats make all
- 
 
 1613 
 
- 
 
 1614 
Same as C<jats all>
- 
 
 1615 
 
- 
 
 1616 
=item jats make debug
- 
 
 1617 
 
- 
 
 1618 
This command will create the B<debug> version of the make
- 
 
 1619 
components in the current directory - and referenced sub components.
- 
 
 1620 
 
- 
 
 1621 
=item jats make debug NODEPEND=1
- 
 
 1622 
 
- 
 
 1623 
Same as C<jats make debug> but the dependency generation phase will be
- 
 
 1624 
skipped. In a large build this will speed up the build, but there is an implicit
- 
 
 1625 
assumption that file changes do not result in more header or library files being
- 
 
 1626 
required. It will use the results of the previous C<make depend> phase.
- 
 
 1627 
 
- 
 
 1628 
=item jats make clean
- 
 
 1629 
 
- 
 
 1630 
This command will remove all object files, libraries, programs and any other
- 
 
 1631 
build artifacts created by the B<make> process.
- 
 
 1632 
 
- 
 
 1633 
=item jats make clobber
- 
 
 1634 
 
- 
 
 1635 
Similar to C<jats make clean> but it will also delete build artifacts from the
- 
 
 1636 
packaging directory.
1592 
 
 1637 
 
1593 
=back
 1638 
=back
- 
 
 1639 
 
- 
 
 1640 
=cut
- 
 
 1641