--- rock-old/Documentation/Developers/ROADMAP Wed Oct 10 11:17:15 2001 +++ rock-new/Documentation/Developers/ROADMAP Sat Nov 10 20:01:51 2001 @@ -60,7 +60,7 @@ At this point ROCK Linux will become a Distribution Development Kit rather than a distribution. -Other importand TODO's +Other important TODO's * Replace the gcc wrapper with a new, better, sed-like version * Upgrade to GlibC 2.2 and GCC 3.0 --- rock-old/scripts/Build-Tar Fri Mar 24 07:46:36 2000 +++ rock-new/scripts/Build-Tar Sat Nov 10 20:07:01 2001 @@ -1,4 +1,8 @@ #!/bin/sh +# +# Put together tar ball of compiled package files (based on information +# in /var/adm). For more information see ./scripts/Help +# . ./scripts/parse-config --- rock-old/scripts/Cleanup Wed Oct 10 11:26:43 2001 +++ rock-new/scripts/Cleanup Sat Nov 10 20:07:28 2001 @@ -1,4 +1,6 @@ #!/bin/sh +# +# Cleanup restores the environment # Umounting various filesystems ... # --- rock-old/scripts/Config Tue Dec 12 21:58:05 2000 +++ rock-new/scripts/Config Sat Nov 10 20:08:28 2001 @@ -1,4 +1,8 @@ #!/bin/sh +# +# Config helps the user set the paramaters for the build system +# of ROCK. For more information see ./scripts/Help +# use_bin_dialog=0 --- rock-old/scripts/Create-CD Wed Oct 10 11:26:28 2001 +++ rock-new/scripts/Create-CD Sat Nov 10 20:09:27 2001 @@ -1,4 +1,7 @@ #!/bin/sh +# +# Create-CD creates a CD image +# . ./scripts/parse-config --- rock-old/scripts/Help Thu Jul 20 10:34:51 2000 +++ rock-new/scripts/Help Sat Nov 10 20:10:15 2001 @@ -1,4 +1,8 @@ #!/bin/sh +# +# The Help script parses the ./scripts/help.txt file and display +# information on a contained topic. +# NO_AUTO_BACKUP=x . ./scripts/parse-config --- rock-old/scripts/Puzzle Sun Oct 28 20:15:53 2001 +++ rock-new/scripts/Puzzle Sat Nov 10 18:25:42 2001 @@ -1,5 +1,21 @@ #!/bin/sh - +# +# The Puzzle script is the backbone script of the ROCK distribution. +# It parses files and packages and creates/updates documentation, +# version tags, package index files, kernel configuration etc. +# +# The following files get created: +# +# Documentation/FAQ +# Documentation/LSM +# arch-conf/*/kernel.conf +# base-archive/INDEX +# opt-archive/INDEX +# pkg-archive/INDEX +# ext-config/INDEX +# ext-archive/INDEX +# scripts/packages +# NO_AUTO_BACKUP=x . ./scripts/parse-config @@ -33,7 +49,8 @@ EOF echo "Parsing cpp files in arch-conf/ ..." -# +# Parses and converts the kernel configuration files for +# each architecture cd $base/arch-conf ; ./cleanup.sh for x in */*.cpp ; do { echo -e "#\n# This file is auto-generated by ./scripts/Puzzle." \ @@ -44,27 +61,28 @@ done echo "Running build scripts in arch-conf/ ..." -# +# Configuration for each architecture for x in */buildit.sh ; do sh $x || exit 1 ; done echo "Linking the puzzle (.pz) files together ..." -# +# Find pz files and store contents in temporary file /tmp/$$ cd $base ; echo -n '(Re-)Creating ' find arch-conf/ base-config/ subdists/ scripts/ -name '*.pz' | sort | xargs cat > /tmp/$$ -# +# Parse temporary file and make target directories for INDEX files grep '^---- ' /tmp/$$ | cut -f2 -d' ' | sort -u | while read fn do echo -n "$fn " ; mkdir -p `dirname $fn` ; rm -f $fn ; done ; echo "..." -# +# Add each .pz entry to the appropriate INDEX file and create +# the scripts/packages file cat /tmp/$$ | awk -- 'BEGIN { OFS=" "; file="/dev/null"; idx=1; } /^---- / { file=$2; idx=$3; } ! /^---- / { print(file, idx, NR, $0); }' | sort | sed "s/'/'"\\\\\'\''/g; s/^\([^ ]*\) [^ ]* [^ ]* \(.*\)/echo '\''\2'\'' >> \1/' | sh -# +# Delete temporary file rm /tmp/$$ -echo "Reformating base-archive/INDEX and opt-archive/INDEX ..." -# +echo "Reformatting base-archive/INDEX and opt-archive/INDEX ..." +# Some minor formatting to make the files more readable mkdir -p base-archive/ opt-archive/ for x in base-archive opt-archive ; do grep -v '^[^#]' $x/INDEX > $x/INDEX.new @@ -74,10 +92,12 @@ done echo "Creating ext-config/INDEX ..." -# +# Extensions have their own mechanism for creating INDEX files mkdir -p ext-config/ +# Parse INDEX.IN for entries and create ext-config/INDEX cat ext-config/INDEX.IN | while read x ; do if [[ "$x" == "include "* ]] ; then + # Include maintainers INDEX file cat ext-config/"`echo $x | cut -f2 -d' '`" else echo "$x" @@ -86,7 +106,8 @@ expand -24,40 | unexpand -a | sort > ext-config/INDEX echo "Creating ext-archive/INDEX ..." -# +# Create ext-archive/INDEX - which contains all the download +# paths mkdir -p ext-archive/ egrep '^# *\[(D|DOWN|DOWNLOAD)\]' ext-config/*.ext | sed 's,^ext-config/,,; s,.ext:# * \[[^\]]*\],,' | --- rock-old/scripts/Update Wed Oct 10 11:22:40 2001 +++ rock-new/scripts/Update Sat Nov 10 18:34:30 2001 @@ -1,4 +1,8 @@ #!/bin/sh +# +# The Update script updates the ROCK source tree (or individual packages) +# using rsync. It does not update your tar balls! +# srcroot="rsync://www.rocklinux.org/rocklinux-1.5" @@ -37,11 +41,11 @@ done else echo - echo "The Update script can be used to update a single package, a list of packages" - echo "or the entire ROCK Linux sources to the current development snapshot, This is" - echo "done using 'rsync'." + echo "The Update script can be used to update the source of a single package, a list" + echo "of packages or the entire ROCK Linux tree to the current development snapshot" + echo "using 'rsync'." echo - echo "Warning: That might remove changes you have done in the source tree!" + echo "Warning: It may remove changes you have made!" echo echo "Usage: $0 [ -srcroot URL ] -all" echo " or: $0 [ -srcroot URL ] -package Package(s)" --- rock-old/scripts/patch-pp.pl Fri May 4 01:41:01 2001 +++ rock-new/scripts/patch-pp.pl Sat Nov 10 18:29:49 2001 @@ -2,6 +2,8 @@ # # ROCK Linux "Patch Postprozessor" # +# This script runs as part of the './scripts/Internal' diff command +# and cleans up the patch 'Clifford' style... use English; use strict;