README
1 ==================
2 Buici-Clock README $Id: README,v 1.8 2001/10/31 04:55:54 elf Exp $
3 ==================
4 version <<version>> of <<date>>
5
6 by Marc Singer, elf@netcom.com
7 30 October 2001 (date of last revision)
8
9 This document explains how to compile and configure the Buici clock.
10 It also contains the release notes.
11
12
13 1. Introduction
14
15 I would have used another clock if I could find one. I found none.
16 The best available was swissclock-0.6, but it fails to draw a round
17 face on my X servers.
18
19 This release is somewhat limited. It keeps time and has an
20 attractive face that displays almost correctly. There will be a
21 couple of updates to add configurability and a date feature.
22
23
24 1.1. Copyright
25
26 The Buici Clock program is Copyright (C) 1997 by Marc Singer. It is
27 free software; you can redistribute it and/or modify it under the
28 terms of the GNU General Public License as published by the Free
29 Software Foundation; either version 2 of the License, or (at your
30 option) any later version.
31
32
33 1.2 The most current release of the Buici-Clock
34
35 This packages is included in the Debian releases. If your system
36 has access to the Debian archives, the following command will
37 install the latest version.
38
39 apt-get install buici-clock
40
41 Otherwise, it is available from the source.
42
43 <URL:ftp://ftp.buici.com/pub/buici-clock>
44
45
46 1.4 Feedback and Bug Reports
47
48 Bug reports may be sent to the author at <elf@debian.org>. There is
49 a plan to incorporate some form of automatic bug report generation
50 within the application, but until that is available e-mail is
51 likely to produce the best response.
52
53
54 1.5 Disclaimer
55
56 This program is distributed in the hope that it will be useful,
57 but WITHOUT ANY WARRANTY; without even the implied warranty of
58 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
59 General Public License for more details.
60
61
62 2.0 Building the Buici-Clock from Source
63
64 After unpacking the source archive, you will have a version numbered
65 directory buici-clock-X.Y.Z. In this directory is an autoconfig script.
66 This, building the program requires two steps.
67
68 configure
69
70 This script will evaluate your system and configure the directory
71 for building.
72
73 make
74
75 This command will compile the application and put a link to it in
76 the source directory. The program is called buici-clock.
77
78
79 3.0 Using the Buici-Clock
80
81 This version accepts only one standard X toolkit option, -geometry.
82 The most straighforward way to start the clock is to run a command
83 such as this:
84
85 ./buici-clock -geometry =100x100-4-4
86
87
88 3.1 Borderless Clock
89
90 There is a command line option to suppress the window manager's
91 ornaments.
92
93 ./buici-clock --no-ornaments
94
95 4.0 Release Notes
96
97 It has been a long time since the first release of this program. I
98 believe there are some lingering problems, but none have been
99 reported.
100
101 If you experience problems, I appreciate an e-mail to elf@buici.com
102 with a description of the problem and the output of the shell script
103 info.sh.
104
105 4.1 Timezones
106
107 The computation I use to display the time is incompatible with
108 conventional C library calls that convert the system clock time to
109 local time. The result is an algorithm that I believe is correct,
110 but I cannot verify in all time zones. If anyone's buici clock fails
111 to report the same time as the system "date" command please let me
112 know.
113
114 4.2 X Server Resources
115
116 There have been reports of crashes on some GNU/Linux machines, the
117 same platform on which I develop. One person tracked the trouble to
118 the ResourceManager database. This release includes a work-around,
119 but I want to discover the cause of this anomoly.
120
121 The configure script will test for what-I-believe-is-the-problem.
122 If it displays a message about a suspicious X server, please send me
123 the output of the info.sh Bourne shell script
124
buici-clock-0.4.9.README
1 ==================
2 Buici-Clock README $Id: README,v 1.8 2001/10/31 04:55:54 elf Exp $
3 ==================
4 version 0.4.9 of 23 July 2016
5
6 by Marc Singer, elf@netcom.com
7 30 October 2001 (date of last revision)
8
9 This document explains how to compile and configure the Buici clock.
10 It also contains the release notes.
11
12
13 1. Introduction
14
15 I would have used another clock if I could find one. I found none.
16 The best available was swissclock-0.6, but it fails to draw a round
17 face on my X servers.
18
19 This release is somewhat limited. It keeps time and has an
20 attractive face that displays almost correctly. There will be a
21 couple of updates to add configurability and a date feature.
22
23
24 1.1. Copyright
25
26 The Buici Clock program is Copyright (C) 1997 by Marc Singer. It is
27 free software; you can redistribute it and/or modify it under the
28 terms of the GNU General Public License as published by the Free
29 Software Foundation; either version 2 of the License, or (at your
30 option) any later version.
31
32
33 1.2 The most current release of the Buici-Clock
34
35 This packages is included in the Debian releases. If your system
36 has access to the Debian archives, the following command will
37 install the latest version.
38
39 apt-get install buici-clock
40
41 Otherwise, it is available from the source.
42
43 <URL:ftp://ftp.buici.com/pub/buici-clock>
44
45
46 1.4 Feedback and Bug Reports
47
48 Bug reports may be sent to the author at <elf@debian.org>. There is
49 a plan to incorporate some form of automatic bug report generation
50 within the application, but until that is available e-mail is
51 likely to produce the best response.
52
53
54 1.5 Disclaimer
55
56 This program is distributed in the hope that it will be useful,
57 but WITHOUT ANY WARRANTY; without even the implied warranty of
58 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
59 General Public License for more details.
60
61
62 2.0 Building the Buici-Clock from Source
63
64 After unpacking the source archive, you will have a version numbered
65 directory buici-clock-X.Y.Z. In this directory is an autoconfig script.
66 This, building the program requires two steps.
67
68 configure
69
70 This script will evaluate your system and configure the directory
71 for building.
72
73 make
74
75 This command will compile the application and put a link to it in
76 the source directory. The program is called buici-clock.
77
78
79 3.0 Using the Buici-Clock
80
81 This version accepts only one standard X toolkit option, -geometry.
82 The most straighforward way to start the clock is to run a command
83 such as this:
84
85 ./buici-clock -geometry =100x100-4-4
86
87
88 3.1 Borderless Clock
89
90 There is a command line option to suppress the window manager's
91 ornaments.
92
93 ./buici-clock --no-ornaments
94
95 4.0 Release Notes
96
97 It has been a long time since the first release of this program. I
98 believe there are some lingering problems, but none have been
99 reported.
100
101 If you experience problems, I appreciate an e-mail to elf@buici.com
102 with a description of the problem and the output of the shell script
103 info.sh.
104
105 4.1 Timezones
106
107 The computation I use to display the time is incompatible with
108 conventional C library calls that convert the system clock time to
109 local time. The result is an algorithm that I believe is correct,
110 but I cannot verify in all time zones. If anyone's buici clock fails
111 to report the same time as the system "date" command please let me
112 know.
113
114 4.2 X Server Resources
115
116 There have been reports of crashes on some GNU/Linux machines, the
117 same platform on which I develop. One person tracked the trouble to
118 the ResourceManager database. This release includes a work-around,
119 but I want to discover the cause of this anomoly.
120
121 The configure script will test for what-I-believe-is-the-problem.
122 If it displays a message about a suspicious X server, please send me
123 the output of the info.sh Bourne shell script
124