=head1 SYNOPSIS
Functions for dealing with the actual compiling/installation of spells
and walking through casts 'pass 4' pipeline.
=head1 DESCRIPTION
=head1 COPYRIGHT
Copyright (C) 2002 The Source Mage Team
pokes around for a configure or src/configure and if it exists asks the user if they want to edit the custom options
API
Prepares to install the spell. If the spell is installed already, the libraries are saved with save_libraries() and the spell is dispelled. Usually called from the BUILD or PRE_INSTALL script of a spell. Locks "libgrimoire" "install" before proceeding. If the spell is not installed (or held) the spell is not dispelled.
append old libraries and binaries to the appropriate environmental variables so that they can be found by sorcery if they get dispelled
Gathers all documentation files from source archive and installs them as part of the spell
Copies pam configuration files to /etc/pam.d/
Stuff that should be done if run_build_spell succeeds This is intended to be overridable at some point
Stuff that should be done if run_build_spell fails This is intended to be overridable at some point