Changeset 89a2b70 for extras

Timestamp:

04/09/2006 07:04:00 PM (18 years ago)

Author:

Manuel Canales Esparcia <manuel@…>

Branches:

experimental

Children:

a101844

Parents:

2faca44

Message:

Added inline_doc fragment and trailing space clean-up.

File:

• extras/farce (modified) (14 diffs)

extras/farce

@@ -1 +1 @@
 #!/bin/bash
+
+# Acknowledgment:
+#  The following code is a no-modified version (except for this comment
+#  and the inline_doc fragment) of an original work written by
+#  Ken Moffat and is included here with his permission.
+#
 
 # FARCE: Farce Assists Rebuild Comparison Evaluation ;)
@@ -14 +20 @@
 # list of files, build a full desktop environment, and only then
 # build and boot the "can it build itself" test system and get
-# _its_ filelist. 
+# _its_ filelist.
 #
 # What this script aims to do:
@@ -35 +41 @@
 # which are shared objects, are copied and subjected to
 # --strip-debug.  If files match at this stage, count them as
-# 'accepted'. 
+# 'accepted'.
 #
 # As a last step for any file that doesn't match, copy it
@@ -71 +77 @@
 #
 # farce-identical - the names of the files which are identical
-# 
+#
 # farce-substitutions - whenever using tokenizeanddiff results in a
 # difference being accepted, for both versions diff the before and
@@ -78 +84 @@
 # version strings pass one of the regexps looking for a kernel version
 # - since I expect you to use the same version of glibc for each
-# build, this is not a problem.     
+# build, this is not a problem.
 #
 # farce-differ - the names of the files which could not be treated
 # as matching (whether or not I regard the failure as predictable)
 # for possible input to ICA processing.
-#  
+#
 # Copyright (C) 2005, 2006 Ken Moffat <ken@linuxfromscratch.org>
 #
@@ -103 +109 @@
 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 #
+
+set -e
+
+: <<inline_doc
+    desc:       do farce analisys and report
+    usage:      farce -directory $FARCELOGDIR/dir path1 list1 path2 list2
+    input vars: $1 farce log dir for this comparation
+                $2 full path to previous iteration
+                $2 full path to filelist for previos iteration
+                $3 full path to current iteration
+                $4 full path to filelist for current iteration
+    externals:  --
+    modifies:   --
+    returns:    --
+    on error:
+    on success:
+inline_doc
+
 
 VERSION="002"
@@ -204 +228 @@
                 true;;
         /var/lib/locate/locatedb)
-                # if one system has had extra stuff built, this will likely be bigger 
+                # if one system has had extra stuff built, this will likely be bigger
                 true;;
         /var/lib/nfs/*)
@@ -250 +274 @@
                                 emessage "internal error, expected difference for $1 of type $TYPE not allowed"
                                 exit 2
-                                ;; 
+                                ;;
                 esac
                 true
@@ -350 +374 @@
 # NB if pathes are absolute, we need to prefix them
 # with the original $PWD to access the .a files
-# 
+#
 function testar() {
         # ar archives include timestamps for the members,
@@ -356 +380 @@
         # put out a message to help locate which archive any messages
         # about the members refer to.
-        
+
         # try just stripping them U1,2 undebuggable
         U1=`mktemp` || fatal "cannot create a temporary file"
@@ -370 +394 @@
                 let ACCAR=$ACCAR+1
                 message "archive $3 matches after strip --strip-debug"
-                return 
+                return
         fi
         # rest of this function retained primarily for pathologically bad builds
@@ -378 +402 @@
         D2=`mktemp -d` || fatal "cannot create a temporary directory"
         cd $D1
-        ar -x ${OP1}${1}${3} 
+        ar -x ${OP1}${1}${3}
         cd $D2
         ar -x ${OP2}${2}${3}
@@ -551 +575 @@
         tokenize $2 $F2
 
-        # actually, cmp is probably more efficient 
+        # actually, cmp is probably more efficient
         # but for picking up the pieces it will be better to
         # use diff to see what got through.
         cmp -s $F1 $F2
-        TOKENRESULT=$?  
+        TOKENRESULT=$?
         if [ $TOKENRESULT -ne 0 ]; then
                 echo "failure in $3..." >&6
@@ -644 +668 @@
 if ! [ $ARGS == valid ]; then
         dohelp
-        fatal "`basename $0`: error in arguments"       
+        fatal "`basename $0`: error in arguments"
 fi