packages icon
*****************************************************************************

Libmdate 0.0.3 - this code (C) 2000 Mdate Development Team, 
all rights and responsibilites not otherwise retained by
other authors, or the provisions of the GPL are reserved.

The meaning of all that is simply that I am the author of this code with
derivations of some algorithms of other authors, and it is I that assume the
responsibility for the program, not them.

From the release of Mdate version 1.1.0, copyright will now reside with the
Mdate Development Team as a group copyright. This is to thank (and hopefully
stimulate) the help of all developers!

Libmdate falls under the exact same copyright as Mdate did/does.

Please read the COPYRIGHT and LICENSE documents: they list your rights and
responsibilities pertaining to this software.

*****************************************************************************

This program is not intended for the experts in mayan calendrical systems,
although it is hoped it will be of use to them in some way. It is really
intended for the enthusiast and the curious, as well as providing an
alterntative to ddate :) .

Please bear with the fact that this program is still evolving; it could use
some more bells and whistles, and a GUI interface would be much nicer :). See
the TODO file for a list of things to consider.

Developers are URGENTLY required to help with translations, and further
interfaces for Mdate. Please apply to Sean Dwyer <ewe2@users.sourceforge.net>
so I can add you to the team!

NEW! NEW! NEW!

from Mdate version 1.1.0, we proudly announce a new home at:

http://mdate.sourceforge.net/

Please see the AUTHORS file for how to contact the project admin if you have
skills to contribute :)

*******************************************************************************

Extra stuff
-----------

In the doc/ directory, there are a few trivial test files:

iterate.pl - main test program for outputting either dates by year or Calendar
Round from the epoch. The output is in either year-list or cr-list.

awky - awk script in conjunction with iterate.pl
perly.pl - perl equivalent of awky, alternate if you can't stand awk.

ewe2.gpg - my gnupg key if that is desired.

*****************************************************************************

Notes on the implementation
---------------------------

We use the 285 correlation in preference to the standard G-M-T because of the
many objections to GMT assumptions, and the much better correlation to
astronomical events. Add two days to your dates if it really bothers you, or
alter the correlation in mdate.h to taste.

What this program REALLY needs is rough beta-testing and PORTING to other
architectures than the ones i have access to (or have compilers for)! If
people think it is worth more than a simple CLI utility, perhaps (gasp!)
something more GTK+ for the GUI crowd??

At some point, a proper API/implementation document should be written..

Libmdate is at quite an early stage, so be prepared for the API to change a
lot: at this stage it is quite stable for implementing a console interface,
but hitting it with big-time X interfaces should flush out the real problems.

See what you can do with it...


Sean Dwyer <ewe2@users.sourceforge.net>


$Id: README,v 1.1.1.1 2000/04/07 02:37:47 ewe2 Exp $
$Log: README,v $
Revision 1.1.1.1  2000/04/07 02:37:47  ewe2
initial libmdate import

Revision 1.2  2000/03/26 06:38:38  ewe2
Mdate 1.1.0 tentative version

Revision 1.1.1.1  2000/03/16 03:39:17  ewe2
Initial import

$State: Exp $