home *** CD-ROM | disk | FTP | other *** search
/ AMIGA PD 1 / AMIGA-PD-1.iso / Programme_zum_Heft / Programmieren / Kurztests / ACE / Prgs / learning / 80Questions.lha / 80Questions / 80Questions.doc < prev    next >
Text File  |  1994-11-08  |  10KB  |  280 lines
  1.  
  2.  **************************************************
  3. *            80Questions 1.0                       *
  4. *            November 8, 1994                      *
  5. *                 by                               *
  6. *             Sean J. Miller                       *
  7.  **************************************************
  8.  
  9.  
  10.  
  11.  
  12.     I.    TABLE OF CONTENTS
  13.  
  14.    Section              Line
  15.    -------------------------------------------------
  16.      II.  Installation............................28
  17.     III.  What is 80Questions 1.0?............... 37
  18.      IV.  Making a Test.......................... 60
  19.       V.  Starting the Program...................121
  20.      VI.  Using the Program......................145
  21.     VII.  Using Responses........................195
  22.    VIII.  Future Versions........................213
  23.      IX.  Acknowledgements.......................224
  24.       X.  Last words.............................249
  25.     ***** Final Note.............................267
  26.  
  27.  
  28.    II.    Installation
  29.  
  30.    Just execute the install program named INSTALL.  This
  31. will copy the required fonts from the 80Questions directory
  32. to your FONTS: directory.  Otherwise, copy the files in the
  33. Fonts directory of 80Questions to your FONTS drawer of your
  34. Workbench manually.
  35.  
  36.  
  37.   III.    What is 80Questions 1.0?
  38.  
  39.    FREEWARE-I know that was bothering your conscious, so I
  40. got it over with as quickly as possible.  You don't owe a thing for
  41. it.  How could I ask you for money when I can't pay the one's
  42. who created much better programs.  So if you do feel generous,
  43. send your donations to authors of such programs as FreePaint,
  44. ACE, and DICE. These have helped many broke Amiga users make
  45. the most out of their machines-especially in the States where an
  46. Amiga owner is as common as necrophilia.
  47.  
  48.    The program is a flashcard simulator to help one study.
  49. It has all the features of handwritten flashcards.  For instance,
  50. one can randomize the order of the cards or flip them over and view
  51. the answer and respond with the question.  It is very helpful to
  52. me for classes which require blind memorization since I don't
  53. like studying for classes like that, but I do like using the Amiga.
  54. For those of you who prefer the Amiga for the home, but have to
  55. use an IBM compatible at work, I also have a PC version so that
  56. one could use it to study their tests at work.  Just contact me at
  57. the address at the end for a copy.
  58.  
  59.  
  60.    IV.    Making a Test
  61.  
  62.    I wanted to make an editor that was easily manipulated
  63. for all users; therefore, I didn't make one at all.  Instead, I
  64. decided to let you use your own favorite text editor. I prefer
  65. "ED" which came with my Amiga from Commodore due to its
  66. simplicity.  You may prefer to use your word processor
  67. because of the advantages of spell-checking.  "80Questions"
  68. really doesn't care.
  69.  
  70.    What it does care about, though, is that the test is in
  71. ASCII.    Text editors such as ED that came with the Amiga already
  72. write in the ASCII format with no imbedded commands, but most
  73. word processors usually do not. There should be an option,
  74. however, in the word processor to export the file as ASCII.  Be
  75. sure to do so.
  76.  
  77.    Also, DO NOT ALLOW WORD-WRAPPING!  This can be
  78. accomplished by extending you right margin way out in your
  79. word processor, or using a text editor that does not care how
  80. long a row of text is.  "80Questions" will do the word
  81. wrapping for you.
  82.  
  83.    The reason for no word-wrapping when entering the text
  84. is that the computer takes each line as a separate entry.  The
  85. first entry (line) is the first question, the second entry (line) is
  86. the first answer, the third entry (line) is the second question, the
  87. fourth entry (line) is the second answer...etc.  Here is an
  88. example:
  89.  
  90.     How old are you?
  91.     21
  92.     What year were you born?
  93.     1972
  94.     What is your girlfriend's name?
  95.     Rosie Palm
  96.  
  97.    As you can see word-wrapping would cause the wrapped
  98. part of the line to become the answer to the first part of the line.
  99. So, don't let this happen!!!  Look at the file "example.txt" to see
  100. how a test may be written if you still don't understand.
  101.  
  102.    It is okay, however, to put a row of nothing between each
  103. question and/or answer.  The program will ignore any empty
  104. lines (which consist of just a hard return).  Here is an example
  105. of what I mean:
  106.  
  107.     How old are you?
  108.     21
  109.  
  110.     What year were you born?
  111.     1972
  112.  
  113.     What is your girlfriend's name?
  114.     Rosie Palm
  115.  
  116.    This would be perfectly acceptable. Remember:  the
  117. only thing not acceptable is for a continuous line to be
  118. word-wrapped by the text editor or word processor!!!!
  119.  
  120.  
  121.     V.    Starting the Program
  122.  
  123.    After you have made a test there are two ways to begin
  124. it:
  125.  
  126.       Workbench:  Create a project icon for the test or
  127.                   copy one of mine to it (see
  128.                   below).
  129.                   Click on the test icon, hold down
  130.                   shift, then double click on the
  131.                   80Questions icon.
  132.  
  133.       Cli:     Type:
  134.                   80Questions [TestFilename]
  135.  
  136.    To copy my icon to your test, go to the Cli (shell) and type
  137. the following using your TestFileName:
  138.  
  139.    copy example.txt.info to <TestFileName>.info
  140.  
  141.    Of course, be sure to be in the appropriate directory before
  142. doing so.
  143.  
  144.  
  145.    VI.    Using the Program
  146.  
  147.    The program is pretty straight forward.  Here are
  148. definitions of features.  You always get to choose which
  149. questions  of the test in which to apply the features.
  150.  
  151.    ORIGINAL    - The questions and answers
  152.                  are directly in the order
  153.                  written.
  154.    RANDOM      - Scrambles the order of
  155.                  the questions and
  156.                  answers.
  157.    REVERSED    - Gives the answer and asks for
  158.                  the question, but still
  159.                  in the original order written.
  160.    NEW         - Let's you go to another test
  161.                  without having to exit the
  162.                  program.
  163.    SNAPSHOT    - If you find the original
  164.                  program's windows and
  165.                  centered text to look absurd
  166.                  with your Workbench, then
  167.                  adjust them to your
  168.                  preferences (while still
  169.                  maintaining program
  170.                  readability) and choose this
  171.                  option. The new settings are
  172.                  then written to the file
  173.                 "80Questions.cfg."
  174.    HELP        - Everything you need to know
  175.                  about "80Questions"
  176.                  without my wordiness.
  177.  
  178.  
  179.    Other things to know:
  180.  
  181.       [-quit]  (including the dash) will stop a test
  182.                in progress immediately.
  183.  
  184.       [-responses on]  turns on the samples during a test.
  185.       [-responses off] turns the samples off.
  186.  
  187.       [-talk on]   turns on the Amiga's speech.
  188.       [-talk off]  turns off the Amiga's speech.
  189.  
  190.       [-back]  lets you flip through previous
  191.                questions.
  192.       [-help]  gives you help
  193.  
  194.  
  195.   VII.    Using Responses
  196.  
  197.    Responses are to add a little fun to the program.  I was
  198. afraid of users getting bored of them, so I made it flexible.
  199. To add your own responses you must edit the following files:
  200.  
  201.       rightiffs
  202.       wrongiffs
  203.  
  204.    These files must hold the complete pathname of an
  205. IFF sampled sound.  Place only one pathname per line.  The
  206. LIMIT IS FORTY SAMPLES per file.  I have included some of my
  207. favorites to help you get started.
  208.    Remember:  if you move my favorite samples to another
  209. directory, you MUST change the path name in the appropiate
  210. file!
  211.  
  212.  
  213.  VIII.    Future Versions
  214.  
  215.    Since I am a big music buff, I also thought it would be
  216. neat to add a soundtrack option in which the user specifies
  217. the path of an OctaMed song to play while taking the test.  I
  218. like to try to milk the Amiga for what it's worth.
  219.    I'm already totally revamping the program to be almost
  220. totally graphically based so there are no longer any keywords
  221. to memorize.
  222.  
  223.  
  224.    IX.    Acknowledgements
  225.  
  226.    I'd like to thank the following for their greatly appreciated,
  227. though unrewarded help on this project:
  228.  
  229.    David Benn     - Creator of the great compiler ACE.
  230.                     In essence, he did all the hard work.
  231.                     He could also find bugs in a second
  232.                     that I didn't notice all year.
  233.                     You can get the ACE BASIC compiler
  234.                     at:  ftp.appcomp.utas.edu.au.
  235.                          /pub/amiga/ACE
  236.  
  237.    Björn Trost    - Good friend from overseas who has
  238.                     enlightened me on many things
  239.                     concerning the Amiga.  Also, the
  240.                     author of FreePaint which was
  241.                     used to create the icons (except
  242.                     the .doc icon which is from
  243.                     the icon package MagicWB.)
  244.  
  245.    Brenda Jarrell - For her last minute ideas such as
  246.                     the '-back' keyword.
  247.  
  248.  
  249.     X.    Last Words
  250.  
  251.    If you find any bugs, can't get the program to work on
  252. your machine, or want to give any advice on improvements,
  253. feel free to contact me through the following methods.
  254.  
  255.    Mail: Sean J. Miller
  256.          4701 Lafayette Road
  257.          Hopkinsville, KY  42240
  258.          United States of America
  259.  
  260.   EMail: sjmill01@ukcc.uky.edu
  261.  
  262.    I hope this program helps you in your work, and good
  263. luck towards earning your degree or whatever you're studying.
  264.  
  265.                                             -Sean
  266.  
  267. **** FINAL  To increase or decrease the limit of questions
  268. **** NOTE:  allowed, change line 16 of the source code to:
  269.  
  270.             CONST MAX = Your desired value
  271.  
  272.             Just in case, "Your desired value" is an integer!
  273.  
  274.             Then recompile using the compiler ACE found at:
  275.  
  276.                ftp.appcomp.utas.edu.au
  277.  
  278.             Under the directory:  /pub/amiga/ACE
  279.  
  280.