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



        my $active = displayHeader($fe, { showPath => 1 });
        if ($active) {
 
            #
            #   Determine build success tag file
            #   If the tag file exists, then see if any files in the package source are more
            #   recent than the tag file
            #
            my $mustBuild = 1;
            my $sigMatch = 0;
            my $tagFile = getPkgFingerPrintFile($fe);

 
Remaining lines are joined together to form a buildfilter
 
=back
 
=for comment ==================================================================
 
=head1 Create Sandbox
 
=head2 NAME
 
Create Sandbox

 
The create command simply places a known directory in the current directory.
This directory is used by the sandboxing process. It may be manually deleted, or
deleted with the 'delete' command.
 
=for comment ==================================================================
 
=head1 Populate Sandbox
 
=head2 NAME
 
Populate a Sandbox

packages that are required to build the packages in the sandbox. It will not
examine the dependents of these packages.
 
=back
 
=for comment ==================================================================
 
=head1 Delete Sandbox
 
=head2 NAME
 
Delete a sandbox

be executed anywhere within the sandbox.
 
Once the sandbox has been deleted, the user must remove the components within the
sandbox.
 
=for comment ==================================================================
 
=head1 Sandbox Information
 
=head2 NAME
 
Display Sandbox Information

This should be considered a debug option. Undocumented internal information will
be displayed.
 
=back
 
=for comment ==================================================================
 
The build infomation display will show the state of each package as a cryptic set of four characters within square brackets.
 
The first character may be one of:
 
=over 8

    jats sandbox buildfilter COBRA +PPC_603E
 or jats sandbox buildfilter COBRA PPC_603E
 
will set the buildfilter to be COBRA and PPC_603E
 
=for comment ==================================================================
 
=head1 Skip Build
 
=head2 NAME
 
Mark a package to be skipped during the build

    jats sandbox fingerprint -generate
 
will regenerate the fingerprint of the current package. Useful after trivial edits to 
enable the sandbox builder to bypass the package and not to rebuild it and all of its dependents.
 
=for comment ==================================================================
 
=head1 Command all
 
=head2 NAME
 
Build packages in the sandbox

 
Resume a failed build.
 
=back
 
=for comment ==================================================================
 
=head1 Command build
 
=head2 NAME
 
Build packages in the sandbox

 
Any arguments are passed to the 'make' phase of the process.
 
In practice, the 'sandbox all' command is quicker.
 
=for comment ==================================================================
 
=head1 Clean
 
=head2 NAME
 
Clean all sandbox components

sandbox.
 
The 'clobber' command will perform a 'jats clobber' in all components in the
sandbox.
 
=for comment ==================================================================
 
=head1 make
 
=head2 NAME
 
Make packages in the sandbox

The 'make' command will perform a 'make' operation in each of the packages
within the sandbox, in the correct build order.
 
Any arguments are passed to the 'make'.
 
=for comment ==================================================================
 
=head1 cmd
 
=head2 NAME
 
Process each package with a specified command.

external to the sandbox, although all version information in the build.pl
files will be updated.
 
    jats sandbox cmd upddep -rtagid=12345
 
=for comment ==================================================================
 
=head1 Cache
 
=head2 NAME
 
Cache dependent packages

 
This command allows the simple creation of a small development environment that
is not tied to the larger Development Environment. It may then be used in a
disconnected mode to perform development.
 
=for comment ==================================================================
 
=head1 Sandbox Test Links
 
=head2 NAME
 
Test and delete sandbox link files

 
    jats sandbox testlinks
 
will test the symbolic links in the sandbox metadata.
 
=for comment ==================================================================
 
=head1 Sandbox Scan Depth
 
=head2 NAME
 
Set and Display the build file scanner depth

Rev 7295	Rev 7326
Line 1501...	Line 1501...
1501	`my $active = displayHeader($fe, { showPath => 1 });`	1501	`my $active = displayHeader($fe, { showPath => 1 });`
1502	`if ($active) {`	1502	`if ($active) {`
1503		1503
1504	`#`	1504	`#`
1505	`# Determine build success tag file`	1505	`# Determine build success tag file`
1506	`# If the tag file exists, then see if any files in the files in the package source are more`	1506	`# If the tag file exists, then see if any files in the package source are more`
1507	`# recent than the tag file`	1507	`# recent than the tag file`
1508	`#`	1508	`#`
1509	`my $mustBuild = 1;`	1509	`my $mustBuild = 1;`
1510	`my $sigMatch = 0;`	1510	`my $sigMatch = 0;`
1511	`my $tagFile = getPkgFingerPrintFile($fe);`	1511	`my $tagFile = getPkgFingerPrintFile($fe);`
Line 2914...	Line 2914...
2914		2914
2915	`Remaining lines are joined together to form a buildfilter`	2915	`Remaining lines are joined together to form a buildfilter`
2916		2916
2917	`=back`	2917	`=back`
2918		2918
-		2919	`=for comment ==================================================================`
-		2920
2919	`=head1 Create Sandbox`	2921	`=head1 Create Sandbox`
2920		2922
2921	`=head2 NAME`	2923	`=head2 NAME`
2922		2924
2923	`Create Sandbox`	2925	`Create Sandbox`
Line 2966...	Line 2968...
2966		2968
2967	`The create command simply places a known directory in the current directory.`	2969	`The create command simply places a known directory in the current directory.`
2968	`This directory is used by the sandboxing process. It may be manually deleted, or`	2970	`This directory is used by the sandboxing process. It may be manually deleted, or`
2969	`deleted with the 'delete' command.`	2971	`deleted with the 'delete' command.`
2970		2972
-		2973	`=for comment ==================================================================`
-		2974
2971	`=head1 Populate Sandbox`	2975	`=head1 Populate Sandbox`
2972		2976
2973	`=head2 NAME`	2977	`=head2 NAME`
2974		2978
2975	`Populate a Sandbox`	2979	`Populate a Sandbox`
Line 3161...	Line 3165...
3161	`packages that are required to build the packages in the sandbox. It will not`	3165	`packages that are required to build the packages in the sandbox. It will not`
3162	`examine the dependents of these packages.`	3166	`examine the dependents of these packages.`
3163		3167
3164	`=back`	3168	`=back`
3165		3169
-		3170	`=for comment ==================================================================`
-		3171
3166	`=head1 Delete Sandbox`	3172	`=head1 Delete Sandbox`
3167		3173
3168	`=head2 NAME`	3174	`=head2 NAME`
3169		3175
3170	`Delete a sandbox`	3176	`Delete a sandbox`
Line 3184...	Line 3190...
3184	`be executed anywhere within the sandbox.`	3190	`be executed anywhere within the sandbox.`
3185		3191
3186	`Once the sandbox has been deleted, the user must remove the components within the`	3192	`Once the sandbox has been deleted, the user must remove the components within the`
3187	`sandbox.`	3193	`sandbox.`
3188		3194
-		3195	`=for comment ==================================================================`
-		3196
3189	`=head1 Sandbox Information`	3197	`=head1 Sandbox Information`
3190		3198
3191	`=head2 NAME`	3199	`=head2 NAME`
3192		3200
3193	`Display Sandbox Information`	3201	`Display Sandbox Information`
Line 3310...	Line 3318...
3310	`This should be considered a debug option. Undocumented internal information will`	3318	`This should be considered a debug option. Undocumented internal information will`
3311	`be displayed.`	3319	`be displayed.`
3312		3320
3313	`=back`	3321	`=back`
3314		3322
-		3323	`=for comment ==================================================================`
-		3324
3315	`The build infomation display will show the state of each package as a cryptic set of four characters within square brackets.`	3325	`The build infomation display will show the state of each package as a cryptic set of four characters within square brackets.`
3316		3326
3317	`The first character may be one of:`	3327	`The first character may be one of:`
3318		3328
3319	`=over 8`	3329	`=over 8`
Line 3441...	Line 3451...
3441	`jats sandbox buildfilter COBRA +PPC_603E`	3451	`jats sandbox buildfilter COBRA +PPC_603E`
3442	`or jats sandbox buildfilter COBRA PPC_603E`	3452	`or jats sandbox buildfilter COBRA PPC_603E`
3443		3453
3444	`will set the buildfilter to be COBRA and PPC_603E`	3454	`will set the buildfilter to be COBRA and PPC_603E`
3445		3455
-		3456	`=for comment ==================================================================`
-		3457
3446	`=head1 Skip Build`	3458	`=head1 Skip Build`
3447		3459
3448	`=head2 NAME`	3460	`=head2 NAME`
3449		3461
3450	`Mark a package to be skipped during the build`	3462	`Mark a package to be skipped during the build`
Line 3545...	Line 3557...
3545	`jats sandbox fingerprint -generate`	3557	`jats sandbox fingerprint -generate`
3546		3558
3547	`will regenerate the fingerprint of the current package. Useful after trivial edits to`	3559	`will regenerate the fingerprint of the current package. Useful after trivial edits to`
3548	`enable the sandbox builder to bypass the package and not to rebuild it and all of its dependents.`	3560	`enable the sandbox builder to bypass the package and not to rebuild it and all of its dependents.`
3549		3561
-		3562	`=for comment ==================================================================`
-		3563
3550	`=head1 Command all`	3564	`=head1 Command all`
3551		3565
3552	`=head2 NAME`	3566	`=head2 NAME`
3553		3567
3554	`Build packages in the sandbox`	3568	`Build packages in the sandbox`
Line 3611...	Line 3625...
3611		3625
3612	`Resume a failed build.`	3626	`Resume a failed build.`
3613		3627
3614	`=back`	3628	`=back`
3615		3629
-		3630	`=for comment ==================================================================`
-		3631
3616	`=head1 Command build`	3632	`=head1 Command build`
3617		3633
3618	`=head2 NAME`	3634	`=head2 NAME`
3619		3635
3620	`Build packages in the sandbox`	3636	`Build packages in the sandbox`
Line 3663...	Line 3679...
3663		3679
3664	`Any arguments are passed to the 'make' phase of the process.`	3680	`Any arguments are passed to the 'make' phase of the process.`
3665		3681
3666	`In practice, the 'sandbox all' command is quicker.`	3682	`In practice, the 'sandbox all' command is quicker.`
3667		3683
-		3684	`=for comment ==================================================================`
-		3685
3668	`=head1 Clean`	3686	`=head1 Clean`
3669		3687
3670	`=head2 NAME`	3688	`=head2 NAME`
3671		3689
3672	`Clean all sandbox components`	3690	`Clean all sandbox components`
Line 3702...	Line 3720...
3702	`sandbox.`	3720	`sandbox.`
3703		3721
3704	`The 'clobber' command will perform a 'jats clobber' in all components in the`	3722	`The 'clobber' command will perform a 'jats clobber' in all components in the`
3705	`sandbox.`	3723	`sandbox.`
3706		3724
-		3725	`=for comment ==================================================================`
-		3726
3707	`=head1 make`	3727	`=head1 make`
3708		3728
3709	`=head2 NAME`	3729	`=head2 NAME`
3710		3730
3711	`Make packages in the sandbox`	3731	`Make packages in the sandbox`
Line 3740...	Line 3760...
3740	`The 'make' command will perform a 'make' operation in each of the packages`	3760	`The 'make' command will perform a 'make' operation in each of the packages`
3741	`within the sandbox, in the correct build order.`	3761	`within the sandbox, in the correct build order.`
3742		3762
3743	`Any arguments are passed to the 'make'.`	3763	`Any arguments are passed to the 'make'.`
3744		3764
-		3765	`=for comment ==================================================================`
-		3766
3745	`=head1 cmd`	3767	`=head1 cmd`
3746		3768
3747	`=head2 NAME`	3769	`=head2 NAME`
3748		3770
3749	`Process each package with a specified command.`	3771	`Process each package with a specified command.`
Line 3805...	Line 3827...
3805	`external to the sandbox, although all version information in the build.pl`	3827	`external to the sandbox, although all version information in the build.pl`
3806	`files will be updated.`	3828	`files will be updated.`
3807		3829
3808	`jats sandbox cmd upddep -rtagid=12345`	3830	`jats sandbox cmd upddep -rtagid=12345`
3809		3831
-		3832	`=for comment ==================================================================`
-		3833
3810	`=head1 Cache`	3834	`=head1 Cache`
3811		3835
3812	`=head2 NAME`	3836	`=head2 NAME`
3813		3837
3814	`Cache dependent packages`	3838	`Cache dependent packages`
Line 3840...	Line 3864...
3840		3864
3841	`This command allows the simple creation of a small development environment that`	3865	`This command allows the simple creation of a small development environment that`
3842	`is not tied to the larger Development Environment. It may then be used in a`	3866	`is not tied to the larger Development Environment. It may then be used in a`
3843	`disconnected mode to perform development.`	3867	`disconnected mode to perform development.`
3844		3868
-		3869	`=for comment ==================================================================`
-		3870
3845	`=head1 Sandbox Test Links`	3871	`=head1 Sandbox Test Links`
3846		3872
3847	`=head2 NAME`	3873	`=head2 NAME`
3848		3874
3849	`Test and delete sandbox link files`	3875	`Test and delete sandbox link files`
Line 3889...	Line 3915...
3889		3915
3890	`jats sandbox testlinks`	3916	`jats sandbox testlinks`
3891		3917
3892	`will test the symbolic links in the sandbox metadata.`	3918	`will test the symbolic links in the sandbox metadata.`
3893		3919
-		3920	`=for comment ==================================================================`
-		3921
3894	`=head1 Sandbox Scan Depth`	3922	`=head1 Sandbox Scan Depth`
3895		3923
3896	`=head2 NAME`	3924	`=head2 NAME`
3897		3925
3898	`Set and Display the build file scanner depth`	3926	`Set and Display the build file scanner depth`

Subversion Repositories DevTools

(root)/core_devl/trunk/TOOLS/jats_sandbox.pl – Rev 7295 → 7326