Sun Clock - X11 Version 1.5, Apr 07, 1999. ========================================== This version has settable foreground and background colours (with `-fg Color' and `-bg Color' options) thanks to Michael Richmond (mar@mri.mq.edu.au). Also, the last remaining problems with updates of the main and icon windows are hopefully fixed. See the CHANGES file in the distribution for more details and a brief history of the released versions. To compile, test and install, use % cd sunclock-1.5 % xmkmf % make % ./sunclock & % make install % make install.man or use the supplied `Makefile.noimake' if you really can't use imake. Wolfram Gloger, wmglo@dent.med.uni-muenchen.de Original README =============== X11 version by John Mackin, , based on a Suntools program by John Walker, . This program is a clock that shows which portion of the Earth's surface is illuminated by the Sun. It is designed to be usually iconic, but can be opened for a larger display with the time updated every second and both the local timezone and UTC displayed. The Suntools version had a menu that allowed you to speed up time, show different dates, etc., but I have never implemented any of that in the X version; there is some support for it in the code, however. The program should have been written using Xt rather than raw Xlib, and I tried that at first. I couldn't get the icon window to work, though, so I abandoned that version. Hence, the program does _not_ accept most Xt-style command line options; valid options are given in the manual page. The program has been tested on a number of different clients (MIPS, Sun, VAX) and servers (MIPS colour console, Sun MIT mono, NCD-16/19), under X11R3 and R4. If you find bugs, please report them to me, john@cs.su.oz.AU. To build the program, decide whether you want to use imake or not. If you don't, link Makefile.dist to Makefile, and edit it, otherwise edit the Imakefile and use xmkmf. The program uses two fonts, one for the icon display and one for the large window display. The names of these fonts are compiled in. The font names comes from -DBIGFONT and -DSMALLFONT in the Makefile. If you are not using imake, you will need to supply a -DSYSV option if you are System V. You should supply -DNEW_CTIME if you are using the table-driven ctime and a "struct tm" contains a tm_zone field. If neither of the ways of getting the local timezone name works on your system, please let me know. The original Suntools program, in case you want it, was posted as Volume 1, Issue 79 of comp.sources.sun. This program is public domain and may be freely copied as long as the notices at the top of sunclock.c remain intact.