summaryrefslogtreecommitdiff
path: root/glafp-utils/README
blob: 8fa596fc61954ff35776e58c1391dd864817b993 (plain)
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
This directory tree's worth of stuff are utility bits that are used in
more than one of the Glasgow functional-programming tools.  (For the
project-specific bits, try <project>/utils/<blah>.)

etags/		A variant of the common Emacs tags-generating program.

msub/		a utility from Paul DuBois, that lets you substitute
		for make variables (e.g., $(CC) ) in any old document.
		Given that, with the "make world" configuration
		system, Makefiles have loads of useful config info in
		them, this is the program used to sneak that info into
		other files.

verbatim/	A LaTeX pre-processor that some people like, namely
		Simon PJ.  Provides shorthand for common LaTeX
		constructs that he uses.

scripts/	little utility scripts

 fastmake	a "make" wrapper for compiling Haskell programs;
		essentially, strips out the "make depend"ed
		dependencies to avoid so much re-checking.

 lndir		from X imake stuff (via DuBois); make a shadow tree
		of symbolic links

 ltx		a "latex" wrapper.  Re-runs latex/bibtex/makeindex
		enough times to "do the right thing."

 mkdependC	script version of C makedepend (from X11R4 via DuBois)

 mkdirhier	"mkdir a/b/c/d" will do "mkdir a; mkdir a/b; ..."
		(assuming none of those dirs exist)

 perltags	"etags" for Perl.

 runstdtest	runs a pgm with some flags & some stdin; checks for an
		expected exit code, expected stdout, and expected
		stderr.  (Expect this to change :-)

 zap-if-same	Zap files in this directory (and subdirectories) if
		they are identical to files in the given directory
		(and its subdirectories).  With -s, it replaces the
		files here with symlinks to the files there.