home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / cdity / speaktimecx / readme < prev    next >
Encoding:
Text File  |  1994-04-19  |  4.0 KB  |  108 lines
  1. Speaktime 1.2 - Commodity version.
  2. by Gary Walker, 323a Annesbrook Dr., Nelson, New Zealand.
  3. You can contact me on Bitstream BBS as Gary Walker,
  4. on BIX as REL, or email me rel@bix.com
  5.  
  6. Compiled with SAS/C Version 6.51.
  7.  
  8. History:
  9. V1.0: First release, non-commodity version.
  10.  
  11. V1.1: First Commodity version, slightly improved pronunciation of
  12. some syllables.
  13.  
  14. V1.2: This release; eliminated some unused commodity code to slightly
  15. reduce the size of the executable. Added docs on Hotkey ToolType.
  16.  
  17. About this program:
  18.  
  19. This program came about because I hate depth-arranging screens just to find
  20. out what the time is.
  21. The first version of the program I developed just spoke the time when called
  22. by the icon (or when typed from the CLI), and exited. This is fine so long
  23. as you can get to a CLI or the WorkBench screen.
  24. I also wrote the program to learn more about commodities programs, and to
  25. further my knowledge of the C language.
  26.  
  27. System requirements:
  28.  
  29. This program requires AmigaDos 2.04 or later, plus the narrator.device
  30. in DEVS: and the traslator.library in LIBS:
  31. This particularly applies to AmigaDos 3.x users, as they do not have
  32. these files. Please try and use the WB2.04 (V37.1) versions if possible, 
  33. as they are the ones used to develop the program. They are available on
  34. the WorkBench 2.04 distribution disks.
  35.  
  36. How to install it:
  37.  
  38. Just drag the icon into your WBStartup drawer, and the program will be
  39. active from the next reboot.
  40.  
  41. How to use it:
  42.  
  43. Once the commodity is active (there are no telltale signs except a small
  44. dip in available memory), just press alt-z and it will speak the current
  45. setting of your system clock. Either alt key will work.
  46. If you haven't set your clock correctly, don't blame me if it tells you
  47. the wrong time :)
  48. Because it is a commodity, alt-z at any screen will initiate the speech.
  49. You can force use of one or the other alt-keys instead of both by
  50. specifiying the tooltype like this:
  51. QUALIFIER=LEFT_ALT
  52. That example will force the program to recognise only Left-Alt-z.
  53. You can do the same for Right-alt by altering the Qualifier Tooltype.
  54. The default is use of either alt-key.
  55. You can also add the Tooltype:
  56. HOTKEY=whatever else
  57. where whatever else could be ctrl alt b for example.
  58. This will force Speaktime_Cx to use your combination of hotkeys to
  59. activate.
  60.  
  61. How to remove it from memory:
  62.  
  63. To remove the commodity from memory, just double-click its icon or run
  64. it again from the CLI.
  65. Once again, there will be no visible sign that it has gone, except that
  66. your free memory will increase again. It will not free ALL memory, as
  67. the libraries will stay resident, unless you do an 'avail flush' from
  68. the CLI.
  69.  
  70. What to do if it doesn't work or crashes your machine:
  71.  
  72. Do you have the volume up loud enough to hear it?
  73. Check that you have the correct versions of narrator.device and
  74. translator.library installed. These MUST be AmigaDos 2.04 or
  75. later.
  76. Remember that this program swallows the hotkey combo and doesn't give 
  77. it back, so any other program that needs alt-z will never get it. 
  78. If you need alt-z for another program, use another hotkey.
  79. Don't flame me! I ran this program billions and billions and billions
  80. of times on my two machines, and it works fine for me.
  81.  
  82. If all else fails, send me a message on Bitstream and I'll see if I can
  83. help you out. If you do, please let me know your machine type and
  84. memory, your Kickstart/WorkBench versions, plus any other programs
  85. started before SpeakTime.
  86.  
  87. Above all: Don't Panic!
  88.  
  89. Copyright:
  90.  
  91. This program is copyright (c) 1994 Gary Walker.
  92. I place this program, and its sourcecode into the public domain.
  93. Permission is hereby granted to distribute this archive so long as
  94. all files within it remain unaltered, and this readme.cx file
  95. remains with the original program.
  96. You may do what you wish with this program, except claim that it
  97. is your own or charge money for it. An exception is made for
  98. Fred Fish to include it in his archives, and to charge his
  99. normal fees for distribution.
  100.  
  101.  
  102. Suggestions:
  103.  
  104. If you have any suggestions (or food or money or cars or private-
  105. jets) please send them to me. I'll make very good use of them :)
  106.  
  107. Have fun.
  108.