The Datafile PD-CD 5/DATAFILE_PDCD5.iso/utilities/i/iconclock/!IconClock/!Help

Text File | 1992-05-07 | 4KB | 70 lines

| > !Help for !IconClock

   This program displays a clock on the iconbar. The clock may be either a
twelve or twenty four hour clock. The clock also has three types of clockface
available. These are raised, lowered and border. The time format and
clockface type can be selected from the iconbar menu and its submenus.

   To configure the program to your own favourite clock type you can use the
system variable IconClock$Options. There are six (twelve) possible values of
the variable. They are :-

        24R or 24r      24 hour clock, raised clockface (the default)
        24L or 24l      24 hour clock, lowered clockface
        24B or 24b      24 hour clock, border clockface
        12R or 12r      12 hour clock, raised clockface
        12L or 12l      12 hour clock, lowered clockface
        12B or 12b      12 hour clock, border clockface

   When the iconclock is run the variable IconClock$Options is looked for. If
it is isn't defined then the variable is defined to the default, of 24R. If
it is defined it is checked for validity. If it is invalid an error window is
displayed saying the the variable is invalid and has been replaced by the
default. If it is valid then the desired clockface and time format are used.

   The iconclock is really a module which, once loaded, will start the clock
each time the desktop is entered. The reason it is in an application
directory is one so that you will hopefully read this file and two so that
the icons required can be loaded into the wimp pool.

   If you have a harddisc there are two ways to run this application, either
by making to application be run every time the desktop is started (see below
for ways to do this if don't know how to), or by loading the sprites (see
below for comment on this) and the module before the desktop is started.

   To start the application every time the desktop is started you can use
                *Desktop <full path>.!IconClock
             eg *Desktop adfs::Disc4.$.Desk_Utils.!IconClock

   Or if you want to run more than one task upon startup you can use
                *Desktop -File <full path of file>
where this file contains a sequence of commands to be run upon startup. So to
run the iconclock you should include the line
                *Run <full path>.!IconClock
somewhere in the file.

   If the module is loaded seperately (which is the preferable way to run
this application) the sprite you plan to use for the clockface must be
loaded. Note you only have to load the sprite for the clockface you want to
use. So once you have decided which clockface you like best copy the sprite
out of the !Sprites file in this application into a seperate file and
*IconSprites this file in your !Boot file. Or I recomend you put it in the
!Sprites of your !System directory and *Run this application in your !Boot
file. I know this all sounds horribly technical but it is not an easy thing
to explain (believe me). If you have only loaded some of the sprites then
some of the menu entries on the clockface menu will be greyed (unselectable).
   If the sprite for the clockface selected by the IconClock$Options variable
is not in the wimp pool upon startup then an error message will be generated
and the application will not startup.

   Although I have tested this program fairly thoroughly I offer no guarentee
what so ever and accept no responsibility for any damage caused by its use or
misuse.
   This program is in the public domain and may be freely copied as long as
no charges are made for it all the files are left unchanged. You may use the
source of parts of it in your own programs as long I am credited.

        Yours,
                Pop Mobility Freak
                (Ian Ashley)