           SPELL=guru-tools
         VERSION=1.8
          SOURCE=$SPELL-$VERSION.tar.bz2
SOURCE_DIRECTORY=$BUILD_DIRECTORY/${SPELL}-${VERSION}
   SOURCE_URL[0]=http://download.sourcemage.org/distro/misc/$SOURCE
     SOURCE_HASH=sha512:6f9930f01cc300eaad7feec5ed2b339e828f44c1e8bd3355911b02db86bfa9ff663199619c935e7df007fc5e33561fc9dbd815110056ef35b0c2731577d023e6
        WEB_SITE=http://www.sourcemage.org
         ENTERED=20030602
         LICENSE=GPL
        KEYWORDS="smgl"
           SHORT="Collection of useful Guru Tools."
cat << EOF
There are various useful tools that have been written by Source Mage
developers over the years. Here we have bundled them together for your
Guru experience:

checkGrimoire.sh        - checks the grimoire (or sections of it) for broken links. 
                          (by Paul)

check_my_depends.sh     - checks for dependancies that have been dispelled.(by Paul)

dependsSquish.sh        -  takes a list of spells and outputs the order in which to 
                           cast them so dependancies are taken care of.

findLibDepends.sh       - find missing dependancies of spells with ldd.(by Paul)

findSharedFiles         - tool for finding files shared between spells.
                          (by Rasmus Ory Nielsen) 

gazeSpider [<item ...]  - validates urls for entire grimoire or if item give, for 
                          one or more items. Items may be either spells or sections.

grimoireCircCheck.sh    - check grimoires for circular dependancies and incidentaly, 
                          missing spells. (by Paul)

historyfix.pl           - outputs an sh script for editing and patching all the history
                          problems in a grimoire, section, spell. When you've tried it 
                          once and checked its output, just pipe it into sh and then p4 
                          submit. 
                          historyfix.pl with no arguments does the current directory 
                          recursively. 
                          historyfix.pl with arguments does only the files
                          supplied in the args. (by Seth Woolley)
                          
image.sh <grimoire-path> - print a grimoire image. This script is used to
                          create images for the report.pl tool listed below.
                          Try piping output as follows: '| tee <file.image>'
                          and then pass the files to report.pl below. (by
                          Andrew Stitt)

md5unpack <tarball>     - provides md5sum info from source tarball. 

rebuildPackages         - In case you delete your /var/state/sorcery/packages
                          file ;)

report.pl <image1> <image2> - this tool take two different images created by
                          the image.sh tool and report the differences,
                          amazing amount of information! (see image.sh above)
                          (by Andrew Stitt)

searchdups.sh <path-grimoire> [<section> | <spell> ] - finds duplicate
                          dependencies for a spell, section, grimoire that is
                          satisfied by child a dependency. (by Seth Woolley)

spellify                - takes some software-version.tar.{gz|bz2}, makes a
                          #{MYSPELLS}/software and DETAILS in your local 
                          spell dir ${MYSPELLS} and cp the tarball to spool 
                          then scribe reindex ${MYGRIMOIRE}. Uses 
                          /etc/sorcery/local/guruinfo for guru info.

summonsection           - usefull for lazy section maintainters who get bored
                          first deleting cached files, then summon'em one by
                          one, by hand. Summonsection kills cached files, and
                          summons new files automaticaly. (by M.L.).

update_spell            - typical parameters are "DETAILS -s -m -v 1.2.3",
                          it only works on the first SOURCE for now.
                          (from our old CVS repository)

upspell                 - updates a spell DETAILS and HISTORY.
                          Just goes to the spell's directory and run it...
                          Uses /etc/sorcery/local/guruinfo for guru info.

urlwatch                - checks a list of urls for changes inside html page.
                          Make a cronjob with this and you'll automaticaly
                          receive notifications for changed urls by email... 
                          See urlwatch --help for help. (by M.L.).

If you have more to contribute, mail to maintainer.

EOF
