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