home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / util / aboutclock-3.00.lha / AboutClock / AboutClock.doc < prev    next >
Text File  |  1993-12-21  |  12KB  |  290 lines
  1. *****************************************************************
  2.  
  3.                         AboutClock V3.00
  4.  
  5.                    Copyright 1993 Stuart Davis
  6.                        All Rights Reserved
  7.  
  8. *****************************************************************
  9.  
  10. Contents
  11.                            Distribution
  12.                            Description
  13.                            Usage
  14.                            Development
  15.                            Author Details
  16.  
  17. -----------------------------------------------------------------
  18.  
  19. Distribution
  20.  
  21.      AboutClock  V3.00 is Shareware  and  NOT  Public Domain, and
  22. as  such  a  small  registration  fee  of 5  pounds  sterling  is
  23. required  if  you  decide  that  AboutClock V3.00  should  be  in
  24. your software collection. This will entitle  you to  a  disk with
  25. a collection  of otherwise  unobtainable programs  by me  and the
  26. next major upgrade.
  27.  
  28.      Payment should be in the form of a crossed cheque drawn from
  29. a UK mainland bank payable to the author.
  30.  
  31.      The  distribution  of   AboutClock  V3.00  MUST  be  intact,
  32. unaltered, and include the following files :
  33.  
  34.                     AboutClock
  35.                     AboutClock.info
  36.                     AboutClock.doc
  37.  
  38. -----------------------------------------------------------------
  39.  
  40. Description
  41.  
  42.      Do you remember the good old days when you asked someone the
  43. time and they  said, "It's nearly five" and not "It's 4:57 and 28
  44. seconds" ?
  45.  
  46.      Well now there is a Workbench clock that does just that! 
  47.  
  48.      AboutClock  V3.00  is  an  unobtrusive  clock  that  nestles
  49. neatly at the top  of Workbench, telling  the time  in words in a
  50. window  that  re-sizes  itself  to  account  for  the  length  of
  51. message required. It is now  able to tell the time in a number of
  52. different European languages thanks to the efforts of Daniel Amor
  53. who provided the idea and translations.
  54.  
  55.      Also,  for short-sighted Amiga users, there is the option to
  56. have AboutClock V3.00 speak the time!
  57.  
  58.      Not  only  is  AboutClock V3.00  simple  and functional, but
  59. it is compatible with all versions of Workbench!
  60.  
  61. -----------------------------------------------------------------
  62.  
  63. Usage - CLI/startup-sequence
  64.  
  65.      type "run" like this to run the program in the background:
  66.      
  67.      run <nil: >nil: path:AboutClock
  68.      
  69.      To enable  AboutClock  to  read  it's  preferences, the icon
  70.      must be present in the  same  directory as the main program.
  71.  
  72.  
  73. Usage - WorkBench
  74.       
  75.      Double click the icon. That's all there is to it.
  76.      
  77.  
  78.      AboutClock  V3.00  will by default appear  in  the  top left
  79. corner of the Workbench screen.
  80.  
  81.      AboutClock  V3.00  has  three  menus,  Project,  Speech  and
  82. Language.
  83.  
  84.      The Project menu gives  the options of ABOUT and QUIT, which
  85. give details of the author, and quit the  program respectively.
  86.  
  87.      The  Speech  menu  has TIME?... and  SPEECH. Selecting Time?
  88. will  make  AboutClock V3.00 tell you the current time, using the
  89. Amiga's incredible  built in speech  facility, where as selecting
  90. Speech will force  AboutClock V3.00 to tell you the time whenever
  91. it changes. This will be indicated  by a tick next to the option.
  92.  
  93.      In order to use  the speech option,  it is required that the
  94. following files are present on your Amiga setup:
  95.  
  96.     DEVS:narrator.device
  97.          audio.device (WB1.2/1.3 only.)
  98.             
  99.     LIBS:translator.library
  100.          icon.library
  101.       
  102. If the program fails to  find  these  files it won't allow speech
  103. after telling you the problem. WB2.x users will find all but 1 of
  104. these files on their  original  WB  disks. The audio.device is in
  105. the ROM for these machines.
  106.  
  107.    * WB3.0 users note :- Commodore have  deemed in their infinite
  108.                          strangeness  not  to  include  the files
  109.                          narrator.device  and  translator.library
  110.                          on the  WB disks!?  Why?  Well I suppose
  111.                          that they decided  they  have power over
  112.                          the Amiga voice  and  wanted  to silence
  113.                          it. (Ahhh...shame on you CBM!)
  114.                          So I have therefore started the anti-CBM
  115.                          RAVe motion, (Return the Amiga's VoicE).
  116.                          This is to persuade  the big C to return
  117.                          the lost library and device files to the
  118.                          poor deprived WB3  users  who have never
  119.                          heard sexy!?!? Paula speak.
  120.                          If you are a  WB3  owner  then the files
  121.                          will work on  your  machine  and all you
  122.                          have to do is get  them from a friend or
  123.                          a PD library. Then you can hear Paula in
  124.                          her proudest moment!(PC owners suck...!)
  125.  
  126.      The Language menu is  used to  select the  language you want
  127. time to be displayed  in.  It consists  of  a number  of mutually
  128. exclusive menu items  each with  their own  keyboard shortcut. By
  129. selecting one of these languages, AboutClock will change the text
  130. used for the  menus and  the time  text. I  am not  multi-lingual
  131. myself and so  if you  see any  blatant  errors or silly mistakes
  132. then let me know and  I'll fix  them. Also, if  you would like to
  133. see your own  language or  any other  featured then  write  to me
  134. regarding the translation & we'll see about getting it included.
  135.  
  136.                             *****************
  137. I would be particularly interested in hearing from Scottish,Welsh
  138. or Irish speaking people  about doing  the translations for these
  139. languages - please write to me !!!!!!!!!!!!
  140.                             *****************
  141.  
  142. -----------------------------------------------------------------
  143.  
  144. Icon Tool Types
  145.  
  146.      AboutClock now checks it's icon for the following recognised
  147. tool types:
  148.  
  149.         POSX=x        This can be set  to  any number but for the
  150.                       program to open its window, the coords must
  151.                       reside somewhere within the screen.
  152.                       Default=0
  153.  
  154.         POSY=y        Ditto..
  155.  
  156.         SPEECH=ON|OFF An "ON" or "on"  will  turn on regular time
  157.                       updates  whenever  the  time  changes.  Any
  158.                       other string value will be ignored.
  159.  
  160.      
  161. -----------------------------------------------------------------
  162.  
  163. Development
  164.  
  165. V1.00 31-12-92
  166.      My own very  personal  and non-PD  version. Ooo-err missus?!
  167. This is my very  first  attempt at  programming  a utility on the
  168. Amiga and it shows! It works fine on my machine but not on anyone
  169. elses!?
  170.  
  171. V1.12
  172.      Some  errors  related to  telling the  time occur at certain
  173. times  of the day.  When  AboutClock  resizes  itself, all active
  174. processes receiving user input on Workbench are  resized, notably
  175. ED  and  SID V1.06, when used under Workbench 1.3 which can prove
  176. to be annoying, but not dangerous.
  177.      This version NOT released to the public.
  178.  
  179. V1.14
  180.      Tells the correct time without errors.  About and Quit menus
  181. added.  Opens too  large  a  window, and crashes the machine when
  182. About is selected,  under  Workbench 1.3.  No  problems noted for
  183. Workbench 2 and above.
  184.      This version released  prior to testing on Workbench 1.3 and
  185. distributed on Amiga User International's April'93 issue.
  186.  
  187. V1.14b
  188.      Window  size  corrected,   and  selecting  About  no  longer
  189. crashes  the machine,  but  text  is  not  visible   (applies  to
  190. Workbench 1.3 only).
  191.  
  192. V1.15
  193.      About  text  is  now  visible.  Error corrected in  telling,
  194. the time around 9am which was detected in V1.14b.
  195.      This version released on Amiga Computing's April'93 issue in
  196. which they reported that it was written in Pascal! Open your eyes
  197. guys  - since  when  have 'move.w 12(a0,d2.l),d3' or 'bmi.s' been
  198. Pascal commands?
  199.  
  200. V1.16
  201.      About requester may be selected as often as you wish with no
  202. delay in updating it. Another error corrected in telling the time
  203. which was detected around 6pm.
  204.  
  205. V2.00
  206.      AboutClock is alive! Version 2.00 includes speech. Also, the
  207. about  requestor  has  been  improved.  It also  works on WB3 but
  208. requires a copy of a narrator.device to be in the Devs directory,
  209. which is not supp