NAME
    CPAN::YACSmoke - Yet Another CPAN Smoke Tester

SYNOPSIS
      perl -MCPAN::YACSmoke -e test

REQUIREMENTS
    This package requires the following modules (most of which are not
    included with Perl):

      CPANPLUS
      Config::IniFiles
      File::Basename
      File::HomeDir
      File::Path
      File::Spec
      IO::File
      LWP::Simple
      Module::Pluggable
      Regexp::Assemble
      SDBM_File
      Sort::Versions
      Test::Reporter
      URI

   These dependencies (such as CPANPLUS and Test::Reporter) may require
   additional modules.

Installation
    Installation can be done using the traditional Makefile.PL or the
    newer Build.PL methods.

    Using Makefile.PL:

      perl Makefile.PL
      make
      make test
      make install

    (On Windows platforms you should use nmake instead.)

    Using Build.PL (if you have Module::Build installed):

      perl Build.PL
      perl Build
      perl Build test
      perl Build install

DESCRIPTION
    This module uses the backend of CPANPLUS to run tests on modules
    recently uploaded to CPAN and post results to the CPAN Testers list.

    See the module documentation for more information.

REVISION HISTORY
    The following changes have been made since the previous publicly
    available version:

    0.03_05 Fri Apr  8 2005
	- fixed bug where configuration settings were not used by
          CPANPLUS::Backend [rt.cpan.org #12197]
	- CPANPLUS conf settings can be configured in the ini file
	- miscellaneous documentation tweaks
	- additional comments/code tweaks
	- corrected issue with Test::Pod::Coverage tests
	- prefer_makefile defaults to '1' (better diagnostics)
	- added hooks for more CPANPLUS configuration fields
	- cleaned-up README
	- added note in POD about SourceForge project
	- 13recent.t now uses File::Temp so that RECENT file is not left
	- added Test::Portability::Files test
	- corrected issues with "none", "ungraded" reports
	- simplified the algorithm for when test reports are sent out
          [rt.cpan.org #12162]
	- prereqs that are unknown or ungraded will not block block tests
	- added FAQ
	- removed duplicate entries in Changes file

    0.03_04 Mon Apr  4 2005
        - bugfixes
          * when a grade is not found should be listed as 'none' in test()
          * new() wasn't being passed the %config hash in mark()
          * the $dist can either be a full path or the dist name in mark()
          * uc() was unclear in purge()
          * debug call removed from purge()

    0.03_03 Mon Apr  4 2005
        - YAML is now a required module
        - renamed connect_configure, connect_cpanplus, connect_db,
          disconnect_db functions to conform to Pod::Coverage reqs
        - corrected typo in POD
        - added Pod::Coverage tests
        - removed File::Spec minimum version since it limited platforms

    0.03_02 Mon Apr  4 2005
        - added new purge() and flush() functions
        - ability to specify local database file
        - rebuilt excluded dist functions for reuse
        - added 'allow_retries' configuration setting
        - added 'flush_flag' configuration setting (used by purge())
        - distributions with .tgz and .zip extensions now also supported
        - cleaned up audit printing
        - updated POD for plugins & bug reporting
        - added examples/smoke-purge.pl script

    See the Changes file for a complete revision history.

CAVEATS
    This is a proto-type release. Use with caution and supervision.

    The current version has a very primitive interface and limited
    functionality. Future versions may have a lot of options.

    There is always a risk associated with automatically downloading and
    testing code from CPAN, which could turn out to be malicious or severely
    buggy. Do not run this on a critical machine.

    This module uses the backend of CPANPLUS to do most of the work, so is
    subject to any bugs of CPANPLUS.

    And yes, it's sorely in need of documentation.

SEE ALSO
    There is a SourceForge project site for CPAN::YACSmoke at
    <http://sourceforge.net/projects/yacsmoke>.

AUTHORS
    Robert Rothenberg <rrwo at cpan.org>

    Barbie <barbie at cpan.org>, for Miss Barbell Productions,
    <http://www.missbarbell.co.uk>

COPYRIGHT AND LICENSE
    Copyright (C) 2005 by Robert Rothenberg. All Rights Reserved.

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself, either Perl version 5.8.3 or, at
    your option, any later version of Perl 5 you may have available.
