This README documents Win32::EventLog::Carp, version 1.41, released
2007-05-19.

NAME
    Win32::EventLog::Carp - For carping in the Windows NT Event Log

REQUIREMENTS
      Carp (*)
      Win32::EventLog (*)
      Win32::EventLog::Message (**)
      
      (*) standard modules on Win32 systems, if they are not available,
      your installation is probably broken.
      
      (**) Not available from CPAN. You can find it at the following
      location:

          ftp://ftp.roth.net/pub/ntperl/EventLog.Message

      You should see a series of 'yyyymmdd' date-stamped directories.
      Choose the most recent one, and look for a file named
      EventMsg_500x.Zip (where x = 5, 6 or 8, corresponding to your
      Perl version).
      
  Installation

    Installation is pretty standard:

      perl Makefile.PL
      nmake
      nmake test
      nmake install

    If you have Module::Build installed, you can use the following:

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

    Note that the tests for this module will write to the event log!
    
    You may set the environment variable PERL_WIN32_EVENTLOG_CARP_TEST_VERBOSE
    to something (e.g. 1) for a more verbose test output.

  Known Issues with Installation

    * WinZip is unable to use POSIX-style long pathnames in tar files,
      so it may ignore the directory structure of this package's 
      distribution.  Alternate gzip and tar utilities can be found at
      http://gnuwin32.sourceforge.net or http://unxutils.sourceforge.net

    * The tests may fail on some systems.  If it fails, check your event
      logs to verify that your Application log contains events with
      messages of the form:

        test,cluck,2,1103305379 at t\01-basic.t line 124

      if so, it works and can be installed.

      In certain other cases, tests will fail the first time they are
      run on a system, but will succeed the second time they are run.

SYNOPSIS
      use Win32::EventLog::Carp;
      croak "We're outta here!";

      use Win32::EventLog::Carp qw(cluck);
      cluck "This is how we got here!";

DESCRIPTION
    `Win32::EventLog::Carp' traps warnings and fatal errors in Perl and
    reports these errors in the Windows NT Event Log. This is useful for
    scripts which run as services or through the scheduler, and for
    CGI/ISAPI scripts.

    The interface is similar to `Carp': the `carp', `croak' and `confess'
    functions are exported (with `cluck' being optional). You need only
    change references of "Carp" to "Win32::EventLog::Carp" to begin using
    this module.

    A more detailed description can be found in the module's POD docu-
    mentation.

REVISION HISTORY
    Changes since Win32::EventLog::Carp v1.37.  (Note: potential
    incompatabilities are marked with '*'.)

    1.40 2006-10-06
    - maintenance hand-over release. No functional changes.

    A detailed revision history is in the Changes file included with
    this distribution.

AUTHOR
    David Landgren <dland at cpan.org> (current maintainer)
    Robert Rothenberg <rrwo at cpan.org>

LICENSE
    Copyright (c) 2000-2004 Robert Rothenberg. Copyright 2006 David Landgren.
    All rights reserved.
    This program is free software; you can redistribute it and/or modify
    it under the same terms as Perl itself.
