1 Make::Cache
*************

This is the Make::Cache Package.

1.1 Copyright
=============

This package is Copyright 2003-2010 by Wilson Snyder
<wsnyder@wsnyder.org>.

   This program is free software; you can redistribute it and/or modify
it under the terms of either the GNU General Public License Version 3
or the Perl Artistic License Version 2.0.

   This code is provided with no warranty of any kind, and is used
entirely at your own risk.

1.2 Summary
===========

Make::Cache provides packages and the objcache program to cache the
results of compiler runs, so that later identical source code can be
recompiled instantaneously.

1.3 Description
===============

Make::Cache provides packages and programs to support caching of
Makefile targets, mostly the outputs of compiler runs.

   The main interface is the objcache program.  By simply prepending

   objcache -read -write

   before any GCC compile lines in a makefile, you get instant
recompilation of source files.

   Objcache also allows for distributing parallel make jobs across
multiple machines in a server farm.

1.4 Obtaining Distribution
==========================

The latest version is available at `http://www.perl.org/CPAN/'

1.5 Supported Systems
=====================

This version of Make::Cache has been built and tested on:

   * i386-linux

   It should run on any system with Perl and GCC, though edits may be
needed to run on non-Linux systems.  It may be easily modified to
support other compilers.

1.6 Installation
================

  1. `cd' to the directory containing this README notice.

  2. Type `perl Makefile.PL' to configure the package for your system.

  3. Type `make' to compile.

  4. Type `make test' to check the compilation.

  5. Type `make install' to install the programs and any data files and
     documentation.

  6. See the `man objcache' manpage for example usage in a Makefile.


