README file for enclosed data files.

The Gcal package encloses a collection of reminder/appointment files of
other packages, namely the BSD-`calendar' reminder files and the
[X]`Calentool-2.3' appointment files.  These original and untouched
files are stored in the `calendars/' and `dates/' subdirectories, and
are converted automatically during the installation process of `gcal'
by means of `awk' or `perl'.  The AWK and Perl scripts (stored in
`scripts/' subdirectory) which I've worked out are not perfect but do
their job well for the enclosed reminder/appointment files.

These scripts don't break the text part at any margin by default.  If
you want to have text parts breaked at a special margin, define this in
the variable `linebreak' (near the top of each script) explicitly before
you use the `install' target of the Makefile.  I recommend to use a
margin value of 40...50.  This is only an experimental feature.  It does
not guarantee any *nicer* representation of texts, but I've implemented
it because some people might want it.

Because the collection of reminder/appointment files is enclosed
original and untouched AS IS, there is no warranty of any kind, either
expressed or implied!  The entire risk as to the quality and fitness
for a particular purpose is with you.

If conversion from other calendar management tools is required, some
converters can be found in the [X]`Calentool-2.3' package (written by
Bill Randle):

`cm2calentool.e'
     Converts *sun calendar manager* files to `Calentool' appointment
     files

`cal2ct.c'
     Converts `calendar' files to `Calentool' appointment files

`month2ct.c'
     Converts `month' files to `Calentool' appointment files

`mt2ct.c'
     Converts `monthtool' files to `Calentool' appointment files

Once you have converted a reminder/appointment file into the
[X]`Calentool-2.3' appointment file format, you can convert this file to
the Gcal format using `awk' or `perl' and the according script file
`ct2gcal.awk' respectively `ct2gcal.pl'.

