NAME
    Log::Dispatch::Win32EventLog - Class for logging to the Windows NT
    Event Log

REQUIREMENTS
    The following modules are required:

      Log::Dispatch
      Params::Validate
      Win32::EventLog

  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 post to the event log.

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

SYNOPSIS
      use Log::Dispatch::Win32EventLog;

      my $log = Log::Dispatch::Win32EventLog->new(
          name       => 'myname'
          min_level  => 'info',
          source     => 'My App'
      );

      $log->log(level => 'emergency', messsage => 'something BAD happened');

DESCRIPTION
    Log::Dispatch::Win32EventLog is a subclass of Log::Dispatch::Output,
    which inserts logging output into the windows event registry.

    See the module documentation for more details.

REVISION HISTORY
    Changes since v0.11:

    0.12 Fri Sep  3 2004 (includes 0.11_xx releases)
	- test for register set as TODO since it seems to fail on some
	  systems when run for the first few times, then suddenly works
	- test for register skipped if not an administrator
	- added test for log4j.NTEventLogAppender interface
	- if backslashes are in the source, it changes them to spaces and
	  issues a warning rather than dying; message changed to
	  'Backslashes in source removed'
	- tweaked tests with respect to opening event log to verify events
	- removed use of Win32::IsAdminUser function, since it does
	  not seem to be universally available
	- added warning in README about WinZip
	- event source will only be registered if one is an admin user
	- removed unnecessary tests
	- updated POD and added Known Issues section
	- corrected tests for registered sources (thanks to
          <fpchan at aol.com> for feedback on this)

    A more detailed history can be found in the included Changes file.

AUTHOR
    Robert Rothenberg <rrwo at cpan.org>

    Arthur Bergman <abergman at cpan.org>

    Gunnar Hansson <gunnar at telefonplan.nu>

LICENSE
    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

