README
1DateTime-Calendar-Discordian
2============================
3
4This is a module that implements the Discordian calendar made popular
5in the "Illuminatus!" trilogy by Robert Shea and Robert Anton Wilson and
6by the Church of the SubGenius. It follows the DateTime API.
7
8INSTALLATION
9
10If you have the Module::Signature module installed, you can verify the
11integrity of this distribution by typing:
12
13 cpansign -v
14
15Module::Signature requires GnuPG which you can get from:
16http://www.gnupg.org/download/
17A binary version for Windows is available from that page.
18
19Then to install this module, run the following commands:
20
21 perl Build.pl
22 ./Build
23 ./Build test
24 ./Build install
25
26On Windows you don't need to type the preliminary ./
27
28Alternatively, you can do:
29
30 perl Makefile.PL
31 make
32 make test
33 make install
34
35If you are using ActiveState perl on Windows and you don't have a make
36utility, you can download nmake from:
37http://download.microsoft.com/download/vc15/patch/1.52/w95/en-us/nmake15.exe
38(Replace make with nmake in the instructions above if you are using it.)
39
40If you are using Strawberry perl on Windows, it comes with a make utility
41called dmake. (Replace make with dmake in the instructions above if you are
42using it.)
43
44DEPENDENCIES
45
46This module is pure perl and should work with any version of perl, 5.010 or
47greater.
48
49The signature can be tested by installing the following module:
50
51 Module::Signature
52
53and setting the environment variable TEST_SIGNATURE to 1.
54
55This module requires these other modules available from CPAN:
56
57 DateTime
58 DateTime::Locale
59 Params::Validate
60
61SUPPORT AND DOCUMENTATION
62
63After installing, you can find documentation for this module with the perldoc
64command.
65
66 perldoc DateTime::Calendar::Discordian
67
68Support for this module is provided via the datetime@perl.org email
69list. See http://lists.perl.org/ for more details.
70
71Please submit bugs to the CPAN RT system at
72http://rt.cpan.org/NoAuth/ReportBug.html?Queue=datetime-Calendar-Discordian
73or via email at bug-datetime-calendar-discordian@rt.cpan.org.
74
75You can also look for information at:
76
77 Search CPAN
78 http://search.cpan.org/dist/DateTime-Calendar-Discordian
79
80 AnnoCPAN, annotated CPAN documentation:
81 http://annocpan.org/dist/DateTime-Calendar-Discordian
82
83 CPAN Ratings:
84 http://cpanratings.perl.org/d/DateTime-Calendar-Discordian
85
86COPYRIGHT AND LICENCE
87
88By Jaldhar H. Vyas <jaldhar@braincells.com>
89
90Copyright (C) 2012 Consolidated Braincells Inc.
91
92This distribution is free software; you can redistribute it and/or modify it
93under the terms of either:
94
95a) the GNU General Public License as published by the Free Software
96Foundation; either version 2, or (at your option) any later version, or
97
98b) the Artistic License version 2.0.
99
100The full text of the license can be found in the LICENSE file included
101with this distribution.
102