NAME
    Module::Use

SYNOPSIS
    Perl
      use Module::Use (Counting, Logger => "Debug");

    mod_perl
      <Perl>
      use Module::Use (Counting, Logger => "Debug");
      </Perl>

      PerlChildExitHandler Module::Use
      PerlCleanupHandler Module::Use
      PerlLogHandler Module::Use

DESCRIPTION
    Module::Use will record the modules used over the course of the Perl
    interpreter's lifetime. If the logging module is able, the old logs are
    read and frequently used modules are automatically loaded. Note that no
    symbols are imported into packages.

    Under mod_perl, only one Perl*Handler should be selected, depending on
    when and how often logging should take place.

OPTIONS
    The following options are available when "use"ing this module.

    Count
        This is the number of times a module has been used for it to be
        automatically loaded.

    Counting
        This indicates that the number of times a module is "require"d
        should be tracked. This option takes no arguments.

        N.B.: This will tie %INC. This may not work. Don't use if it
        doesn't.

    Decay
        This number is subtracted from the count of all modules that are in
        the data store but were not loaded.

    Grow
        This number is added to the count of all modules that were loaded.

    Limit
        Do not automatically load more than this many modules.

    Logger
        This is the logging module to use. Configuration is specific to the
        module chosen. Please see the documentation for the module.

        The module name is "Module::Use::Logger" with "Logger" replaced with
        the value of this option.

    Percentage
        The percentage of total module loads is used in the same manner as
        the "Count". If both "Percentage" and "Count" are given, the one
        with the greater counts is used.

SEE ALSO
    the Module::Use::Debug manpage, the Module::Use::DB_FileLock manpage,
    Section 17.7 of _mod_perl Developer's Cookbook_.

AUTHOR
    James G. Smith <jsmith@cpan.org>

COPYRIGHT
    Copyright (C) 2002 Texas A&M University. All Rights Reserved.

    Released under the same license as Perl itself.