README revision 7c478bd95313f5f23a4c958a745db2134aa03244
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass# Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass# Use is subject to license terms.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass#ident "%Z%%M% %I% %E% SMI"
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassThis directory contains utilities that help port and patch a standard perl
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass5.8.4 build directory into the ON tree. It is hoped that future ports and
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glasspatches will be able to use the same framework, so details of the process used
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassfor 5.8.4 are documented here.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassBuild and install perl 5.8.4 for both the sparc and i386 architectures. To do
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassthis, unpack perl 5.8.4 and then run the InstallPerl script from inside the
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassdirectory. This script needs to be setuid root, and will install perl under
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass/usr/perl5, and will generate the correct config.sh file. A series of status
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassfiles will be generated in the perl build directory. These files are then
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassused in step 2 to automatically figure out which files need to be integrated
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassinto ON. The files are build.touched, test.log and install.packlist.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassFrom the perl build directory, run the MapFiles script. This will produce
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassa CSV file describing all the files that need to be integrated into ON, using
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassthe information captured by step 1. The spreadsheet can be viewed in
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassStarOffice. The file flist_5.8.4_s10.csv in this directory is the output of
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassthe MapFiles script.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassRun the CheckIn script, giving as parameters the CSV file, the perl build
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassdirectory and the workspace that perl is to be checked in to. The script
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassoutputs a shell script to stdout, the script contains the commands necessary
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassto check the perl source into ON.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassVerify that the resulting script looks sane, then run it to perform the
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassintegration. Examine the output to make sure that the integration succeeded.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassMake sure you have a config.sh for both the sparc and x86 architectures, and
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassthat they are checked in.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassGenerate the makefiles and associated infrastructure to build the resulting
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassperl 5.8.4 workspace. These were based on the 5.8.3 versions. Things that
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassneed to be done manually, in no particular order:
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass a) Merge in the ON-specific changes into installperl fromm the previous
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass perl version.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass b) Merge in the ON-specific changes into MakeMaker (under utils/lib)
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass using the standard perl files as a starting point.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass c) Generate Config.pm files for contrib/Sun/Solaris/PerlGcc and
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass make any other necessary changes for the new OS and/or perl version.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassA full list of the files in this directory is given below.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassInstallPerl Builds and installs perl. setuid root.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassMapFiles Figures out which files need to be integrated into ON.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassCheckIn Generates a ksh script to do the integration.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glassflist_5.8.4_s10.csv Output of MapFiles.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassEditedFiles Utility to find any differences between the perl build
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass directory and an ON workspace.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassConfigPerlGcc Generate a config.sh file suitable for use with gcc,
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav Glass to be used with Sun::Solaris::PerlGcc.
5b139d58acfcae4b1bcab5a895706abafc2a87a0Dav GlassREADME This file.