glafp-utils/README

   1 This directory tree's worth of stuff are utility bits that are used in
   2 more than one of the Glasgow functional-programming tools.  (For the
   3 project-specific bits, try <project>/utils/<blah>.)
   4
   5 etags/          A variant of the common Emacs tags-generating program.
   6
   7 msub/           a utility from Paul DuBois, that lets you substitute
   8                 for make variables (e.g., $(CC) ) in any old document.
   9                 Given that, with the "make world" configuration
  10                 system, Makefiles have loads of useful config info in
  11                 them, this is the program used to sneak that info into
  12                 other files.
  13
  14 verbatim/       A LaTeX pre-processor that some people like, namely
  15                 Simon PJ.  Provides shorthand for common LaTeX
  16                 constructs that he uses.
  17
  18 scripts/        little utility scripts
  19
  20  fastmake       a "make" wrapper for compiling Haskell programs;
  21                 essentially, strips out the "make depend"ed
  22                 dependencies to avoid so much re-checking.
  23
  24  lndir          from X imake stuff (via DuBois); make a shadow tree
  25                 of symbolic links
  26
  27  ltx            a "latex" wrapper.  Re-runs latex/bibtex/makeindex
  28                 enough times to "do the right thing."
  29
  30  mkdependC      script version of C makedepend (from X11R4 via DuBois)
  31
  32  mkdirhier      "mkdir a/b/c/d" will do "mkdir a; mkdir a/b; ..."
  33                 (assuming none of those dirs exist)
  34
  35  perltags       "etags" for Perl.
  36
  37  runstdtest     runs a pgm with some flags & some stdin; checks for an
  38                 expected exit code, expected stdout, and expected
  39                 stderr.  (Expect this to change :-)
  40
  41  zap-if-same    Zap files in this directory (and subdirectories) if
  42                 they are identical to files in the given directory
  43                 (and its subdirectories).  With -s, it replaces the
  44                 files here with symlinks to the files there.