home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / disks / disk390.lzh / SetClock / SetClock.doc < prev    next >
Text File  |  1990-10-23  |  3KB  |  40 lines
  1.   Initially, I wrote this utility to replace the program supplied by Spirit
  2. Technology to set the hardware clock on the memory expansion board in my
  3. Amiga 1000.  The utility supplied by Spirit to set the hardware clock on
  4. their board required that both the date and time be supplied on the command
  5. line in a very precise format that I could never remember.  A utility to
  6. simply transfer the time from the AmigaDOS system clock to the Spirit
  7. hardware clock would be much easier to use since the CLI "Date" command has
  8. an extremely flexible format.  When I first decided to write such a utility,
  9. I wasn't aware that such a utility was standard equipment on the Amiga 500
  10. and 2000.
  11.   I wrote the first version of this utility shortly after Pat Quaid's
  12. implementation of Pascal became available on Fred Fish disk #183.  I started
  13. to put a disk together to send to Fred, but never did.  Not too long ago, I
  14. acquired an Amiga 2000 and learned how the CLI "SetClock" command works.
  15.   Shortly after acquiring the 2000, I got a newer version of PCQ Pascal
  16. directly from Pat Quaid.  That version is the one that appears on Fred Fish
  17. disk #339.  I decided to get off my duff and submit this collection of files
  18. to Fred for two reasons.  First, there might still be people in the Amiga
  19. community who still own a 1000 and would find this to be a useful utility.
  20. Secondly, I am a great fan of the Pascal language and think that Pascal is
  21. an ideal language for writing this kind of program.
  22.   The utility has only been tested in a CLI environment.  To set the
  23. AmigaDOS system clock from the Spirit hardware clock on their memory
  24. expansion board, enter "SetClock load".  To set the Spirit hardware clock
  25. from the AmigaDOS system clock, first set the date and time to the correct
  26. value by using the CLI "Date" command.  Then, enter "SetClock save".
  27.   This documentation file should be accompanied by the Pascal and assembler
  28. source files.  The Pascal source file is named "SetClock.pas" and should be
  29. in the sub-directory named Examples.  The assembler source file is named
  30. "RWSClock.asm".  The file named "SetClock.mak" is a CLI script file that can
  31. be used to re-compile SetClock, provided you have all the files that were on
  32. Fred Fish disk #339.
  33.   The Include directory contains four Pascal include files.  The one named
  34. "ExecStdIO.i" is one that is NOT on FF disk #339.  The "Ports.i" and
  35. "TimerDevice.i" files contain changes that I had to make to get SetClock to
  36. compile without error.  I've also included a version of "Intuition.i" that
  37. corrects a problem that caused a compilation error on the sample program
  38. named "Moire.p", on FF disk #339.
  39.  
  40.