wmclock: Remove generated file wmclock.man.
This commit is contained in:
Doug Torrance
Carlos R. Mafra
parent
2d571d6d07
commit
0a2ff070a5
|
|
@ -1,232 +0,0 @@
|
||||||
.\" wmclock.man: manual page for wmclock -*- nroff -*-
|
|
||||||
.\" created 1999-Apr-09 jmk
|
|
||||||
.\"
|
|
||||||
.\" by Jim Knoble <jmknoble@pobox.com>
|
|
||||||
.\" Copyright (C) 1999 Jim Knoble
|
|
||||||
.\" Based on asclock.man by Dan Weeks.
|
|
||||||
.\"
|
|
||||||
.\" Disclaimer:
|
|
||||||
.\"
|
|
||||||
.\" The software is provided "as is", without warranty of any kind,
|
|
||||||
.\" express or implied, including but not limited to the warranties of
|
|
||||||
.\" merchantability, fitness for a particular purpose and
|
|
||||||
.\" noninfringement. In no event shall the author(s) be liable for any
|
|
||||||
.\" claim, damages or other liability, whether in an action of
|
|
||||||
.\" contract, tort or otherwise, arising from, out of or in connection
|
|
||||||
.\" with the software or the use or other dealings in the software.
|
|
||||||
.\"
|
|
||||||
.de TQ
|
|
||||||
.br
|
|
||||||
.ns
|
|
||||||
.TP \\$1
|
|
||||||
..
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.TH wmclock 1x "2010-Dec-22" "Version 1.0.14"
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH NAME
|
|
||||||
.PP
|
|
||||||
.BR wmclock :
|
|
||||||
a dockable clock for the Window Maker window manager
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.HP
|
|
||||||
\fBwmclock\fP [{\-12|\-24|\-year}] [\-noblink] [\-version] [\-exe \fIprogram\fP]
|
|
||||||
[\-led \fIcolor\fP] [\-monthxpm \fIfilename\fP] [\-weekdayxpm
|
|
||||||
\fIfilename\fP]
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
.B Wmclock
|
|
||||||
is an applet which displays the date and time in a dockable tile in the
|
|
||||||
same style as the clock from the NEXTSTEP(tm) operating system.
|
|
||||||
.B Wmclock
|
|
||||||
is specially designed for the Window Maker window manager, by Alfredo
|
|
||||||
Kojima, and features multiple language support, twenty-four-hour and
|
|
||||||
twelve-hour (am/pm) time display, and, optionally, can run a
|
|
||||||
user-specified program on a mouse click.
|
|
||||||
.B Wmclock
|
|
||||||
is derived from
|
|
||||||
.BR asclock ,
|
|
||||||
a similar clock for the AfterStep window manager.
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH OPTIONS
|
|
||||||
.TP
|
|
||||||
\fB\-12\fR or \fB\-24\fR
|
|
||||||
Display the time in either twelve-hour format (with am/pm) or
|
|
||||||
twenty-four-hour format. Defaults to twenty-four-hour display.
|
|
||||||
.TP
|
|
||||||
\fB\-year\fR
|
|
||||||
Display the current year in the LED display instead of the time.
|
|
||||||
.TP
|
|
||||||
\fB\-noblink\fR
|
|
||||||
The separator between the hours and minutes in the time display blinks
|
|
||||||
by default. This option turns off the blinking and displays a steadily
|
|
||||||
lit separator instead.
|
|
||||||
.TP
|
|
||||||
\fB\-version\fB
|
|
||||||
Displays the version of Wmclock.
|
|
||||||
.TP
|
|
||||||
\fB\-exe\fR \fIcommand\fR
|
|
||||||
Run
|
|
||||||
.I command
|
|
||||||
in the background when a mouse button is pressed over
|
|
||||||
.BR wmclock .
|
|
||||||
See below for details.
|
|
||||||
.TP
|
|
||||||
\fB\-led\fR \fIcolor\fR
|
|
||||||
Use
|
|
||||||
.I color
|
|
||||||
as the foreground color of the LED display.
|
|
||||||
.I Color
|
|
||||||
may be either a named color from the rgb.txt database (for example,
|
|
||||||
`red' or `chartreuse') or a numeric color specification in any of the usual
|
|
||||||
X11 formats (for example, `#ff0000' or `rgb:7f/ff/00'). See the
|
|
||||||
.BR X (1)
|
|
||||||
man page for more information.
|
|
||||||
.TP
|
|
||||||
\fB\-monthxpm\fR \fIfilename\fR
|
|
||||||
Get month abbreviations from
|
|
||||||
.IR filename ,
|
|
||||||
which is expected to be in the XPM format. See below for details.
|
|
||||||
.TP
|
|
||||||
\fB\-weekdayxpm\fR \fIfilename\fR
|
|
||||||
Get weekday abbreviations from
|
|
||||||
.IR filename ,
|
|
||||||
which is expected to be in the XPM format. See below for details.
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH INVOCATION AND EXAMPLES
|
|
||||||
.PP
|
|
||||||
The simplest way to start
|
|
||||||
.B wmclock
|
|
||||||
is:
|
|
||||||
.PP
|
|
||||||
.RS
|
|
||||||
.TQ
|
|
||||||
wmclock
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
.B Wmclock
|
|
||||||
displays in its own appicon, which you can place in Window Maker's dock
|
|
||||||
by holding down the [Alt] or [Meta] key and dragging
|
|
||||||
.B wmclock
|
|
||||||
to the dock with the primary mouse button (usually the left one).
|
|
||||||
.PP
|
|
||||||
For a more complicated example:
|
|
||||||
.PP
|
|
||||||
.RS
|
|
||||||
.TQ
|
|
||||||
wmclock \-12 \-led gold \-exe /usr/GNUstep/Apps/WPrefs.app/WPrefs
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
This displays 12-hour time in an amber-colored LED display, and starts
|
|
||||||
Window Maker's preferences utility when you click on
|
|
||||||
.BR wmclock .
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH DETAILS
|
|
||||||
.SS Running Commands
|
|
||||||
.PP
|
|
||||||
When you use
|
|
||||||
.B wmclock
|
|
||||||
with the
|
|
||||||
.B \-exe
|
|
||||||
option,
|
|
||||||
.B wmclock
|
|
||||||
will run the command you specify whenever you press a mouse button
|
|
||||||
while the mouse cursor is over
|
|
||||||
.BR wmclock .
|
|
||||||
.B Wmclock
|
|
||||||
uses the
|
|
||||||
.BR system (3)
|
|
||||||
function from the C library (and ultimately
|
|
||||||
.BR /bin/sh )
|
|
||||||
to run the command; hence, the command must be in Bourne-shell syntax.
|
|
||||||
.SS Using Alternate Month and Weekday Abbreviations
|
|
||||||
.PP
|
|
||||||
You can use the
|
|
||||||
.B \-monthxpm
|
|
||||||
and
|
|
||||||
.B \-weekdayxpm
|
|
||||||
options to convince
|
|
||||||
.B wmclock
|
|
||||||
to display month and day-of-week abbreviations in a language besides
|
|
||||||
the one it was compiled with, or to display them in a language that
|
|
||||||
.B wmclock
|
|
||||||
does not yet support. The files you specify must be in the XPM format,
|
|
||||||
and they must follow the same strict size and placement as the month
|
|
||||||
and weekday XPMs that come in the
|
|
||||||
.B wmclock
|
|
||||||
source package. Each weekday abbreviation must be 21 pixels wide and 6
|
|
||||||
pixels high; each month abbreviation must be 22 pixels wide and 6
|
|
||||||
pixels high. The month abbreviations must be arranged vertically,
|
|
||||||
beginning with January at the top and continuing down to December at
|
|
||||||
the bottom. The weekday abbreviations must also be arranged
|
|
||||||
vertically, beginning with Monday at the top and continuing to Sunday
|
|
||||||
at the bottom.
|
|
||||||
.SS Obsolete Options
|
|
||||||
.PP
|
|
||||||
In order to maintain command-line compatibility (mostly) with
|
|
||||||
.BR asclock ,
|
|
||||||
.B wmclock
|
|
||||||
accepts a few options on the command line without complaining, even
|
|
||||||
though they don't have any effect. The options which
|
|
||||||
.B wmclock
|
|
||||||
accepts in this manner are
|
|
||||||
.B \-shape
|
|
||||||
and
|
|
||||||
.BR \-iconic .
|
|
||||||
Some dockable versions of
|
|
||||||
.B asclock
|
|
||||||
required one or both of these options to become properly dockable.
|
|
||||||
However, Since
|
|
||||||
.B wmclock
|
|
||||||
is designed for Window Maker's dock, it already displays in a shaped
|
|
||||||
window in its own dockable appicon.
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH BUGS
|
|
||||||
.PP
|
|
||||||
.B Wmclock
|
|
||||||
shouldn't run a command on a single click; should use a double click
|
|
||||||
instead.
|
|
||||||
.PP
|
|
||||||
.B Wmclock
|
|
||||||
should use Alfredo Kojima's libdockapp library instead of inventing its
|
|
||||||
own wheel.
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH SEE ALSO
|
|
||||||
.PP
|
|
||||||
X(1), asclock(1x), wmaker(1x), system(3)
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH COPYRIGHT AND LICENSE
|
|
||||||
.PP
|
|
||||||
Copyright (C) 1999 by Jim Knoble <jmknoble@pobox.com>. Significant
|
|
||||||
portions of
|
|
||||||
.B wmclock
|
|
||||||
are directly derived from
|
|
||||||
.B asclock
|
|
||||||
by Beat Christen, who, along with
|
|
||||||
.BR asclock 's
|
|
||||||
other authors, owns the copyright to those portions of
|
|
||||||
.BR wmclock .
|
|
||||||
.PP
|
|
||||||
.B Wmclock
|
|
||||||
is licensed under the GNU General Public License, version 2, or (at
|
|
||||||
your option) any later version. See <http://www.gnu.org/> for more
|
|
||||||
information.
|
|
||||||
.SH AUTHORS
|
|
||||||
.TQ
|
|
||||||
Jim Knoble <jmknoble@pobox.com>
|
|
||||||
.TQ
|
|
||||||
Beat Christen <spiff@longstreet.ch>, author of \fBasclock\fI
|
|
||||||
.\" ----------------------------------------------------------------
|
|
||||||
.SH DISCLAIMER
|
|
||||||
.PP
|
|
||||||
The software is provided ``as is'', without warranty of any kind,
|
|
||||||
express or implied, including but not limited to the warranties of
|
|
||||||
merchantability, fitness for a particular purpose and noninfringement.
|
|
||||||
In no event shall the author(s) be liable for any claim, damages or
|
|
||||||
other liability, whether in an action of contract, tort or otherwise,
|
|
||||||
arising from, out of or in connection with the software or the use or
|
|
||||||
other dealings in the software.
|
|
||||||
.PP
|
|
||||||
Your mileage may vary. Eat your vegetables.
|
|
||||||
|
|
||||||
Loading…
Reference in a new issue