ftp.nice.ch/pub/next/tools/preferences/holidays.README

This is the README for holidays.NIHS.b.tar.gz [Download] [Browse] [Up]

holidays
--------

A program to enhance the Time Preferences with holiday icons designed by the
original artist working for NeXT.

A long time ago I noticed that
/NextApps/Preferences.app/TimeStuff.aux/English.lproj/days.tiff has more than
just day number images in it.  There are also images for Christmas, Flag Day,
Halloween, Thanksgiving Day, Valentine's Day, Easter Sunday, New Year's Day,
Hanukkah, Armed Forces Day, St. Patrick's Day, Mother's Day, President's Day,
Independence Day, Election Day, Columbus Day, Veteran's Day, United Nations
Day, and Father's Day.  Whew!

I tried asking the UseNet comp.sys.next community if anyone knew how to enable
the display of these images within Preferences.  I think I eventually got a
response from a NeXT employee indicating that there was no code to take
advantage of them.  So I gave up and moved on to other things.

Thanks to a question from Kevin J. Barth a long time later, I finally decided
to write the code myself.  I referenced Webster for the rules which determine
when certain holidays occur each year, and borrowed a table from source code by
Mike Falconer which listed the dates for Easter Sunday between now and the year
2002.

holidays creates a backup of the original TIFFs and then modifies the copy to
display the images for this month's holidays.  There is a Usage message that
shows how to create test images for months other than the current one.  I tried
my best to correctly calculate the date for each moving holiday, and also made
a personal judgement on what holiday went with each image.  If you find a
problem and can back it up with a reliable reference, please let me know so I
can update the program's tables.


SUPPORTED PLATFORMS
-------------------

NeXT/Motorola, Intel, HP-PA RISC, SPARC


NEXTSTEP VERSION REQUIREMENTS
-----------------------------

Release 3.1, 3.2 and 3.3 (not 3.0 and earlier, since they cannot understand FAT
binaries).  I may compile versions for 3.0 and perhaps 2.x if I get a chance to
reboot my machine from an Optical Disk which can run the Developer Tools for
those releases.


INSTALLATION INSTRUCTIONS
-------------------------

Copy the executable to /usr/local/bin and add the following to /usr/adm/monthly

# Update the Date & Time Preferences
/usr/local/bin/holidays

The program will take effect on the first day of the next month.  If you want
to see the holiday icons without waiting for the automatic update, just run the
program as root.


LEGAL STUFF
-----------

I am tired of legalese, so I will word the following in plain english.  The
language should be precise enough to avoid misunderstanding in the event that
legal action is necessary.

Please do not charge money for this utility or for any service you provide
using this utility.  Please do not remove my name from this README, the
executable, or its associated user interface files.  Please do not distribute
modified versions of any of these files.  I hold the copyrights for this
utility and do not give permission for it to be distributed on CD-ROM without
my prior written permission.  For those of you who are compiling CD-ROM
archives of software available freely via ftp, these restrictions are aimed
directly at you - especially if you are planning to charge for the CD-ROM, but
even if you are not.  I would suggest keeping a copy of this README around to
remind you not to forget about the restrictions I have placed on this free
software.  Future versions are not guaranteed to be free.

There are no guarantees or warranties associated with this free software.  You
must accept it as is or else do without it.


CONTACT INFORMATION
-------------------

Brian Willoughby
Software Design Engineer
Sound Consulting: Software Design and Development
NeXTmail welcome
BrianW@SoundS.WA.com
Bellevue, WA


EOF
---

These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.