README

   1 HTML-CalendarMonth
   2 -------------------
   3
   4 HTML::CalendarMonth is a module that simplifies the rendering of a
   5 calendar month in HTML. It is NOT a scheduling system.
   6
   7 Calendars are represented as HTML::Element based structures, derived
   8 from the HTML::ElementTable class.
   9
  10 The module includes support for 'week of the year' numbering, arbitrary
  11 1st day of the week definitions, and locale support.
  12
  13 If you wish to use 'week of the year' numbering, or want to explore
  14 dates beyond the capability of the internal perl time functions, then
  15 you will need Date::Calc, DateTime, or Date::Manip.
  16
  17 INSTALLATION
  18
  19 You install HTML-Calendar, as you would install any perl module library,
  20 by running these commands:
  21
  22    perl Makefile.PL
  23    make
  24    make test
  25    make install
  26
  27 DOCUMENTATION
  28
  29 See HTML/CalendarMonth.pm for the code. See Changes for recent changes.
  30 POD style documentation is included in the module. This is normally
  31 converted to a manual page and installed as part of the "make install"
  32 process. You should also be able to use the 'perldoc' utility to extract
  33 and read documentation from the module directly.
  34
  35 Some examples can be found here:
  36
  37    http://www.mojotoad.com/sisk/projects/HTML-CalendarMonth/examples.html
  38
  39 SUPPORT
  40
  41 There is a mailing list for HTML::Calendar. To subscribe or view past
  42 messages, please visit the following URL:
  43
  44    http://lists.sourceforge.net/mailman/listinfo/html-calmonth-general
  45
  46 Questions and comments may also be directed to Matt Sisk
  47 <sisk@mojotoad.com>
  48
  49 AVAILABILITY
  50
  51 The package is available from CPAN:
  52
  53    http://www.cpan.org/authors/id/M/MS/MSISK/
  54
  55 The package is also available at the Toadstool:
  56
  57    http://www.mojotoad.com/sisk/projects/HTML-CalendarMonth/
  58
  59 ACKNOWLEDGMENTS
  60
  61 Thanks to William R. Ward for some conceptual nudging. Thanks to Fabian
  62 Aichele, Jarkko Hietaniemi, Wolfgang Jürgensen, and David 'Sniper'
  63 Rigaudiere for some suggestions on global calendar customs. Thanks to
  64 Gael Marziou, Raul Rivero, Ricardo Signes, T. Bugra Uytun, and Philipp
  65 W. for some helpful bug spotting.
  66
  67 COPYRIGHT
  68
  69 Copyright (c) 1999-2010 Matthew P. Sisk. All rights reserved. All wrongs
  70 revenged. This program is free software; you can redistribute it and/or
  71 modify it under the same terms as Perl itself.