'\" t

.\"

.\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.

.\"

.\" This man page created by Oracle to provide a reference to the

.\" Info format documentation for guile provided with the distribution.

.\"

.TH guile-tools 1 "26 May 2008"

.SH NAME

guile-tools \- displays guile module information 

.SH SYNOPSIS

/usr/bin/guile-tools [OPTION] PROGRAM [ARGS ...]

.SH DESCRIPTION

.LP

'guile-tools' is a wrapper program and installed along w/ `guile'; it 

knows where a particular module is installed and calls it passing its

args to the program. The result is that you need not augment your PATH.  

.LP

Usage is straightforward:

      guile-tools --help

      guile-tools --version

      guile-tools [OPTION] PROGRAM [ARGS ...]

.LP 

When Guile is installed, in addition to the `(ice-9 FOO)' modules, a

set of "executable modules" `(scripts BAR)' is also installed.  Each 

is a regular Scheme module that has some additional packaging so 

that it can be called as a program in its own right, from the shell.

For this reason, we sometimes use the term "script" in this context 

to mean the same thing.

.LP

If PROGRAM is "list" or omitted, display contents of scripts dir, 

otherwise PROGRAM is run with ARGS. Options (only one of which may be

used at a time):

.LP

 --scriptsdir DIR - Look in DIR for scripts

 --guileversion VERS - Look in $pkgdatadir/VERS/scripts for scripts

 --source - Display PROGRAM source (ignore ARGS) to stdout

.LP

The modules are self-documenting.  For example, to see the 

documentation for `lint', use one (or both) of the shell commands:

        guile-tools display-commentary '(scripts lint)'

        guile-tools --source lint