.TH HASKELL\-UTILS 8 "2003-09-23" "Debian Haskell Suite" "Haskell Utils"
.SH NAME
haskell\-utils \- utility for managing Haskell compilers

.SH SYNOPSIS
.B haskell\-utils
[ \-\-help | \-h | \-\-version | \-v ]
.br
.B haskell\-utils
[ \-e ] \-\-add\-compiler \fIPATH_TO_COMPILER\fR \fITYPE\fR \fIVERSION\fR
.br
.B haskell\-utils
[ \-e ] \-\-remove\-compiler \fIPATH_TO_COMPILER\fR
.br
.B haskell\-utils
[ \-e ] \-\-add\-trigger \fIIDENT\fR \fITYPE\fR \fITRIGGER\fR
.br
.B haskell\-utils
[ \-e ] \-\-add\-untrigger \fIIDENT\fR \fITYPE\fR \fITRIGGER\fR
.br
.B haskell\-utils
[ \-e ] \-\-remove\-triggers \fIIDENT\fR

.SH DESCRIPTION
.B haskell\-utils
allows compilers and tools that like to know about compilers to
register themselves so the latter can be informed about the addition and
removal of the former.

.SH
OPTIONS

\fIPATH_TO_COMPILER\fR is the path to the compiler, e.g. /usr/bin/ghc6
.br
\fITYPE\fR is GHC | NHC | HUGS | Other.
.br
\fIIDENT\fR is a string uniquely identifying the trigger owner.
.br
\fITRIGGER\fR is the command to be run when the trigger happens.
%% is replaced with % and %p with the path to the compiler.

.TP
.BR \-\-help ", " \-h
Show summary of options.
.TP
.BR \-\-version ", " \-v
Print version information on standard output then exit successfully.
.TP
.BR \-e
If a program called fails, or if we are asked to remove something that
doesn't exist from our database, fail.
.TP
.BR \-\-add\-compiler " " \fIPATH_TO_COMPILER\fR " " \fITYPE\fR " " \fIVERSION\fR
Registers the compiler at \fIPATH_TO_COMPILER\fR as being of the given
type and version. For example,
\*(lqhaskell\-utils \-\-add\-compiler /usr/bin/ghc6 GHC 6.0.1\*(rq.
.TP
.BR \-\-remove\-compiler " " \fIPATH_TO_COMPILER\fR
Unregisters compilers added with
.BR "\-\-add\-compiler" ,
e.g. \*(lqhaskell\-utils \-\-add\-compiler /usr/bin/ghc6\*(rq.
.TP
.BR \-\-add\-trigger " " \fIIDENT\fR " " \fITYPE\fR " " \fITRIGGER\fR
Add a trigger. The \fITRIGGER\fR will be executed as a command whenever
a new compiler of type \fITYPE\fR is registered. Additionally it will be
run for all registered compilers of the appropriate type when the
trigger itself is added.  Any occurence of %% will be replaced by % and
%p by the compiler path in \fITRIGGER\fR. The \fIIDENT\fR is just a
string unique to the installing package so triggers can be removed.
.TP
.BR \-\-add\-untrigger " " \fIIDENT\fR " " \fITYPE\fR " " \fITRIGGER\fR
The same as
.BR "\-\-add\-untrigger"
but called when compilers are removed rather than added.
.TP
.BR \-\-remove\-triggers " " \fIIDENT\fR
Remove all triggers with identifier \fIIDENT\fR.

.SH FILES
.I @localstatedir@/haskell\-utils/compilers

.SH COPYRIGHT
Haskell Utils Version @version@

Copyright (C) 2003, 2004, 2007 Ian Lynagh

.SH AUTHOR
This manual page was written by Ian Lynagh <igloo@debian.org>.

