WebSVN – DevTools – Diff – /core_devl/trunk/TOOLS/buildlib.pl



    #   In AutoBuildTool mode the entire interface directory
    #   will be deleted. This allows the build to be retried
    #
    if (  defined($::GBE_ABT) )   # clobber mode ?
    {
        if ( -d $ifdirname )
        {
                RmDirTree( $ifdirname );
        }
    }
 
    if ( $ifdirname eq "local" ) {
        mkpath ( "$ifdirname/inc" );

 
sub LinkClean
{
    if ( $BUILDINTERFACE )
    {                                           # only once
        # remove generated images
 
        Debug( "LinkClean" );
        foreach my $platform ( @BUILDPLATFORMS )
        {
            RmDirTree( "$BUILDINTERFACE/$platform.rul" );
        }
    }
}
 
 

        {
            next if ( $dir eq '.' );
            next if ( $dir eq '..' );
            if ( -d $dir )
            {
                RmDirTree ( $dir );
            }
        }
 
        foreach my $file ( @CLOBBERFILES )
        {
            if ( -f $file )
            {
                RmDirTree ( $file );
            }
        }
        
        #
        #   DPACKAGE may be a user file, Only delete it if we created it

sub BuildIncpkg
{
    StartBuildPhase();                          # Starting the build phase. No more data collection
    if ( $Clobber )                             # clobber mode ?
    {
        RmDirTree( "$Srcdir/incpkg" );
        return;
    }
 
    my $fh = ConfigurationFile::New( "$Srcdir/incpkg" );
    $fh->Header( "buildlib (Version $BuildVersion)",

#   Documentation
#
 
=pod
 
=for htmltoc    JATS::build
 
=head1 NAME
 
build - Build Environment and Makefiles
 
=head1 SYNOPSIS
 
jats build [options] [command]
 
     [perl buildlib.pl [options] PWD [command]]
 
 
 Options:
    -help          - Display terse usage
    -help -help    - Display verbose usage
    -man           - Display internal manual
    -verbose[=n]   - Set level of progress verbosity
    -debug[=n]     - Set the debug level
    -nolog         - Do not generate/update Changelog
    -cache         - Cache packages in the local dpkg_package cache
    -cache -cache  - Forced refresh dependent packages in the local cache
    -package       - Ignore packages that are not available and continue
    -forcebuildpkg - Treat LinkPkgArchive directives as BuildPkgArchive
                     Also suppress the use of symlinks so that the physical
                     file will be copied locally.
    -[no]force     - Force build even if build.pl is not newer
                      Default: -force
 
 Sticky settings:
    -all           - Build for all platforms ignoring GBE_BUILDFILTER
    -expert[=n]    - Relaxing dependency checks on the user makefiles
 
 Commands:
    changelog      - Only update ChangeLog.
    interface      - Only (re)build the interface tree, including ChangeLog.
    rootonly       - Only (re)build the root directory.
    clobber        - Remove generated build system (eg Makefiles).
 
 
=head1 OPTIONS
 
=over 8
 

 
This may be useful for:
 
=over 8
 
=item *
 
Remote Development
 
=item *
 
Collecting header files for scanning
 
=item *
 
Local modification of files for test/debug/development
 
=back
 
=item B<-[no]force>
 

The build.pl file must be invoked with one fixed arguments, followed by user
options and subcommands
 
=over 8
 
=item   1
 
The current working directory
 
This could have been derived directly by the program, rather than having it
passed in.
 
=item   2
 
Options and commands may follow the first two mandatory arguments.
 
=back
 
The build.pl file must 'require' the buildlib.pl and makelib.pl. The preferred
code is:

Rev 359	Rev 361
Line 1346...	Line 1346...
1346	`# In AutoBuildTool mode the entire interface directory`	1346	`# In AutoBuildTool mode the entire interface directory`
1347	`# will be deleted. This allows the build to be retried`	1347	`# will be deleted. This allows the build to be retried`
1348	`#`	1348	`#`
1349	`if ( defined($::GBE_ABT) ) # clobber mode ?`	1349	`if ( defined($::GBE_ABT) ) # clobber mode ?`
1350	`{`	1350	`{`
1351	`if ( -d "$ifdirname" )`	1351	`if ( -d $ifdirname )`
1352	`{`	1352	`{`
1353	`rmtree ( $ifdirname );`	1353	`RmDirTree( $ifdirname );`
1354	`}`	1354	`}`
1355	`}`	1355	`}`
1356		1356
1357	`if ( $ifdirname eq "local" ) {`	1357	`if ( $ifdirname eq "local" ) {`
1358	`mkpath ( "$ifdirname/inc" );`	1358	`mkpath ( "$ifdirname/inc" );`
Line 1567...	Line 1567...
1567		1567
1568	`sub LinkClean`	1568	`sub LinkClean`
1569	`{`	1569	`{`
1570	`if ( $BUILDINTERFACE )`	1570	`if ( $BUILDINTERFACE )`
1571	`{ # only once`	1571	`{ # only once`
1572	`Debug( "LinkClean" );`	1572	`# remove generated images`
1573		1573
-		1574	`Debug( "LinkClean" );`
1574	`foreach my $platform ( @BUILDPLATFORMS )`	1575	`foreach my $platform ( @BUILDPLATFORMS )`
1575	`{ # remove generated images`	1576	`{`
1576	`rmtree( "$BUILDINTERFACE/$platform.rul" );`	1577	`RmDirTree( "$BUILDINTERFACE/$platform.rul" );`
1577	`}`	1578	`}`
1578	`}`	1579	`}`
1579	`}`	1580	`}`
1580		1581
1581		1582
Line 3035...	Line 3036...
3035	`{`	3036	`{`
3036	`next if ( $dir eq '.' );`	3037	`next if ( $dir eq '.' );`
3037	`next if ( $dir eq '..' );`	3038	`next if ( $dir eq '..' );`
3038	`if ( -d $dir )`	3039	`if ( -d $dir )`
3039	`{`	3040	`{`
3040	`rmtree ( $dir );`	3041	`RmDirTree ( $dir );`
3041	`}`	3042	`}`
3042	`}`	3043	`}`
3043		3044
3044	`foreach my $file ( @CLOBBERFILES )`	3045	`foreach my $file ( @CLOBBERFILES )`
3045	`{`	3046	`{`
3046	`if ( -f $file )`	3047	`if ( -f $file )`
3047	`{`	3048	`{`
3048	`rmtree ( $file );`	3049	`RmDirTree ( $file );`
3049	`}`	3050	`}`
3050	`}`	3051	`}`
3051		3052
3052	`#`	3053	`#`
3053	`# DPACKAGE may be a user file, Only delete it if we created it`	3054	`# DPACKAGE may be a user file, Only delete it if we created it`
Line 3317...	Line 3318...
3317	`sub BuildIncpkg`	3318	`sub BuildIncpkg`
3318	`{`	3319	`{`
3319	`StartBuildPhase(); # Starting the build phase. No more data collection`	3320	`StartBuildPhase(); # Starting the build phase. No more data collection`
3320	`if ( $Clobber ) # clobber mode ?`	3321	`if ( $Clobber ) # clobber mode ?`
3321	`{`	3322	`{`
3322	`rmtree( "$Srcdir/incpkg" );`	3323	`RmDirTree( "$Srcdir/incpkg" );`
3323	`return;`	3324	`return;`
3324	`}`	3325	`}`
3325		3326
3326	`my $fh = ConfigurationFile::New( "$Srcdir/incpkg" );`	3327	`my $fh = ConfigurationFile::New( "$Srcdir/incpkg" );`
3327	`$fh->Header( "buildlib (Version $BuildVersion)",`	3328	`$fh->Header( "buildlib (Version $BuildVersion)",`
Line 3918...	Line 3919...
3918	`# Documentation`	3919	`# Documentation`
3919	`#`	3920	`#`
3920		3921
3921	`=pod`	3922	`=pod`
3922		3923
-		3924	`=for htmltoc JATS::build`
-		3925
3923	`=head1 NAME`	3926	`=head1 NAME`
3924		3927
3925	`jats sandbox bootstrap`	3928	`build - Build Environment and Makefiles`
3926		3929
3927	`=head1 SYNOPSIS`	3930	`=head1 SYNOPSIS`
3928		3931
3929	`jats build [options] [command]`	3932	`jats build [options] [command]`
3930		3933
3931	`[perl buildlib.pl [options] PWD [command]]`	3934	`[perl buildlib.pl [options] PWD [command]]`
3932		3935
3933		-
3934	`Options:`	3936	`Options:`
3935	`-help - Display terse usage`	3937	`-help - Display terse usage`
3936	`-help -help - Display verbose usage`	3938	`-help -help - Display verbose usage`
3937	`-man - Display internal manual`	3939	`-man - Display internal manual`
3938	`-verbose[=n] - Set level of progress verbosity`	3940	`-verbose[=n] - Set level of progress verbosity`
3939	`-debug[=n] - Set the debug level`	3941	`-debug[=n] - Set the debug level`
3940	`-nolog - Do not generate/update Changelog`	3942	`-nolog - Do not generate/update Changelog`
3941	`-cache - Cache packages in the local dpkg_package cache`	3943	`-cache - Cache packages in the local dpkg_package cache`
3942	`-cache -cache - Forced refresh dependent packages in the local cache`	3944	`-cache -cache - Forced refresh dependent packages in the local cache`
3943	`-package - Ignore packages that are not available and continue`	3945	`-package - Ignore packages that are not available and continue`
3944	`-forcebuildpkg - Treat LinkPkgArchive directives as BuildPkgArchive`	3946	`-forcebuildpkg - Treat LinkPkgArchive directives as BuildPkgArchive`
3945	`Also suppress the use of symlinks so that the phsical`	3947	`Also suppress the use of symlinks so that the physical`
3946	`file will be copied locally.`	3948	`file will be copied locally.`
3947	`-[no]force - Force build even if build.pl is not newer`	3949	`-[no]force - Force build even if build.pl is not newer`
3948	`Default: -force`	3950	`Default: -force`
3949		3951
3950	`Sticky settings:`	3952	`Sticky settings:`
3951	`-all - Build for all platforms ignoring GBE_BUILDFILTER`	3953	`-all - Build for all platforms ignoring GBE_BUILDFILTER`
3952	`-expert[=n] - Relaxing dependency checks on the user makefiles`	3954	`-expert[=n] - Relaxing dependency checks on the user makefiles`
3953		3955
3954	`Commands:`	3956	`Commands:`
3955	`changelog - Only update ChangeLog.`	3957	`changelog - Only update ChangeLog.`
3956	`interface - Only (re)build the interface tree, including ChangeLog.`	3958	`interface - Only (re)build the interface tree, including ChangeLog.`
3957	`rootonly - Only (re)build the root directory.`	3959	`rootonly - Only (re)build the root directory.`
3958	`clobber - Remove generated build system (eg Makefiles).`	3960	`clobber - Remove generated build system (eg Makefiles).`
3959		-
3960		3961
3961	`=head1 OPTIONS`	3962	`=head1 OPTIONS`
3962		3963
3963	`=over 8`	3964	`=over 8`
3964		3965
Line 4018...	Line 4019...
4018		4019
4019	`This may be useful for:`	4020	`This may be useful for:`
4020		4021
4021	`=over 8`	4022	`=over 8`
4022		4023
4023	`=item * Remote Development`	4024	`=item *`
4024		4025
4025	`=item * Collecting header files for scanning`	4026	`Remote Development`
4026		4027
-		4028	`=item *`
-		4029
-		4030	`Collecting header files for scanning`
-		4031
-		4032	`=item *`
-		4033
4027	`=item * Local modification of files for test/debug/development`	4034	`Local modification of files for test/debug/development`
4028		4035
4029	`=back`	4036	`=back`
4030		4037
4031	`=item B<-[no]force>`	4038	`=item B<-[no]force>`
4032		4039
Line 4112...	Line 4119...
4112	`The build.pl file must be invoked with one fixed arguments, followed by user`	4119	`The build.pl file must be invoked with one fixed arguments, followed by user`
4113	`options and subcommands`	4120	`options and subcommands`
4114		4121
4115	`=over 8`	4122	`=over 8`
4116		4123
-		4124	`=item 1`
-		4125
4117	`=item 1 The current working directory`	4126	`The current working directory`
4118		4127
4119	`This could have been derived directly by the program, rather than having it`	4128	`This could have been derived directly by the program, rather than having it`
4120	`passed in.`	4129	`passed in.`
4121		4130
-		4131	`=item 2`
-		4132
4122	`=item 2 Options and commands may follow the first two mandatory arguments.`	4133	`Options and commands may follow the first two mandatory arguments.`
4123		4134
4124	`=back`	4135	`=back`
4125		4136
4126	`The build.pl file must 'require' the buildlib.pl and makelib.pl. The preferred`	4137	`The build.pl file must 'require' the buildlib.pl and makelib.pl. The preferred`
4127	`code is:`	4138	`code is:`

Subversion Repositories DevTools

(root)/core_devl/trunk/TOOLS/buildlib.pl – Rev 359 → 361