Program: TBClock

Version: 2.1 (23.12.95)

Author:  Simon Clayton
         12 Valley Way
         Exmouth
         Devon
         EX8 4PD
         ENGLAND

         EMail: sdc395@ecs.soton.ac.uk

Short:   TBClock is a commodities based screen title bar clock

Req.:    TBClock works on any Amiga with OS 2.04 or above and locale.library

It can be run from a CLI or Workbench and takes it settings from the command
line or .info file respectively.

The arguments/tooltypes are as follows:

CX_POPUP    - show user interface on startup.  Default NO

CX_POPKEY   - specify hotkey using commodities conventions.  Default "control
              alt t"

CX_PRIORITY - commodities priority.  Default 0

FORMAT      - a string describing what is to appear on the title bar.  May
              contain any of the following:

                   %a - abbreviated weekday name
	                %A - weekday name
	                %b - abbreviated month name
	                %B - month name
	                %c - same as "%a %b %d %H:%M:%S %Y"
	                %C - same as "%a %b %e %T %Z %Y"
	                %d - day number with leading 0s
	                %D - same as "%m/%d/%y"
	                %e - day number with leading spaces
	                %h - abbreviated month name
	                %H - hour using 24-hour style with leading 0s
	                %I - hour using 12-hour style with leading 0s
	                %j - julian date
	                %m - month number with leading 0s
	                %M - the number of minutes with leading 0s
	                %n - insert a linefeed
	                %p - AM or PM strings
	                %q - hour using 24-hour style
	                %Q - hour using 12-hour style
	                %r - same as "%I:%M:%S %p"
	                %R - same as "%H:%M"
	                %S - number of seconds with leadings 0s
	                %t - insert a tab character
	                %T - same as "%H:%M:%S"
	                %U - week number, taking Sunday as first day of week
	                %w - weekday number
	                %W - week number, taking Monday as first day of week
	                %x - same as "%m/%d/%y"
	                %X - same as "%H:%M:%S"
	                %y - year using two digits with leading 0s
	                %Y - year using four digits with leading 0s

              so "%e-%b-%Y %q:%M" would produce something like
              "21-Dec-1995 21:59"

UPDATE      - updating delay in tenths of seconds.  Range: 1 to 600.
              Default 10

JUMP        - jump to foremost screen?  Default NO

NOCHECK     - don't check for rendering space.  Default NO

There is currently no facility to save the settings from the program, so
you'll have to use a tooltypes editor like Workbench's Information prog.

Any suggestions for improving this program are welcome (read wanted).

I realise that this isn't a very in-depth doc but I hate writing them and
this is a VERY simple program :)

One more thing...

THE SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
YOU ARE ADVISED TO TEST THE SOFTWARE THOROUGHLY BEFORE RELYING ON IT.  YOU
AGREE TO ACCEPT THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
SOFTWARE AND DOCUMENTATION.  IN NO EVENT WILL SIMON CLAYTON BE LIABLE FOR
DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY
DEFECT IN THE PROGRAM.

Hope you like it,

Simon