README
1dclock -- a digital clock for the X11 environment
2
3 Copyright (c) Dan Heller <argv@sun.com> 1988
4 v.2.0 Modifications by Tim Edwards <tim@sinh.stanford.edu> 1993
5 v.2.1 More modifications <tim@stravinsky.jhuapl.edu> 1999, 2000,
6 2001, 2002
7 v.2.2 Added support for antialiased fonts using freefont (Xft),
8 <tim@opencircuitdesign.com> 2008 (20th anniversary of dclock!)
9 Thanks to Amir J. Katz for beta-testing v.2.0 and the Imakefile.
10 Thanks to David A. Marks <dmarks@ford.com> for replacing the
11 missing Makefile.orig for compilation on Sun, HP, and other
12 systems.
13 Thanks to Andy Peterson <andy@petersonkids.com> for the UTC
14 patch.
15
16-----------------------------------------------------------------------
17
18Compile with xmkmf in the standard way:
19
20 xmkmf
21 make depend
22 make
23
24For those people not using xmkmf:
25
26 cp Makefile.orig Makefile
27 make
28
29Read the comments below about possible compilation complications.
30
31-----------------------------------------------------------------------
32Compiler notes:
33
341) Systems with no usleep() call should compile Dclock.c with -DNO_USLEEP.
35
362) Systems without freefont (Xft) libraries and include files should remove
37 "-DXFT_SUPPORT" from the Imakefile before running xmkmf.
38
393) Some systems may require changing "#include<time.h>" to
40 "#include<sys/time.h>" in Dclock.c.
41
424) This code is K&R standard, not ANSI standard. Beware with systems
43 which normally expect ANSI code in order to compile. May want to
44 use "gcc -traditional" to compile if your system has gcc.
45
46-----------------------------------------------------------------------
47
48When the program is running and the mouse is in the window, you can
49type the following keys:
50
51 r -- toggle reverse video
52 s -- toggle seconds display
53 b -- toggle the bell to ring on half hours
54 j -- toggle jump or smooth scrolling
55 d -- toggle date string display
56 m -- toggle military (24hr) time format
57 a -- toggle the alarm clock
58 f -- toggle fade
59 : -- toggle blinking of the colon
60 / -- increase angle of digits
61 \ -- decrease angle of digits
62 + -- increase thickness of digit segments
63 - -- decrease thickness of digit segments
64 > -- increase spacing between digits
65 < -- decrease spacing between digits
66 q -- quit
67
68To set the alarm time, use the third mouse button and click on the
69digits with the first and second buttons (to increase and decrease the
70number, respectively), until the time is set correctly. Alarm time is
71set in 24-hour format to distringuish between am and pm. If there is an
72asterisk on the same line as the date, then the alarm is set. Use the 'a'
73key to set the alarm, or click on the date area with any mouse button.
74
75-----------------------------------------------------------------------
76Typical uses:
77
78 # set alarm for noon
79 dclock -fg green -bg black -led_off gray20 -alarmTime 12:00 -alarm
80
81 # set date string and have bell go off on hour/half-hour intervals
82 dclock -date "Today is %A, %B %d" -fg yellow -bg brown -led_off brown4 -bell
83
84 # set date more simply, use 24-hour military time format and display secs
85 dclock -date "%a, %b %d" -miltime -seconds
86
87 # the traditional red glow, no slant
88 dclock -fg red -bg darkblue -led_off #500050 -slope 50
89
90 # a pleasant blue glow
91 dclock -fg cyan -bg darkblue -led_off blue4
92
93 # Matt Magri's LCD dclock (magri@anarcho.com)
94 dclock -miltime -seconds -date "= %A, %d %B %Y =" -dateup \
95 -fg black -bg gray56 -led_off gray53 \
96 -fn "-adobe-helvetica-bold-r-normal--*-100-*-*-*" \
97 -geometry 256x80+0+0 &
98
99-----------------------------------------------------------------------
100