asclock(1.0)

NAME
asclock - the AfterStep clock

SYNOPSIS
asclock [ -help] [-12 | -24] [-shape]
        [-exe program]
        [-led color]
        [-clockxpm xpm]
        [-monthxpm xpm]
        [-weekdayxpm xpm]
        [-year]
        [-position [+|-]x[+|-]y]
        [-noblink] [-iconic] [-dock]

DESCRIPTION
The asclock is a clock written to emulate the date/time application on the NEXTSTEP(tm) operating system. asclock supports multiple languages, military and AM/PM time formats, program execution, and the shape extention to X-Windows.

CONFIGURATION OPTIONS

-help
    prints the usage message:
            usage:  asclock [-options ...]
            where options include:
                -12                     12 hour format
                -24                     24 hour format
                -shape                  without groundplate
                -exe <program>          program to start on click
                -led <color>            color of the led
                -clockxpm <xpm>         clock xpm
                -monthxpm <xpm>         month xpm
                -weekdayxpm <xpm>       weekday xpm
                -year                   show year instead of time
                -position [+|-]x[+|-]y  position of asclock
                -noblink                don't blink
                -iconic                 start up as icon
                -dock                   Window Maker docking

-12 or -24
    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.

-shape
    turn on shaped window support for asclock. When this is turned on the asclock 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.

-led <color>
    specifies the color of the led. To find out what colors are available, try showrgb

-monthxpm <xpm>
    specifies the XPM file for the month pages.

-clockxpm <xpm>
    specifies the XPM file for the clock and calendar display.

-weekdayxpm <xpm>
    specifies the XPM file for the weekday pages.

-year
    shows the current the year in the display instead of the current time.

-position [+|-]x[+|-]y
    specifies the starting position of asclock. The [+|-] works like the standard X-Windows x/y geometry option.

-exe <program>
    specifies the application to start when the pointer is activated over asclock. To invoke applications with parameters, you have to set quotes around the command. See example below...

-noblink
    specifies if asclock should blink.

-iconic
    This gives weird output with AfterStep, so don't bother. It's for mwm and other wm's with no hint functionality.

-dock
    starts asclock in docking mode. This option is necessary to dock asclock in the Window Maker dock. asclock ignores the -iconic option when started in docking mode.

INVOCATION
asclock can be called from one of many ways. The most common invocation is the command line:
	[user@host] ~% asclock -12 -exe 'xlock -mode hop' &
Another way to call asclock is from the window manager:
	*Wharf - - MaxSwallow "asclock"	asclock -shape -12&
This line, when placed in the .steprc file in the users home directory will cause asclock to use the shape extensions so that it will be a button on the Wharf (1) button bar under the afterstep (1) window manager. If you run Window Maker then you should use the "-dock" option:
	[user@host] ~% asclock -shape -12 -dock &
and then drag the icon to the dock.

BUGS
we don't have bugs :)

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.

AUTHORS
Beat Christen <bchriste@iiic.ethz.ch> -- application

Dan Weeks <dan@mango.sfasu.edu> -- man page