Here is the document I started that lists the DT namespaces.  It's been just sitting 
on my disk for several weeks so I figure I might as well get it finished.  It's pretty 
short on details - although I don't think much more needs to be added.  Any comments?

-J

--
=pod

=head1 DateTime::* Namespace Guidelines

This document attempts to define the the various 2nd tier C<DateTime> namespaces and 
the appropriate functionality of modules residing there.

=head2 Namespace Allocation

C<DateTime::*> namespace is allocated by the C<[EMAIL PROTECTED]> mailing list.  Do 
not create a new 2nd tier namespace without first seeking approval from the list.  
Unless specifically noted as C<open> most 2nd tier namespaces are not available to 3rd 
party developers.

=head2 Authors

All DateTime authors are encourage to

1) consult the C<[EMAIL PROTECTED]> mailing list before uploading any module.

2) register their module's namespace with PAUSE.

=over 4

=item * DateTime

Obviously this is the root namespace. C<DateTime.pm> is the generic DateTime object 
implementing the Gregorian calendar.

=item * DateTime::Calender

Modules implementing calendars that can be converted to/from other C<DateTime> and 
other C<DateTime::Calendar::*> objects.  Please see C<datetime-calendar.pod> for 
developer documentation.

This is an C<open namespace>.

=item * DateTime::Duration

This is a simple class for representing duration objects.
These objects are used whenever you do date math with DateTime.pm.

=item * DateTime::Event

Modules implementing the occurrence of an event.

This is an C<open namespace>.

=item * DateTime::Fiction

This is somewhat of an unusual namespace.  It is intended for modules implementing 
calendars from fictional works.  This namespace is exempted from the requirement to be 
interpretable with C<DateTime> and C<DateTime::*>.

This is an C<open namespace>.

=item * DateTime::Format

Modules capable of parsing specific Date/Time formats and/or being able to format 
strings.

This is an C<open namespace>.

=item * DateTime::Infinite

Infinite past and future DateTime objects.

=item * DateTime::Language

The current implementation of DateTime language localization. C<DateTime::Language> is 
the base class and also provides a module loading facility.  All modules under 
C<DateTime::Language::*> need to inherit from C<DateTime::Language>.

=item * DateTime::LeapSecond

Leap seconds table and utilities.

=item * DateTime::Locale

The new implementation of localization support for DateTime.

This is as of yet unreleased.

=item * DateTime::Set

DateTime sets and set math.

=item * DateTime::Span

DateTime time-ranges.

=item * DateTime::SpanSet

Sets of DateTime spans.

=item * DateTime::TimeZone

Time zone objects and base class.

=cut

Reply via email to