DateTime-Calendar-Discordian
============================

This is a module that implements the Discordian calendar made popular
in the "Illuminatus!" trilogy by Robert Shea and Robert Anton Wilson and
by the Church of the SubGenius.  It follows the DateTime API.

INSTALLATION

If you have the Module::Signature module installed, you can verify the
integrity of this distribution by typing:

    cpansign -v

Module::Signature requires GnuPG which you can get from:
http://www.gnupg.org/download/
A binary version for Windows is available from that page.

Then to install this module, run the following commands:

    perl Build.pl
    ./Build
    ./Build test
    ./Build install

On Windows you don't need to type the preliminary ./

Alternatively, you can do:

    perl Makefile.PL
    make
    make test
    make install

If you are using ActiveState perl on Windows and you don't have a make
utility, you can download nmake from:
http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe
(Replace make with nmake in the instructions above if you are using it.)

If you are using Strawberry perl on Windows, it comes with a make utility
called dmake.  (Replace make with dmake in the instructions above if you are
using it.)

DEPENDENCIES

This module is pure perl and should work with any version of perl, 5.010 or
greater.

The signature can be tested by installing the following module:

  Module::Signature

and setting the environment variable TEST_SIGNATURE to 1.

This module requires these other modules available from CPAN:

  DateTime
  DateTime::Locale
  Params::Validate

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the perldoc
command.

    perldoc DateTime::Calendar::Discordian

Support for this module is provided via the datetime@perl.org email
list. See http://lists.perl.org/ for more details.

Please submit bugs to the CPAN RT system at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=datetime-Calendar-Discordian
or via email at bug-datetime-calendar-discordian@rt.cpan.org.

You can also look for information at:

    Search CPAN
        http://search.cpan.org/dist/DateTime-Calendar-Discordian

    AnnoCPAN, annotated CPAN documentation:
        http://annocpan.org/dist/DateTime-Calendar-Discordian

    CPAN Ratings:
        http://cpanratings.perl.org/d/DateTime-Calendar-Discordian

COPYRIGHT AND LICENCE

By Jaldhar H. Vyas <jaldhar@braincells.com>

Copyright (C) 2012 Consolidated Braincells Inc.

This distribution is free software; you can redistribute it and/or modify it
under the terms of either:

a) the GNU General Public License as published by the Free Software
Foundation; either version 2, or (at your option) any later version, or

b) the Artistic License version 2.0.

The full text of the license can be found in the LICENSE file included
with this distribution.
