Next: , Previous: Autoconf Support, Up: Top


13 Miscellaneous Tools

Programming is more fun with good tools. This chapter describes not only the tools installed with Guile, but also the methodology of their construction. The latter is relevant because the tools are, for the most part, also Scheme programs; they demonstrate programming with Guile and sometimes are used in Guile development, too. Imagine that!

Although the tools are all programs that can be invoked from the shell, to minimize bindir pollution they are installed in a directory not normally named in the PATH env var, and instead, the wrapper program guile-tools is installed in bindir (along with the guile interpreter). This wrapper knows the actual location of the installed tools and passes args to the selected program. The result is that you need not augment PATH.

Usage of guile-tools is straightforward:

guile-tools [--source | --probe] PROGRAM
guile-tools [PROGRAM [ARGS ...]]

First invocation form:
 -p, --probe   -- If PROGRAM exists, display its full path and exit
                  successfully.  Otherwise, simply exit failurefully.
     --source  -- Display PROGRAM source (ignore ARGS) to stdout.

Second invocation form:  If PROGRAM is "list" or omitted,
display contents of scripts dir.  Otherwise, run PROGRAM ARGS...  

Note that we use the terms script and program interchangeably in this chapter.

Areas of Interest

Methodology

Reference