1879N/A# Copyright 2001-2002 Sun Microsystems, Inc. All rights reserved.
0N/A# Use is subject to license terms.
0N/A#ident "%Z%%M% %I% %E% SMI"
0N/AThis directory contains utilities that help port and patch a standard perl
0N/A5.6.1 build directory into the ON tree. It is hoped that future ports and
0N/Apatches will be able to use the same framework, so details of the process used
0N/Afor 5.6.1 are documented here.
0N/AGenerate a
config.sh file for both the sparc and i386 architectures. To do
0N/Athis, unpack perl 5.6.1 and then run the ConfigPerl script from inside the
1472N/Adirectory, then run 'make; make test' in the 5.6.1 directory. The resulting
1472N/Aconfig.sh file is then copied to the appropriate sparc or i386 subdirectory.
0N/AGenerate sorted lists of all the files in a stock perl 5.005_03 build
0N/Adirectory, the Solaris 8 perl 5.005_03 directory and a stock perl 5.6.1
0N/Adirectory. These are the files flist.500503,
flist.s8 and flist.561
91N/AUse the Flist script to produce a CSV file containing a first-pass attempt at
2080N/Afiguring out the mappings between a stock 5.6.1 directory and a Solaris 9 perl
0N/A5.6.1 directory. The vast bulk of these mappings are correct, but minor edits
0N/Afor new files or files that were incorrectly included in 5.005_03 will be
0N/ALoad the resulting file (
Flist.csv) into a spreadsheet and manually enter
0N/Aand/or correct the details for the mappings as necessary.
0N/AUse the mkcopy script to generate a ksh script which will copy all the required
0N/Afiles from a stock 5.6.1 directory into an ON workspace and issue the necessary
0N/ASCCS and Teamware commands to check them in.
2080N/AVerify that the resulting script looks sane, then run it to perform the
0N/Aintegration. Examine the output to make sure that the integration succeeded -
0N/Aif it failed, go back to step 4.
1879N/AGenerate the makefiles and associated infrastructure to build the resulting
1879N/Aperl 5.6.1 workspace. If there are any missing files or other errors, go back
0N/AOn both sparc and intel run the ConfigPerl script in the stock 5.6.1
475N/Aappropriate sparc and intel subdirectories in the ON workspace.
0N/AUntar a stock perl 5.6.1 image into a clean directory, and copy the contents of
0N/Aperl/5.6.1/distrib back into it.
603N/AApply the required patches to the stock directory, run ConfigPerl to configure,
821N/Afollowed by 'make regen_headers; make; make test', and make sure everything is
0N/ARun the PatchPerl script using the
Flist.csv mapping file from this directory
0N/Ato check any changed files back into the workspace.
0N/AFor additional architectures to the base architecture used for steps 1-3, rerun
0N/AConfigPerl on the relevant architecture and then manually copy the resulting
0N/Aconfig.sh file into the appropriate architecture directory under perl/5.6.1.
0N/ABuild and test the workspace as normal. The generated perl Makefiles are
0N/Asometimes missing all the dependencies needed for incremental builds to work
0N/Acorrectly, so check that both fresh and incremental builds work.
0N/Adescription of all the applied patches.
0N/AA full list of the files in this directory is given below.
0N/AFlist Merges the 3 files below into a CSV file
0N/Aflist.500503 Sorted list of stock 5.005_03 files
0N/Aflist.561 Sorted list of stock 5.6.1 files
0N/Aflist.s8 Sorted list of 5.005_03 files as integrated into Solaris 8.
0N/A a stock 5.6.1 build directory into an ON workspace.
0N/A a stock 5.6.1 build directory on top of a 5.005_03 ON workspace.
0N/APatchPerl Deltas changes from a perl build directory onto an ON workspace.