wmtime/wmtime.1

   1 '\" t
   2 .\" Man page for wmtime
   3 .\" Copyright (c) 2003  Software in the Public Interest, Inc.
   4 .\"
   5 .\" This program is free software; you can redistribute it and/or modify
   6 .\" it under the terms of the GNU General Public License as published by
   7 .\" the Free Software Foundation; either version 2 of the License, or (at
   8 .\" your option) any later version.
   9 .\"
  10 .\" This program is distributed in the hope that it will be useful, but
  11 .\" WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 .\" General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program; if not, write to the Free Software
  17 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
  18 .\" USA.
  19 .\"
  20 .TH WMTIME 1 "January 2015" "WMTIME"
  21
  22 .SH NAME
  23 wmtime \- Window Maker dockapp that displays the time and date
  24
  25 .SH SYNOPSIS
  26
  27 .B wmtime
  28 [
  29 .I OPTION
  30 ]
  31
  32 .SH DESCRIPTION
  33
  34 .B WMTime
  35 displays the time and date and gives you some nice additional
  36 features too. It is intended for docking in Window Maker.
  37
  38 It currently provides:
  39
  40 .IP \(bu 4
  41 the time and date;
  42
  43 .IP \(bu
  44 a realtime morphing interface (analog <> digital mode);
  45 .IP \(bu
  46 auto\-scaled and anti\-aliased hands;
  47 .IP \(bu
  48 localization, displaying the day and date in various languages;
  49 .IP \(bu
  50 three user\-defined commands to launch.
  51
  52 .SH OPTIONS
  53
  54 .TP
  55 .BR \-d , \ \-digital
  56 Display the digital clock on startup, instead of the analog clock.
  57
  58 .TP
  59 .BI \-display \ display
  60 This option specifies the X server to contact; see
  61 .IR X(7x) .
  62
  63 .TP
  64 .BI \-geometry \ geometry
  65 This option specifies the preferred position of clock; see
  66 .IR X(7x) .
  67
  68 .TP
  69 .BR \-n , \ \-noseconds
  70 Disables the second hand.
  71
  72 .TP
  73 .BI \-l \ locale
  74 Specify locale.
  75
  76 .TP
  77 .B \-h
  78 Show help information.
  79
  80 .TP
  81 .B \-v
  82 Print the version number.
  83
  84 .TP
  85 .B \-c
  86 Set color.
  87
  88 .SH USAGE
  89 The
  90 .B WMTime
  91 window is separated into top and bottom sections.  The top section
  92 contains a clock and the bottom section contains the date.
  93
  94 The clock can be toggled between analog and digital modes.  To do this,
  95 click in the bottom section of the window.
  96
  97 WMTime can also be used to launch programs.  You may click either left,
  98 middle, or right mouse buttons in the top section of the window.  The
  99 pre\-configured program will be launched according to the mouse button
 100 clicked.  (see
 101 .B CONFIGURATION FILE
 102 below.)
 103
 104 In order to move
 105 .BR WMTime ,
 106 drag on the outer edges.  These are not sensitive to mouse clicks.
 107
 108 .SH "DOCKING IN WINDOW MANAGERS"
 109
 110 .TP
 111 Window Maker
 112
 113 Window Maker users should drag and drop the
 114 .B WMTime
 115 window on the Dock.  Then, right\-click on the border of the window and
 116 select \*(lqSettings...\*(rq.  Check \*(lqStart when Window Maker
 117 is started\*(rq.
 118
 119 .TP
 120 AfterStep
 121
 122 AfterStep users should put the following in their
 123 .I $HOME/.steprc
 124
 125 .RS 16
 126 Wharf wmtime \- MaxSwallow "wmtime" wmtime &
 127 .RE
 128
 129 .TP
 130 Other window managers
 131
 132 .B WMTime
 133 runs nicely as a 64x64 shaped icon on your desktop.
 134
 135 .SH "CONFIGURATION FILE"
 136
 137 .B WMTime
 138 can launch three user\-defined commands, triggered by left, middle and
 139 right mouse button clicks.  You can define the commands to launch in
 140 .I $HOME/.wmtimerc
 141
 142 .RS
 143 .PD 0
 144 left: xterm
 145 .PP
 146 middle: xload
 147 .PP
 148 right: xcalc
 149 .PP
 150 .PD
 151 .RE
 152
 153 If
 154 .B WMTime
 155 detects a
 156 .I $HOME/.wmtimerc
 157 file, it will launch the appropriate command when you click on the clock.
 158
 159 The system administrator can define default commands in
 160 .IR /etc/wmtimerc .
 161 The administrator may also choose to \*(lqfix\*(rq particular commands,
 162 making it impossible for users to change.  These commands can be defined in
 163 .IR /etc/wmtimerc.fixed ,
 164 although this isn't a nice thing to do.
 165
 166 .SH FILES
 167
 168 .I /etc/wmtimerc
 169 .br
 170 .I $HOME/.wmtimerc
 171 .br
 172 .I /etc/wmtimerc.fixed
 173
 174 .SH AUTHORS
 175
 176 .B WMTime
 177 was written by Martijn Pieterse and Antoine Nulle.
 178
 179 This manual page was written by Simon Law <sfllaw@debian.org> for the
 180 .B Debian
 181 system (but may be used by others). It is based on the documentation provided
 182 by the original program.
 183
 184 This manual is free software; you can redistribute it and/or modify
 185 it under the terms of the GNU General Public License as published by
 186 the Free Software Foundation; either version 2 of the License, or (at
 187 your option) any later version.