Buici-Clock README $Id: README,v 1.7 1998/10/14 00:40:07 elf Exp $
version <<version>> of <<date>>
by Marc Singer, firstname.lastname@example.org
22 October 1997 (date of last revision)
This document explains how to compile and configure the Buici clock.
It also contains the release notes.
I would have used another clock if I could find one. I found none.
The best available was swissclock-0.6, but it fails to draw a round
face on my X servers.
This release is somewhat limited. It keeps time and has an
attractive face that displays almost correctly. There will be a
couple of updates to add configurability and a date feature.
The Buici Clock program is Copyright (C) 1997 by Marc Singer. It is
free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your
option) any later version.
1.2 The most current release of Buici
There is presently only one site for Buici.
1.4 Feedback and Bug Reports
Bug reports may be sent to the author at <email@example.com>. There is
a plan to incorporate some form of automatic bug report generation
within the application, but until that is available e-mail is
likely to produce the best response.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
2.0 Building the Buici Clock from Source
After unpacking the source archive, you will have a version numbered
directory buici-clock-X.Y.Z. In this directory is an autoconfig script.
This, building the program requires two steps.
This script will evaluate your system and configure the directory
This command will compile the application and put a link to it in
the source directory. The program is called buici-clock.
3.0 Using the Buici Clock
This version accepts only one standard X toolkit option, -geometry.
The most straighforward way to start the clock is to run a command
such as this:
./buici-clock -geometry =100x100-4-4
4.0 Release Notes
In this ALPHA release, the clock ought to show the correct time,
respond correctly to the -geometry option, and not crash. It is
ALPHA because it is not feature complete.
If you experience problems, I appreciate an e-mail to firstname.lastname@example.org
with a description of the problem and the output of the shell script
The computation I use to display the time is incompatible with
conventional C library calls that convert the system clock time to
local time. The result is an algorithm that I believe is correct,
but I cannot verify in all time zones. If anyone's buici clock fails
to report the same time as the system "date" command please let me
4.2 X Server Resources
There have been reports of crashes on some GNU/Linux machines, the
same platform on which I develop. One person tracked the trouble to
the ResourceManager database. This release includes a work-around,
but I want to discover the cause of this anomoly.
The configure script will test for what-I-believe-is-the-problem.
If it displays a message about a suspicious X server, please send me
the output of the info.sh Bourne shell script