home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / develop / theguru / theguru.doc < prev    next >
Text File  |  1995-02-27  |  9KB  |  215 lines
  1.  
  2.  
  3.                            The Guru 2.0 User Manual
  4.  
  5.                                  Aug 19, 1991
  6.  
  7.  
  8.  
  9. Preface
  10. =======
  11.  
  12.      The programs and files in this distribution are freely distributable, but
  13. are also copyright (c) Nico François.  They may be freely distributed as long
  14. as no more than a nominal fee is charged to cover time and copying costs.
  15.      No commercial usage is permitted without written permission from the
  16. author.  Everything in this distribution must be kept together, in original
  17. unmodified form.
  18.      The above is generally known as freeware.
  19.  
  20.      The Guru is distributed with a PRELIMINARY version of reqtools.library.
  21. If it is installed in Libs: it uses this library for its requesters.
  22.      ReqTools is Copyright © 1991 Nico François.  The included version may
  23. only be distributed as part of the The Guru package.
  24.      The complete and final version of the ReqTools package (including
  25. autodocs and includes) will be released at a later date.
  26.  
  27.      If you have suggestions or remarks about this program, or if you find
  28. any bugs, please let me know.
  29.  
  30.      Write to the following address:
  31.  
  32.                                 Nico François
  33.                                 Corbielaan 13
  34.                                 B-3060 Bertem
  35.                                 BELGIUM
  36.  
  37.      The Guru 2.0 requires AmigaOS Release 2 (Kickstart/Workbench 2.0) to run.
  38.  
  39.  
  40. Contents
  41. ========
  42.  
  43. 1. Introduction
  44.  
  45. 2. The Guru
  46.  
  47. 3. GuruSettings
  48.  
  49. 4. GuruEd
  50.  
  51.  
  52. 1. Introduction
  53. ===============
  54.  
  55.      Aha, another useful utility by Nico I hear you cry.  Naaaaah !  I really
  56. felt like programming something completely and utterly useless :^) So I
  57. present : The Guru.  A program to bring the Guru back into Kickstart 2.0, for
  58. those who will miss it :-)
  59.  
  60.      To see what the program does you should stop reading now (well not this
  61. very instant :^) and run the 'TheGuru' program (just double-click its icon).
  62. Nothing will happen.  Don't worry, this is normal, stop reading now and resume
  63. when you know what the program does.
  64.  
  65.      ...
  66.  
  67.      The package consists of three different programs, the guru itself, a
  68. settings program and a phrase editor.  'TheGuru' is the main program and the
  69. two other programs require it to be running to function properly.  Once it is
  70. started The Guru will wait for a set period of time before appearing and
  71. speaking a humorous (?) phrase.  If you're into jokes so corny they become
  72. funny you'll love this program, if not you'll have to find some other way to
  73. have a good laugh with your Amiga (maybe by running A-Max :-).  The settings
  74. program can then be run to e.g. change all the different speech settings and
  75. the time delay.  Finally, the GuruEd program is used to add/remove phrases
  76. from The Guru's phrase lists, so if you don't like what The Guru has to say
  77. you have the possibility to add your own drivel.
  78.  
  79.  
  80. 2. The Guru
  81. ===========
  82.  
  83.      This is the main program, double-click its icon to start it, or enter
  84. 'TheGuru' in the Shell.  If you really like this program you can even put
  85. this command in your startup-sequence (before the EndCLI of course).  The
  86. program can also be dragged into the WbStartup drawer.
  87.  
  88.      To quit The Guru run the program again.  You can also quit it using the
  89. GuruSettings program (using the 'Remove Guru...' button).
  90.  
  91.      When the program is started it will try to read two files:
  92. 'TheGuru.settings' and 'TheGuru2.phrases'.  It will first try to read these
  93. in the current directory.  If it can't find them the S:  directory will be
  94. searched.  The 'TheGuru2.phrases' file is a must, when 'TheGuru.settings'
  95. isn't found the default settings are used (normal speech settings and
  96. a 120 seconds delay).
  97.  
  98. NOTE: - The Guru requires the translator.library and the narrator.device. It
  99.         works fine if you boot from a standard WorkBench 1.2 (or higher) disk.
  100.  
  101.  
  102. 3. GuruSettings
  103. ===============
  104.  
  105.      The GuruSettings program is mainly used to change to speech settings of
  106. The Guru.  You can change the volume (0 - 64), the rate (40 - 400 words/min.),
  107. the pitch (65 - 320), the sex (male or female) and the mode (human speech or
  108. robotic speech).  You can also change the time delay between two apparitions
  109. of The Guru (1 - 799 sec.) and you can quit The Guru.
  110.  
  111.      I suppose most gadgets explain themselves.  Use the 'Restore' button to
  112. load the settings from disk and the 'Save...' button to save them to disk so
  113. The Guru will use them the next time you run it.  The 'Guru Paused' checkbox
  114. is used to switch The Guru temporarily off and to turn him back on.  You will
  115. get to hear what The Guru thinks about this :^D
  116.  
  117.  
  118. 4. GuruEd
  119. =========
  120.  
  121.      This is the phrase editor.  With this program you can display all phrases
  122. in the three available lists, speak them, change them, delete them and add new
  123. ones.
  124.      The three possible lists are : 'Timer' the phrases The Guru uses when he
  125. appears, 'Turn On' the praise you get to hear when you turn The Guru back on
  126. and 'Turn Off' the abuse you get to swallow when you turn him off.
  127.  
  128.      Again, most gadgets explain themselves.  The 'Clear' button clears the
  129. string gadgets and moves you to the end of the list, the 'Change...' button
  130. makes the changes you made in the string gadget permanent (if you don't use
  131. this the changes will be lost when you move to another phrase).  The 'Speak'
  132. button will only work when The Guru is not already busy speaking.
  133.  
  134.      The 'Add' button will probably not be used very often, because there is a
  135. very quick and easy way to enter new phrases without using the mouse.  First
  136. use the 'Clear' button to clear the string gadget and to move to the end of
  137. the list.  The string gadget will be automatically activated, so enter your
  138. phrase.  When you then press Enter The Guru will speak the phrase and a
  139. requester will appear asking you if you want to add this phrase, you can
  140. answer this requester by using Left Amiga V (yes) or Left Amiga B (no), or
  141. if you have reqtools.library installed by simply typing a Y or a N.  So if
  142. you are not pleased with the phrase yet and you want to edit it some more
  143. press Left Amiga B (or N).  If you want to add it to the current list press
  144. Left Amiga V (or Y), the phrase will be added and you will get an empty string
  145. gadget to enter another phrase.
  146.  
  147.      The Guru will always speak the phrase when you press Enter in the string
  148. gadget (if it is not busy speaking).  This is very useful when you are editing
  149. phrases, once you are pleased with it you can use the 'Change...' button to
  150. make the changes permanent.
  151.  
  152. NOTE: - Watch out with the 'Add' button so you don't add a phrase in the list
  153.         when it is already there, you must use the 'Change...' button after
  154.         editing a phrase.
  155.       - Don't think too quickly I can't write English when you read the
  156.         phrases in the supplied lists :^)  It is sometimes necessary to play
  157.         around with the spelling of a word because the 'trenslaiter' is not
  158.         perfect.
  159.       - Version 2.0 of The Guru now even allows you to edit the phonemes, but
  160.         be careful.  Pressing enter when you are editing the normal english
  161.         phrase will change the phonemes phrase without warning, even if you
  162.         have made changes to it before!
  163.         Use the 'Display' cycle gadget to switch between English/Phonemes.
  164.  
  165.  
  166.                                  I hope you enjoy this program !
  167.  
  168.  
  169.                               PROGRAM HISTORY:
  170.  
  171. *****************************************************************************
  172. VERSION 1.0
  173.  
  174.      First release.
  175.  
  176. *****************************************************************************
  177. VERSION 1.1
  178.  
  179.      Optimized release!  All three programs rewritten in C (version 1.0
  180.        programs were written in Modula-2).  As a result the programs are
  181.        smaller than half their previous size!  Need I say that I will never
  182.        program in Modula-2 again :^D  Nothing beats C :-)
  183.      Programs detach from the CLI.  No need to 'Run' them anymore.
  184.  
  185. *****************************************************************************
  186. VERSION 2.0
  187.  
  188.      Rewritten for Kickstart 2.0.  Much nicer 3D-look interface.
  189.      The file holding the phrases is now an ASCII file, so it can be
  190.        edited with any editor.  This is very useful if you want to
  191.        merge phrase lists together.  There is only on big thing you musn't
  192.        forget: you have to change the number of phrases in the file by hand.
  193.      It is now possible to edit the phonemes of a translated phrase.
  194.      The Guru uses reqtools.library (if it is available) for its requesters.
  195.      Fixed small bug, version 1.1 didn't speak from both left and right
  196.        speakers.  Fixed, speech comes from both speakers just as it should.
  197.      All three programs now contain embedded version strings for use with
  198.        Workbench 2.0 'Version' command.
  199.      Windows will always open in visible portion of the screen.
  200.      The Guru 2.0 will follow you everywhere :^)  Its tiny window will open
  201.        on the frontmost public screen instead of always on the Workbench.
  202.  
  203. *****************************************************************************
  204.  
  205. The Guru 2.0 written by Nico François (Yes, Nico is my first name :-),
  206.              thanks to 'Talking Moose' on the Mac for the inspiration,
  207.                        Martin Brown for his collection of phrases,
  208.              extra special thanks to Peter Verhoye for drawing the guru.
  209.  
  210. (c) 1991 Nico François
  211.  
  212.                                    //
  213.                        Thanks to \X/ Amiga for being the best computer ever !
  214.  
  215.