home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / fish / enhancements / general / theguru / theguru.doc < prev    next >
Text File  |  1990-10-11  |  7KB  |  156 lines
  1.  
  2.  
  3.                            The Guru 1.0 User Manual
  4.  
  5.                                  May 6, 1990
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      This program is freeware, this means that you can copy it freely as long
  13. as you don't ask any more money for it than a nominal fee for copying.  If
  14. you want to distribute this program you should keep this document with it.
  15.      If you have suggestions or remarks about this program, or if you find
  16. any bugs, please let me know.
  17.  
  18.      Write to the following address:
  19.  
  20.                                 Nico François
  21.                                 Corbielaan 13
  22.                              3060 Bertem BELGIUM
  23.  
  24.  
  25. Contents
  26. ========
  27.  
  28. 1. Introduction
  29.  
  30. 2. The Guru
  31.  
  32. 3. GuruSettings
  33.  
  34. 4. GuruEd
  35.  
  36.  
  37. 1. Introduction
  38. ===============
  39.  
  40.      Aha, another useful utility by Nico I hear you cry.  Naaaaah !  I really
  41. felt like programming something completely and utterly useless :^) So I
  42. present : The Guru.  A program to bring the Guru back into Kickstart 2.0, for
  43. those who will miss it :-)
  44.      To see what the program does you should stop reading now (well not this
  45. very instant :^) and run the 'TheGuru' program (just double-click its icon).
  46. Nothing will happen.  Don't worry, this is normal, stop reading now and resume
  47. when you know what the program does.
  48.  
  49.      ...
  50.  
  51.      The package consists of three different programs, the guru itself, a
  52. settings program and a phrase editor.  The guru program is the main program
  53. and the two other programs require it to run to function properly.  Once it is
  54. started The Guru will wait for a set period of time before appearing and
  55. speaking a humorous (?) phrase.  If you're into jokes so corny they become
  56. funny you'll love this program, if not you'll have to find some other way to
  57. have a good laugh with your Amiga (maybe by running A-Max :-D ).  The settings
  58. program can then be run to e.g. change all the different speech settings and
  59. the time delay.  Finally, the GuruEd program is used to add/remove phrases
  60. from The Guru's phraselists, so if you don't like what The Guru has to say you
  61. have the possibility to add your own drivel.
  62.  
  63.  
  64. 2. The Guru
  65. ===========
  66.  
  67.      This is the main program, double-click its icon to start it, or enter
  68. 'Run TheGuru' in the Shell.  If you really like this program you can even put
  69. this command in your startup-sequence (before the EndCLI of course).
  70.      To quit The Guru run the program again or send it a break.  Sending a
  71. break can be done by pressing CTRL-C if you forgot to run The Guru (so you
  72. couldn't enter any more commands) or by entering 'Break n' in the Shell, where
  73. n is the CLI process number of The Guru (use Status to find this out).  You
  74. can also use the GuruSettings program to quit The Guru, but more about this
  75. later.
  76.      When the program is started it will try to read two files :
  77. 'TheGuru.settings' and 'TheGuru.phrases'.  It will first try to read these in
  78. the current directory, if it can't find them then the S:  directory will be
  79. searched.  The 'TheGuru.phrases' file is a must, when 'TheGuru.settings' isn't
  80. found the default settings are used (normal speech settings and a 120s delay).
  81.  
  82. NOTE: - The Guru requires the translator.library and the narrator.device. It
  83.         works fine if you boot from a standard WorkBench 1.2 (or higher) disk.
  84.  
  85.  
  86. 3. GuruSettings
  87. ===============
  88.  
  89.      The GuruSettings program is mainly used to change to speech settings of
  90. The Guru.  You can change the volume (0 - 64), the rate (40 - 400 words/min.),
  91. the pitch (65 - 320), the sex (male or female) and the mode (human speech or
  92. robotic speech).  You can also change the time delay between two apparitions
  93. of The Guru (1 - 799 sec.) and you can quit The Guru.
  94.      I suppose most gadgets explain themselves.  Use the 'Load' gadget to load
  95. the settings from disk and the 'Save' gadget to save them to disk so The Guru
  96. will use these settings the next time you run it.  The 'Turn Off'/'Turn On'
  97. gadget is used to switch The Guru temporarily off and to turn him back on, you
  98. will get to hear what The Guru thinks about this :^D
  99.  
  100.  
  101. 4. GuruEd
  102. =========
  103.  
  104.      This is the phrase editor.  With this program you can display all phrases
  105. in the three available lists, speak them, change them, delete them and add new
  106. ones.
  107.      The three possible lists are : 'Timer' the phrases The Guru uses when he
  108. appears, 'Turn On' the praise you get to hear when you turn The Guru back on
  109. and 'Turn Off' the abuse you get to swallow when you turn him off.
  110.      Again, most gadgets explain themselves.  The 'Clear' gadget clears the
  111. string gadgets and moves you to the end of the list, the 'Change' gadget makes
  112. the changes you made in the string gadget permanent (if you don't use this the
  113. changes will be lost when you move to another phrase).  The speak gadget will
  114. only work when The Guru is not already busy speaking.
  115.      The 'Add Phrase' gadget will probably not be used very often, because
  116. there is a very quick and easy way to enter new phrases without using the
  117. mouse.  First use the 'Clear' gadget to clear the string gadget and to move to
  118. the end of the list.  The string gadget will be automatically activated, so
  119. enter your phrase.  When you then press ENTER The Guru will speak the phrase
  120. and a requester will appear asking you if you want to add this phrase, you can
  121. answer this requester by typing a 'Y' or a 'N' on the keyboard.  So of you are
  122. not pleased with the phrase yet and you want to edit it some more press 'N',
  123. if you want to add it press 'Y', the phrase will be added and you will get an
  124. empty string gadget to enter another phrase.
  125.      The Guru will always speak the phrase when you press ENTER in the string
  126. gadget (if it is not busy speaking).  This is very useful when you are editing
  127. phrases, once you are pleased with it you can use the 'Change' gadget to make
  128. the changes permanent.
  129.  
  130. NOTE: - Watch out with the 'Add Phrase' gadget so you don't add a phrase in
  131.         the list when it is already there, you should use the 'Change' gadget
  132.         after editing a phrase.
  133.       - Don't think I can't write English too quickly when you read the
  134.         phrases in the supplied lists :^)  It is sometimes necessary to play
  135.         around with the spelling of a word because the 'trenslaiter' is not
  136.         perfect.
  137.  
  138.  
  139.                                  I hope you enjoy this program !
  140.  
  141.  
  142.                               PROGRAM HISTORY:
  143.  
  144. *****************************************************************************
  145. VERSION 1.0
  146.  
  147.      First release.
  148.  
  149. *****************************************************************************
  150.  
  151. The Guru 1.0 written by Nico François (Yes, Nico is my first name :-),
  152.              thanks to 'Talking Moose' on the Mac for the inspiration,
  153.              extra special thanks to Peter Verhoye for drawing the guru.
  154.  
  155. (c) 1990 Nico François
  156.