Subversion Repositories DevTools

Rev

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

Rev 351 Rev 361
Line 848... Line 848...
848
    if ( $opt_extract_files )
848
    if ( $opt_extract_files )
849
    {
849
    {
850
        if ( -d $VIEWDIR )
850
        if ( -d $VIEWDIR )
851
        {
851
        {
852
            Message("Remove extracted files: $VIEWTAG");
852
            Message("Remove extracted files: $VIEWTAG");
853
            rmtree( $VIEWDIR );
853
            RmDirTree( $VIEWDIR );
854
        }
854
        }
855
    }
855
    }
856
    else
856
    else
857
    {
857
    {
858
        #
858
        #
Line 910... Line 910...
910
            ClearTool( 'rmview', $VIEWDIR );
910
            ClearTool( 'rmview', $VIEWDIR );
911
 
911
 
912
            #
912
            #
913
            #   Now try to delete the directory
913
            #   Now try to delete the directory
914
            #
914
            #
915
            rmtree( $VIEWDIR );
915
            RmDirTree( $VIEWDIR );
916
        }
916
        }
917
 
917
 
918
        #
918
        #
919
        #   If the view tag still exists then delete the view the hard way
919
        #   If the view tag still exists then delete the view the hard way
920
        #   Use 'lsview' to locate the views uuid
920
        #   Use 'lsview' to locate the views uuid
Line 1180... Line 1180...
1180
    #       Create the config spec in that directory
1180
    #       Create the config spec in that directory
1181
    #
1181
    #
1182
    Verbose("Extracting files into $VIEWDIR");
1182
    Verbose("Extracting files into $VIEWDIR");
1183
    if ( -d $VIEWDIR )
1183
    if ( -d $VIEWDIR )
1184
    {
1184
    {
1185
        Verbose "Delete Directory: $VIEWDIR\n";
1185
        Verbose "Delete existing directory: $VIEWDIR";
1186
        rmtree( $VIEWDIR );
1186
        RmDirTree( $VIEWDIR );
1187
    }
1187
    }
1188
 
1188
 
1189
    #
1189
    #
1190
    #   Which config spec
1190
    #   Which config spec
1191
    #   If we need to create it, do it within the final view
1191
    #   If we need to create it, do it within the final view
Line 1334... Line 1334...
1334
#   Documentation
1334
#   Documentation
1335
#
1335
#
1336
 
1336
 
1337
=pod
1337
=pod
1338
 
1338
 
-
 
1339
=for htmltoc    GENERAL::ClearCase::
-
 
1340
 
1339
=head1 NAME
1341
=head1 NAME
1340
 
1342
 
1341
jats_ccrelease - Build a package given a clearcase label
1343
jats_ccrelease - Build a package given a clearcase label
1342
 
1344
 
1343
=head1 SYNOPSIS
1345
=head1 SYNOPSIS
Line 1401... Line 1403...
1401
=item B<-view name>
1403
=item B<-view name>
1402
 
1404
 
1403
Specified an alternate view name and tag to be used. This option does not provide the
1405
Specified an alternate view name and tag to be used. This option does not provide the
1404
full name of the view.
1406
full name of the view.
1405
 
1407
 
1406
    The view tag will be : "${USER}_${MACHINENAME}_${TAG}_${NAME}"
1408
The view tag will be : "${USER}_${MACHINENAME}_${TAG}_${NAME}"
-
 
1409
 
1407
    The view path will be: "${USER}_${NAME}"
1410
The view path will be: "${USER}_${NAME}"
1408
 
1411
 
1409
The default "NAME" is the first label specified.
1412
The default "NAME" is the first label specified.
1410
The default "TAG" is build. See B<-tag=tagname>.
1413
The default "TAG" is build. See B<-tag=tagname>.
1411
 
1414
 
1412
If the user provides a view "name" that is prefixed with their user name
1415
If the user provides a view "name" that is prefixed with their user name
Line 1475... Line 1478...
1475
command line. It overides the value of GBE_VIEWBASE.
1478
command line. It overides the value of GBE_VIEWBASE.
1476
 
1479
 
1477
If the comamnd is invoked within a development sandbox, then the default
1480
If the comamnd is invoked within a development sandbox, then the default
1478
location will be the root directory of the development sandbox.
1481
location will be the root directory of the development sandbox.
1479
 
1482
 
1480
=back
-
 
1481
 
-
 
1482
=item B<-latestroot=xxx>
1483
=item B<-latestroot=xxx>
1483
 
1484
 
1484
This option enables a work around for a bad-labelling practice that has existed
1485
This option enables a work around for a bad-labelling practice that has existed
1485
in the past. This LATEST version of the named (xxx) branch will be added to
1486
in the past. This LATEST version of the named (xxx) branch will be added to
1486
the config spec used to create the view.
1487
the config spec used to create the view.
Line 1505... Line 1506...
1505
check for its existence.
1506
check for its existence.
1506
 
1507
 
1507
The use of this switch will add the following lines to the config spec:
1508
The use of this switch will add the following lines to the config spec:
1508
 
1509
 
1509
    element * .../xxx/LATEST
1510
    element * .../xxx/LATEST
1510
    element * {label} -mkbranch xxx
1511
    element * label -mkbranch xxx
1511
    element * /main/0 -mkbranch xxx
1512
    element * /main/0 -mkbranch xxx
1512
 
1513
 
1513
=item B<-config=config_spec>
1514
=item B<-config=config_spec>
1514
 
1515
 
1515
This option is an alternate mechanism to create a static view. The view will be
1516
This option is an alternate mechanism to create a static view. The view will be
Line 1522... Line 1523...
1522
    -label
1523
    -label
1523
    -branch
1524
    -branch
1524
    -path
1525
    -path
1525
    -vob
1526
    -vob
1526
 
1527
 
1527
 
-
 
1528
=item B<-tag=text>
1528
=item B<-tag=text>
1529
 
1529
 
1530
This option alters the ClearCase view tag created for the view. It allows
1530
This option alters the ClearCase view tag created for the view. It allows
1531
the creation of multiple views based on the same label. Intended to be used in
1531
the creation of multiple views based on the same label. Intended to be used in
1532
the automated build system to create unique views tags.
1532
the automated build system to create unique views tags.
Line 1561... Line 1561...
1561
 
1561
 
1562
Note: Ensure that no files are open in the view and that the users current
1562
Note: Ensure that no files are open in the view and that the users current
1563
working directory is not in the view as these will prevent the view from being
1563
working directory is not in the view as these will prevent the view from being
1564
deleted.
1564
deleted.
1565
 
1565
 
1566
 
-
 
1567
=item B<-debugOnly>
1566
=item B<-debugOnly>
1568
 
1567
 
1569
Make only the debug version of the package. The default it to create both the
1568
Make only the debug version of the package. The default it to create both the
1570
debug and production version of the package. The type of build may be  further
1569
debug and production version of the package. The type of build may be  further
1571
limited by options within the package.
1570
limited by options within the package.
Line 1591... Line 1590...
1591
 
1590
 
1592
This flag allows the view created by the program to be re-used.
1591
This flag allows the view created by the program to be re-used.
1593
 
1592
 
1594
=over 8
1593
=over 8
1595
 
1594
 
-
 
1595
=item *
-
 
1596
 
1596
=item 1. The view is not deleted before being populated.
1597
The view is not deleted before being populated.
-
 
1598
 
-
 
1599
=item *
-
 
1600
 
-
 
1601
The view will not be populated if it does exist.
1597
 
1602
 
1598
=item 2. The view will not be populated if it does exist.
1603
=item *
1599
 
1604
 
1600
=item 3. The view will not be deleted at the end the process.
1605
The view will not be deleted at the end the process.
1601
 
1606
 
1602
=back
1607
=back
1603
 
1608
 
1604
This option is useful for debugging a build process.
1609
This option is useful for debugging a build process.
1605
 
1610
 
Line 1708... Line 1713...
1708
various tests are performed to ensure the repeatability of the view and the
1713
various tests are performed to ensure the repeatability of the view and the
1709
build. These tests include:
1714
build. These tests include:
1710
 
1715
 
1711
=over 8
1716
=over 8
1712
 
1717
 
-
 
1718
=item   *
-
 
1719
 
1713
=item   * The view must be constructed from one label
1720
The view must be constructed from one label
-
 
1721
 
-
 
1722
=item   *
1714
 
1723
 
1715
=item   * That label must be locked
1724
That label must be locked
1716
 
1725
 
-
 
1726
=item   *
-
 
1727
 
1717
=item   * The labelled view must contain exactly one build file
1728
The labelled view must contain exactly one build file
-
 
1729
 
-
 
1730
=item   *
1718
 
1731
 
1719
=item   * The view cannot have been re-used.
1732
The view cannot have been re-used.
1720
 
1733
 
1721
=back
1734
=back
1722
 
1735
 
1723
=item Locate build files
1736
=item Locate build files
1724
 
1737