LSClock 2.2

        Copyright © 1999-2001 Tomasz Niedzielski (Ludvick/Crazy Bytes)




  INTRODUCTION 

 LSClock 2.2 is a clock utility with few features:

  · time/date displaying (in few different formats);
  · alarm (you can turn it on/off);
  · movable time/date displayer (using drag.gadget);
  · hour beeper;
  · all changes may be saved in prefs file.

 LSClock 2.2 is a replacement for LSClock 1.0/1.1/1.2/2.0/2.1.

 Program is written in assembly language (Asm-Pro v1.16i by Solo/Genetic).

 New feature has been implemented to LSClock: Hour-Beeper. Now program may beep
 each full hour - except when Alarm is turn on and alarm time is set to an full
 hour (alarm sound is heard instead).
 SHAREWARE window - below of Workbench - is removed in registered version.
 Finally, as you can see, Polish documentation is added.

                                     * * *

 Hourglass picture and cuckoo sample - used in LSClock - are taken from Aminet.

                      Special thanks for their authors! 


  REQUIREMENTS 

 LSClock 2.2 needs some additionals. It means:

  · an AMIGA with OS 2.0 (v37) or higher
    (few problems may appear on A500/A600 - if so, let me know);
  · lsclock.library (v2.2);
  · lsclock.font (and a drawer with fontsizes);
  · few standard system things:

	· exec.library;
	· dos.library;
	· intuition.library;
	· graphics.library;
	· diskfont.library;
	· utility.library;
	· timer.device;

  · drag.gadget.


  REGISTRATION 

 LSClock 2.2 is a SHAREWARE product. It means, that for legal use this program,
 you should register, paying 5 ZL, 1 USD or 2 DM of registration fee.
 Registered users will get future versions of LSClock FOR FREE and also keyfile
 - if its structure will change.

 How to register? 
 Fill in and send REGISTRATION CARD together with money - you'll get via e-mail
 newest release of LSClock and a keyfile. 


  INSTALATION 

 Instalation on HD is very simply:

  · Copy LSClock and LSClock.info to sys:wbstartup drawer;
  · Install LSClockFonts in Fonts: drawer;
  · Copy lsclock.library to Libs: drawer
    (if you have used LSClock before (v1.0-2.1), YOU HAVE TO CHANGE LIBRARY!);
  · Copy drag.gadget to your sys:classes/gadgets/ directory
    (path must be: 'sys:classes/gadgets/drag.gadget'!);
  · Put LSClock.key in S: drawer (for registered version only!);
  · Reboot your Amiga nad enjoy LSClock.


  DRAGGING 

 LSClock 2.2, as it is said above, uses drag.gadget (© 1996-1997 Jörg Kollmann)
 - its two versions are addded to archive - full archives on Aminet (dev/gui):

  · drag.gadget_v02 - v0.2 beta   (aminet: dev/gui/dragclass.lha);
  · drag.gadget_v40 - v40.21 beta (aminet: dev/gui/draggadget10b2.lha);
 
    Special thanks go to Gracka/Crazy Bytes for drag.gadget implementation! 


  ERRORS 

 Following warnings may be displayed by LSClock 2.2:

 1. LSClock could not open lsclock.library again!

    lsclock.library may be started only once; 

 2. LSClock could not open lsclock.library v2.2!

    this alert may appear in two cases: 

     - if main program is not able to open lsclock.library; 
     - if a library, required by lsclock.library, has not been opened; 

 3. LSClock could not create a message port!

    LSclock may not create its message port; 

 4. LSClock could not open timer.device!

    it is shown, if program cannot open timer.device; 

 5. LSClock could not open lsclock.font 8!
    LSClock could not open lsclock.font 11!
    LSClock could not open lsclock.font 16!

    one of this alerts may be displayed if one of fonts could not be opened; 

 6. LSClock could not open a window!

    if LSClock is not able to open windows; 


  THANKS 

 Big thanks have to go to:

  · Gracka/Crazy Bytes	 for his really big help, ideas and advices,
  · Norbert Hagen	 for date displaying idea - took from his real clock,
  · Edward Barcik	 for bug report (save prefs) and few sugestions,
  · Jan Gizmajer	 for his idea of creating Polish documentation;
  · Jörg Kollmann	 for drag.gadget,
  · Solo/Genetic	 for briliant macro assembler - Asm-Pro,
  · all registered users for their support.


  AUTHOR 

 Ideas, bug reports, regfees, gifts etc., please send to:

		Tomasz Niedzielski
		87-207 Debowa Laka 166
		woj. kujawsko-pomorskie
		POLAND

		phone :	+48 0-56 688.92.29
		e-mail:	ludvick@go2.pl
			ludvick@box43.gnet.pl