home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 31 / CDASC_31_1996_juillet_aout.iso / vrac / splms130.zip / READ.ME < prev    next >
Text File  |  1996-03-18  |  17KB  |  439 lines

  1. Hello,                    (read.me  03/18/1996)
  2.  
  3.                 Spell Master 1.3
  4.  
  5. It talks to you (requires Multimedia setup (MMPM2 with sound card & microphone),
  6.           and extra REXX UTILS to be loaded (done automatically now)).
  7.  
  8. /* History:
  9. **   1.0 Very first release
  10. **   1.01  Found out that I needed to ship vputil.dll with Spell 
  11. **          Master.  Included it now.
  12. **          If after a new install it still does not work copy
  13. **          vputil.dll into x:\os2\dll     x: is where os/2 installed.
  14. **   1.02  Found that some functions I was using required the extra
  15. **          REXX Utils be loaded which I always had in my startup.cmd
  16. **          but apparently others do not. My mistake. Sorry.
  17. **          Unless you loaded them yourself the install would just
  18. **          disappear without completing.
  19. **   1.3   ENHANCEMENTS & A FIX
  20. **          fixed bug where program thought you were unregistered after
  21. **          you did 1 spelling practice session.
  22. **          Added settings for 'Repeat Word', 'Auto Hints', & 'Multi-Responses'
  23. **          You can create a list of verygood, tryagain, and incorrect responses
  24. **          which the program will pick from randomly to play.  (As requested
  25. **          by a customer).
  26. **          Also reworked 'hint' function and added an uninstall.
  27. **          Along with a couple of kill process programs (by name & by hex #),
  28. **          I included a spllini.cmd file in case you want to learn about OS/2
  29. **          ini files.
  30. */
  31.  
  32. This is the very first shared version of Spell Master.  The purpose of
  33. this program is to help people learn how to spell properly.  It is also
  34. designed so that the pupil himself can go through the whole process of
  35. inputting the list of words, practicing the words, and optionally
  36. printing out his scores (to show to Mom and Dad).  Hopefully you will
  37. be able to send the child off to do his spelling and he can bring back
  38. proof of how he did!
  39.  
  40. This program was originally written for my third grade daughter, who
  41. unfortunately can't spell for beenz.  I don't know for sure if this did
  42. it, but when they started her out in school they tried something new
  43. (invented spelling) where they let the kids spell however it makes
  44. sense to them, and you got woordz lik choclet, vary gud, hows, and kar.
  45. Unfortunately, she still spells that way now!  One of our other
  46. daughters, on the other hand, never studies spelling at home and gets
  47. 100% almost all the time!
  48.  
  49. Anyways, that's what made me write this for daughter number 1, and when
  50. I first had her use it 2 or 3 times per week her grades went from E to
  51. A or B!  I was amazed.
  52.  
  53. So I have turned it into a GUI program and here it is.  It is
  54. shareware, NOT FREE, but hopefully has a reasonable price.  It has
  55. built in limits when not registered.  If you like it and send me
  56. payment for it I will send you back a registration number keyed to your
  57. registration info.  that will unlock the full capabilities.  To
  58. register see below.
  59.  
  60. Whatever major version you register at, say you buy it at 1.2, you will
  61. be allowed free upgrades to all 1.x versions.  This will be done by you
  62. by downloading the newer version if you choose and copying the newer
  63. version into your existing directory.  Your registration key is saved
  64. in a file call spllmstr.ini in your program directory.  Do not erase
  65. this file and it will automatically work with all 1.x versions.  It
  66. will not work with 2.x, 3.x etc....  These higher versions would have
  67. to be bought at an upgrade price.  My plan for any possible upgrades
  68. will be that you would pay for the new programming and not for a whole
  69. new program.
  70.  
  71. At this time since the program is new there could be more frequent
  72. upgrades (including fixes) but they would all be for a 1.x version and
  73. would therefore be free.
  74.  
  75. INSTALLATION (after you unzipped the file):
  76. ===========================================
  77.  
  78. 1.) run setup.exe     (can also be used to change the location of program & .spl files)
  79.  
  80. 2.) run spell master  (spllmstr.exe or by the icon)
  81.  
  82. 3.) Close the registration window for now.
  83.  
  84. 4.) go into 'Add/Modify a Spelling List'   (click it and hit O.K.)
  85.  
  86. 5.) Click on 'File List...'
  87.  
  88. 6.) You need to ReRecord the command phrase for each of the following 4 lists.
  89.      INCORRECT, REDO, TRYAGAIN, & VERYGOOD  .SPL.  I did this so as
  90.      to not unnecessarily increase the size of the downloaded file.  This
  91.      also lets you customize the program in your own voice (dialect, language).
  92.  
  93.      Select the list INCORRECT.SPL
  94.  
  95. 7.) Select the word INCORRECT and hit ReRecord.
  96.  
  97. 8.) Add any other words you want the program to randomly chose for this phrase.
  98.  
  99. 9.) Make sure the 'List Type:' pull down box contains the appropriate type.
  100.      Select 'Incorrect List' this time.  This ties this list of words to particular command
  101.      phrases or to a 'Spelling List'.
  102.  
  103. 10.) Click on 'Save List' to save it.
  104.  
  105. 11.) Goto steps 5-9 for the other 3 lists; REDO, TRYAGAIN, & VERYGOOD  .SPL.
  106.  
  107.      For each word use the following phrases (or something similar):
  108.  
  109.     For Word:        Record:
  110.     =========       ==========================
  111.     VERY_GOOD       "Very good."
  112.  
  113.     TRY_AGAIN       "Incorrect, Try again."
  114.  
  115.     INCORRECT       "Incorrect, Next word."
  116.  
  117.     REDO_LIST       "Would you like to redo the ones you got wrong?"
  118.  
  119.  
  120.     (You can select a word and click on "Play" to test your recording,
  121.      and rerecord again as necessary.)
  122.  
  123. 12.)  The program is now ready to use.   You can now enter your own
  124.       spelling list(s), and then hit 'Exit' and go to practice your list(s).
  125.  
  126.  
  127. DIAGNOSTIC HELP:
  128. ================
  129.  
  130. The install is pretty simple.  It just copies the spllmstr.exe, maincmds.spl,
  131. and read.me to your chosen directory and the vputil.dll to \os2\dll for
  132. os/2 2.1 or less or to the program directory for os/2 3.0 or more.  It
  133. then writes a couple system ini entries to keep track of where you
  134. installed it.
  135.  
  136. All it takes to run is spllmstr.exe and vputil.dll.
  137.  
  138. THINGS TO CHECK:
  139.  
  140. Note these are done in my program in case you want to know:
  141. call RxFuncAdd 'SysLoadFuncs', 'RexxUtil', 'SysLoadFuncs'
  142. call SysLoadFuncs
  143.  
  144. Do you have MMPM/2 functional?
  145. For MMPM/2 can you go into your multimedia folder and start the digital
  146. audio device and play *.wav files and record them?
  147.  
  148. The install should also say if it installed successfully.  Did it say so?  
  149. Once the icon is installed on the desktop you will have to delete it for
  150. it to say 'successful install' if you run install again.
  151.  
  152. It should also create a desktop icon (a bee).  Did it?  I can run it by
  153. typing spllmstr.exe but did you try double-clicking on the icon?
  154.  
  155. Did the program spllmstr.exe ever bring up the first window?
  156.  
  157. When you run the program it will create a spllmstr.ini in your
  158. program directory (probably of size 0 unless registered).  Did it?
  159.  
  160. If you get an error like:
  161. mciRxGetErrorString(70555) = File not found
  162. It just means the .wav file does not exist.  You need to record it.
  163.  
  164. If you get any error messages please write down the exact message and
  165. any error number for me to look into.
  166.  
  167. What version of OS/2 are you running?
  168.  
  169. Do you have real OS/2 drivers for your sound card?  (The last I saw of
  170. Ensoniq (standard Gateway sound card) OS/2 drivers they were lousy and
  171. not worth using).
  172. Which sound card are you using?
  173.  
  174. I tried once and found that if you try, in the record window, to play
  175. one of the maincmds.spl words before you record it, it messes up the
  176. program and you need to quit out and come back in before rerecording
  177. them or it won't rerecord.
  178.  
  179. GETTING AROUND THE SCREENS:
  180. ===========================
  181.  
  182. TAB KEY
  183. -------
  184.  
  185. The tab key is how you move from field to field with the keyboard.  
  186. Otherwise you use the mouse to point directly at what you want.  I 
  187. taylored the TAB key order to make it as easy as possible to get around
  188. with the fewest amount of keystrokes.
  189.  
  190. For example:  After you type in your word for a test and want to check
  191.                     it hit 'TAB' which moves you to the 'Check Word' key and
  192.                     then hit 'Enter'.
  193.  
  194.                     Also after you enter the list you want to use you can hit
  195.                     'TAB' which moves you to the 'Load' button and then hit
  196.                     'Enter' to load it.
  197.  
  198.  
  199. PRACTICE A SPELLING LIST:
  200. =========================
  201.  
  202. 1.) In the 'List' field enter file name of spelling word list and then click
  203.      'Load', or hit 'File List...' to use the dialog box to load a spelling list.
  204.     (A Start window appears)
  205.  
  206. 2.) Choose to scramble the word list or not.
  207.  
  208. 3.) Click the 'Take' picture or close the window to start the practice
  209.      session.
  210.  
  211. 4.) After the computer says a word on your list you type in how you 
  212.      think the word is spelled in the 'Answer >' box.
  213.  
  214. 5.) Hit 'tab' and 'enter', or click 'Check Word'.  The computer checks 
  215.     your spelling.
  216.  
  217. 6.) The computer goes thru the whole list of words, keeping track of 
  218.      your score and of the words you got wrong the first time.
  219.  
  220. 7.) At the end of the list it will ask you if you want to retry any words 
  221.      you got wrong. Select Yes or No.
  222.  
  223. 8.) When you have gone thru all the words it will highlight the 'List' box
  224.      and put 'Enter List filename'.  You are done with that list and can do
  225.      another list.
  226.  
  227. Other Options:
  228. --------------
  229.  
  230. Print Menu:
  231.      When you first start a practice session the computer automatically
  232.      checks the option under the 'Print' menu labeled 'Start Capturing Scores'
  233.      and brings up the associated dialog box.  (see below).
  234.  
  235.      'Print This Score':  This will print the scores immediately shown on
  236.           your screen to lpt1:
  237.  
  238.      'Start Capturing Scores':   Checking this will bring up a dialog box
  239.           asking you what file you want to capture completed practice
  240.           run scores into.  It will then capture any subsequently completed
  241.           scores into this file for later print out if desired.
  242.  
  243.      'Stop Capturing Scores':  This will stop subsequent capturing of
  244.           completed scores into your file.  It will leave the file out there
  245.           and not erase it.
  246.  
  247.      'Print Captured Scores':  This will print out the captured file to lpt1:
  248.  
  249. Settings Menu:
  250.  
  251.      'Repeat Word':  This will say the word to spell twice.
  252.  
  253.      'Auto Hint':  For an incorrect spelling this will automatically give you
  254.          the spelling for the part of the word you got correct plus the next
  255.          letter.
  256.  
  257.      'Multi-Responses':  This lets you toggle on or off whether you want
  258.          random responses to be chosen from the particular command list
  259.          or to just use the default (first) phrase in the command list.
  260.  
  261. Buttons:
  262.  
  263.      'Repeat Word':  This will replay the word.
  264.  
  265.      'Hint':  This will give you the spelling for the part of the word you got
  266.          correct plus the next letter.  It also counts against your grade!
  267.          Hit this instead of 'Check Word' to check you spelling.
  268.  
  269.  
  270. ADD/MODIFY A SPELLING LIST:
  271. ===========================
  272.  
  273. To Add a New List:
  274. ------------------
  275.  
  276. 1.) In the 'List' box enter the name of the new spelling list you want
  277.      to create (for example, 'test' ).
  278.  
  279. 2.) Go to the 'New Word' box and type in the next word you want to
  280.      add to your list.
  281.  
  282. 3.) Tab to 'New File Name'.  It should automatically fill in a file name
  283.      based on the new word you are adding.  The only reason this field
  284.      is in here is if you are using an FAT file system instead of HPFS so 
  285.      you can shorten words longer than eight (8) characters down to 8 
  286.      characters or less.
  287.  
  288. 4.) Tab to record and hit 'enter' (or click it).
  289.  
  290. 5.) When the window pops up, record your word, and hit OK when done.
  291.  
  292. 6.) Repeat steps 2 thru 5 for all words you want to add to your list.
  293.  
  294. 7.) Select the appropriate 'List Type:' from the pull down box.
  295.      This ties this list of words to particular command phrases or to a
  296.      'Spelling List'.
  297.  
  298. 8.) After entering all new words you want click 'Save List' to save it.
  299.  
  300.  
  301. To Modify a List:
  302. -----------------
  303.  
  304. 1.) In the 'List' box enter the name of the spelling list you want
  305.      to modify (for example, 'test' ).
  306.  
  307. 2.) Click on 'Load'.
  308.  
  309. 3.) Use the steps above to add new words and the available options
  310.      listed below to modify your list.
  311.  
  312. Other Options:
  313. --------------
  314.  
  315. 'ReRecord Word':  This will let you rerecord the selected word that is
  316.           is already in your list.
  317.  
  318. 'Play Word':  This will play the selected word to test how it sounds.
  319.  
  320. 'Delete Word':  This deletes the selected word(s) from your list.
  321.  
  322. 'Save List':  This saves your list of words into the chosen *.spl file for
  323.           later recall in the practice session.
  324.  
  325. 'Delete List':  This will delete the opened list *.spl file and all the 
  326.           associated *.wav files for the words in the list.
  327.  
  328. 'Exit':  Quits out of this window.
  329.  
  330. **********************************************************
  331.  
  332. License:
  333.  
  334. You are granted a license to use the software as is for up to 30 days
  335. after which you must either pay to register it or discontinue using it.
  336. If you do not register it you have no further rights to use the program.
  337. If you do register it you are paying for the right 'to use' that major
  338. version of the program for which you paid.  You have no other rights
  339. to the program.  You cannot disassemble the code or modify the code
  340. in any way.  You can freely distribute the original file to others as
  341. shareware. All rights are reserved by me.
  342.  
  343. Warranty and Guarantee:
  344.  
  345. None.  If you are the kind that likes to sue people instead of earning
  346. a living and doesn't mind further turning this country into a crap shoot
  347. of who can sue who first, don't use this program.  I certainly can't
  348. guarantee it will make your child an Ace speller.  You judge its usefullness.
  349.  
  350. Support to Registered Users:
  351.  
  352. If you find a major bug that damages the usability of this program for its
  353. intended use I will make every effort to provide you with a fix within 90
  354. days or return you your money.  You can either write me thru snail mail
  355. or send email to my CompuServe address listed below.  I also hang out 
  356. in the os2user forum.
  357.  
  358. My Intent:
  359.  
  360. To provide a good and useful program at a reasonable price and to remedy any
  361. bugs that might be found in a reasonable time as long as it doesn't impede
  362. my real job.
  363.  
  364. ----------------------------------------------------------------------------
  365.  
  366. To Register Spell Master software:
  367.  
  368. Fill out these fields below.  Be exact in these as they tie into your registration key.
  369.  
  370.  
  371.       Whole Name: ________________________________  (First Middle Init. Last)(At least 9 characters)
  372.  
  373.          Address: ________________________________     (At least 7 characters)
  374.  
  375. City, State, Zip: ________________________________     (At least 9 characters)
  376.  
  377. Where did you get the program: ______________________________________
  378.  
  379. Your Email address and type: ________________________________________
  380.  
  381. If Internet, does your email have MIME (file attachment) capabilities?: _________
  382. (like OS/2 Ultimail) so I could send you a zip file.
  383.  
  384. Your sound card: __________________________________
  385.  
  386. [I will try to keep registered users, that have email, abreast of pertinent updates, etc...]
  387.  
  388. ----------------------------------------------------------------------------
  389.  
  390. Send U.S. $20.00 with this info. and a self addressed stamped envelope to:
  391.  
  392. Stan Towianski
  393. (spell master software)
  394. 8711 Leslie
  395. Sterling Hts, MI  48314
  396.  
  397. I will send you back the registration key in your envelope to
  398. put into your program to unlock the full functionality of the program.
  399.  
  400. Or if you wish you can skip the self addressed stamped and enclose me your
  401. Internet or CompuServe address and I will email you back your registration
  402. key.
  403.  
  404. Any and all constructive comments are welcomed!
  405.  
  406. Other Languages:
  407.  
  408. This program can be used by anyone for (almost) any language.
  409. If you speak a different language and would like a version with all the
  410. windows in your language you could write down all the English window
  411. phrases and the equivalent in your language and I (time and ability
  412. permitting) might make an attempt to publish a version in your language.
  413.  
  414. I studied Spanish a lot before, though it has been a long time, so that is
  415. a likely candidate.
  416.  
  417. Notify Educators:
  418.  
  419. If you happen to know any educators you might let them know about this
  420. program as I think they would be interested.  I would appreciate it and it
  421. could help OS/2.
  422.  
  423.  
  424. Main Posting Areas:
  425.  
  426. CompuServe: os2share (Shareware lib), os2user (Open Forum lib)
  427. BBS: Pete Norloff's at 1-703-385-4325
  428. Internet: Hobbes (hobbes.nmsu.edu)
  429.  
  430. Contact Info:
  431. =============
  432. Stan Towianski
  433.  
  434. CompuServe:  72242,221
  435. Internet:  72242.221@compuserve.com              (that is 72242period...)
  436.  
  437. Thank You.
  438.  
  439.