summaryrefslogtreecommitdiffstats
path: root/smgl/guru-tools/DETAILS
blob: 05ced3f5021de3a5b61ea605e9f25401beb4c00d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
           SPELL=guru-tools
if [[ "$GURU_TOOLS_BRANCH" = scm ]]; then
  if [[ "$GURU_TOOLS_AUTOUPDATE" = y ]]; then
         VERSION=$(date +%Y%m%d)
  else
         VERSION=scm
  fi
          SOURCE=$SPELL-scm.tar.bz2
SOURCE_DIRECTORY=$BUILD_DIRECTORY/${SPELL}-scm
  FORCE_DOWNLOAD=on
   SOURCE_URL[0]=git://scm.sourcemage.org/smgl/misc/${SPELL}.git:$SPELL-scm
   SOURCE_IGNORE=volatile
else
         VERSION=2.0
          SOURCE=$SPELL-$VERSION.tar.bz2
SOURCE_DIRECTORY=$BUILD_DIRECTORY/${SPELL}-${VERSION}
   SOURCE_URL[0]=http://download.sourcemage.org/distro/misc/$SOURCE
     SOURCE_HASH=sha512:20531502c96a7992c67f4cea944ea2ccc049e6c32e587298ef67f497956d9d82660f0597655e854fb677f93787c0ffd2d1d8704108bc8777548b2dfda4de43b7
fi
        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)

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)

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.).

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.).

smgl-cherry-pick        - a wrapper around git-cherry-pick, which enables
                          good "merging" of HISTORY, ChangeLog and binary files

If you have more to contribute, mail to maintainer.

EOF