1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
.TH asclock 1x "23 July 1996"
.UC
.SH NAME
\fBasclock\fP \- the AfterStep clock
.SH SYNOPSIS
.B asclock
[ -help] [-12 | -24] [-shape]
[-position \fI[+|-]x[+|-]y\fP]
[-exe \fIprogram\fP]
[-theme \fIdir\fP]
[-led \fIcolor\fP]
[-noblink]
[-dock]
[-version]
.SH DESCRIPTION
The \fBasclock\fP is a clock written to emulate the date/time application on
the NEXTSTEP(tm) operating system. \fBasclock\fP supports multiple languages,
military and AM/PM time formats, program execution, and the shape extension
to X-Windows.
.SH CONFIGURATION OPTIONS
.IP "-help"
.RS
prints the usage message:
.nf
usage: asclock [-options ...]
where options include:
-12 12 hour format
-24 24 hour format
-exe <program> program to start on click
-led <color> color of the led
-position [+|-]x[+|-]y position of asclock
-shape without groundplate
-theme <dir> theme directory
-noblink don't blink
-dock without window decorations
-version show version information
.fi
.RE
.IP "-12 or -24"
.RS
sets the desired time format to either twelve hour
with AM/PM ( -12 ) or military time ( -24 ). If no
option is given military time is used.
.RE
.IP "-shape"
.RS
turn on shaped window support for \fBasclock\fP. When this is turned on the
\fBasclock\fP windows will only appear to be the led and date pad. By default
shaped windows are turned off and the clock will appear on a 64 pixel by 64
pixel base.
.RE
.IP "-led <color>"
.RS
specifies the color of the led. To find out what colors are available, try
.I showrgb
.P (part of X11).
.RE
.IP "-position [+|-]x[+|-]y "
.RS
specifies the starting position of \fBasclock\fP. The [+|-] works like the standard X-Windows x/y geometry option.
.RE
.IP "-exe <program>"
.RS
specifies the application to start when the pointer is activated over \fBasclock\fP. To invoke applications with parameters, you have to set quotes around the command. See example below...
.RE
.IP "-noblink"
.RS
specifies if asclock should blink.
.RE
.IP "-theme <dir>"
.RS
specifies the theme to used. A theme consists of a directory
containing 8 xpms and a position file called 'config'. Read the
\fIThemes\fP section.
.RE
.IP "-dock"
.RS
tells the window manager not to put window decorations arround
asclock, useful for docking with \fIWindow Maker\fP.
.RE
.SH INVOCATION
\fBasclock\fP can be called from one of many ways. The most common invocation
is the command line:
.nf
[user@host] ~% asclock -12 -exe 'xlock -mode hop' &
.fi
Another way to call \fBasclock\fP is from the window manager:
.nf
*Wharf - - MaxSwallow "asclock" asclock -theme shape -12&
.fi
This line, when placed in the \fI.steprc\fP file in the users home directory
will cause \fBasclock\fP to use the shape extensions so that it will be a
button on the \fBWharf (1)\fP button bar under the \fBafterstep (1)\fP
window manager.
.SH THEMES
A theme consists of a directory containing 8 xpms and a position file
called 'config'. All tiles within the same xpm must have the same
width or height, except the colon which has half the width of the
other digits. The pixmaps are called: \fIclock.xpm\fP,
\fIdate.xpm\fP, \fIled.xpm\fP, \fImonth.xpm\fP, \fIweekday.xpm\fP,
\fIhour.xpm\fP, \fIminute.xpm\fP, \fIsecond.xpm\fP. For a full
description of the format, take a look at \fIREADME.THEMES\fP.
.SH BUGS
we don't have bugs :)
.SH COPYRIGHTS
Copyright 1996, Beat Christen <bchriste@iiic.ethz.ch>. No guarantees or
warranties or anything are provided or implied in any way whatsoever.
Use this program at your own risk. Permission to use this program for
any purpose is given, as long as the copyright is kept intact.
.SH AUTHORS
Beat Christen <bchriste@iiic.ethz.ch> -- application
.sp
Dan Weeks <dan@mango.sfasu.edu> -- man page
|
