home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / educate / ultfr112.arj / TEACHER.DOC < prev    next >
Text File  |  1993-05-17  |  27KB  |  546 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            Ultimate Language Teacher
  20.  
  21.                           A Foreign Language Teacher
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                                                 Distributed by:
  47.  
  48.                                                               Ultimate Software
  49.                                                                   P.O. Box 1949
  50.                                                            Muncie, IN 47308-194
  51.                                                                 (317) 741-9092
  52.  
  53.  
  54.                        Programming by Richard W. Watson
  55.  
  56.              Documentation by Richard W. Watson and Tom Knackstedt
  57.  
  58.                          Copyright and distribution by
  59.                                Ultimate Software
  60.                                 P. O. Box 1949
  61.                              Muncie, IN  47308-1949
  62.                              (317) 741-9092 (voice)
  63.  
  64.  
  65. Program and Documentation Copyright 1991 Ultimate Software.  All rights
  66. reserved.
  67.  
  68.  
  69. Ultimate Language Teacher is a trademark of Ultimate Software.
  70. PC, PC XT, PC AT, PS/2 are trademarks of IBM Corporation.
  71.  
  72.  
  73.  
  74.                                ACKNOWLEDGEMENTS
  75.  
  76.  
  77. We at Ultimate Software couldn't possibly produce products like this one
  78. without help.  We would like to thank the following people:
  79.  
  80.      A special thanks to Mike for making this all possible.
  81.      To Pat who has listened even when she had no idea what I was talking
  82.      about, or why.
  83.      To Tom for his excellent beta testing and advice.
  84.      To Thomas for taking over my other responsibilities.
  85.      To Mike Smedley and SoftC, Ltd. who developed The C Extended Library and
  86.           The SoftC Database Library that made coding so much easier.
  87.  
  88.  
  89.  
  90. The following tools were used in creating this software:
  91.      
  92.      Compilers:          Borland C++ 2.00, and Borland Assembler 2.0.
  93.      Libraries:          The C Extended Library from Mike Smedley and
  94.                          TesSeRact, SoftC Database Library from SoftC, Ltd.
  95.      Debuggers:          Borland Turbo Debugger 2.0, and Borland C++
  96.                          Interactive Development Environment.
  97.  
  98.  
  99. TABLE OF CONTENTS
  100.  
  101.      Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  102.      Registration Information                                                 1
  103.      License Agreement. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  104.      Technical Support                                                        4
  105.      Program Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  106.      Installation                                                             5
  107.      Execution  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  108.           Main Menu                                                           6
  109.                Test Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  110.                Libraries                                                      7
  111.                People . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  112.                     Add a Person                                              8
  113.                     Remove a Person . . . . . . . . . . . . . . . . . . . . . 8
  114.                     See Scores                                                8
  115.                     Graph Scores. . . . . . . . . . . . . . . . . . . . . . . 8
  116.                Register                                                       9
  117.      
  118. Introduction                                                            Page 1
  119.  
  120.      Welcome, and thank you for trying the Ultimate Language Tutor.
  121.  
  122.      The Ultimate Language Tutor was designed to help you learn words from
  123.      foreign languages like Spanish, French and German through quizzing.
  124.  
  125.      You'll find the Ultimate Language Tutor has a wide array of quizzing
  126.      features and is very expandable through its library system.
  127.  
  128.      The Ultimate Language Tutor is being distributed through Shareware, which
  129.      allows you to test out a program before purchasing it.  Further
  130.      explanation of Shareware and Registration can be found on this page.
  131.  
  132.      In the following pages you will learn how to install and use The Ultimate
  133.      Language Tutor to its full benefit.
  134.  
  135.      The ASCII test found in this "electronic" manual are only slightly
  136.      different from the printed manual.  The printed manual is written around
  137.      the concept that you are a registered user.
  138.  
  139. Registration Information
  140.  
  141.      The Ultimate Language Tutor is a copyrighted program protected by all
  142.      applicable U.S. and International copyright laws.  If you have obtained
  143.      this copy from a shareware disk vendor, an on-line computer service or
  144.      bulletin board, a friend or colleague, or any similar source, you have the
  145.      trial (unregistered) copy.  You are allowed to use this copy without
  146.      charge for a limited time as specified under the license agreement.  After
  147.      this time, you must register in order to continue using The Ultimate
  148.      Language Tutor legally.
  149.  
  150.      This method of distribution is known as Shareware, a distribution concept
  151.      began by Jim Button.  It allows you, as a user, to evaluate the software
  152.      in your own home to make sure it meets your needs before you pay for it.
  153.  
  154.      The registration fee for The Ultimate Language Tutor is only $20.  Payment
  155.      of this fee entitles you to:
  156.  
  157.           A disk with the latest version of The Ultimate Language Tutor,
  158.           registered directly to you.
  159.  
  160.           A program that will allow you to create your own (or modify existing)
  161.           libraries of words for use with this tutor.
  162.  
  163.           An upgrade to the next major release of The Ultimate Language Tutor.
  164.  
  165.           Technical Support via telephone or selected Electronic Bulletin
  166.           Boards.
  167.  
  168.           Notification of other programs within the Ultimate Software Library.
  169. Ultimate Language Tutor's License Agreement                             Page 2
  170.  
  171.      (1)  Copyright:  This program, documentation, and supplied libraries are
  172.      Copyright Ultimate Software 1991, and are protected by U.S. and
  173.      International copyright laws.  You are granted a license to use your copy
  174.      of The Ultimate Language Tutor under the terms and conditions specified in
  175.      this license agreement.
  176.  
  177.      (2)  Definitions:   The Ultimate Language Tutor is being distributed in
  178.      two forms: 1.  The "registered" copy being distributed on diskette from
  179.      Ultimate Software, with a unique serial number and the words "Registered
  180.      Version" appearing at the border of the "Program Description Window" and
  181.      on the diskette label.  2.  A "shareware" copy being distributed via
  182.      electronic bulletin boards, on-line services, shareware disk vendors, or
  183.      another individual.  This copy will have the words "UNREGISTERED VERSION"
  184.      appearing at the border of the "Program Description Window".
  185.  
  186.      (3)  Shareware Copies:  Shareware copies are distributed to allow you to
  187.      try the program before you pay for it.  These copies are still Copyright
  188.      Ultimate Software 1991.  These copies are not to be confused with "public
  189.      domain" or "free" software.  You are allowed to use the shareware copies
  190.      for a trial period of 30 days.  Once the trial period is over, you are
  191.      required to register with Ultimate Software for $20.
  192.      
  193.      (4)  Registered Copies:  Registered copies are only distributed to those
  194.      persons who have purchased them through Ultimate Software or an authorized
  195.      reseller.  You registered copies may only be used in accordance with the
  196.      License agreement and any additional specifications defined within
  197.      enclosed documents.  (In other words, for site licenses.)
  198.  
  199.      (5)  Use on Networks or Multiple Systems:  A site license agreement will
  200.      accompany your copy of the Ultimate Language Tutor if you have purchased
  201.      one.  The number of "users" permitted will be defined within this
  202.      document.  If you did not purchase a site license agreement, then you are
  203.      limited to one "user".
  204.  
  205.      (6)  User:  A computer on which the Ultimate Language Tutor is installed,
  206.      regardless of whether the user is aware of this installation.
  207.  
  208.      (7)  Copying the Ultimate Language Tutor:  
  209.           Registered Users:
  210.                You may make as many copies of the Ultimate Language Tutor as
  211.                you require for your own backup purposes.  No copies of the
  212.                REGISTERED version shall be distributed by you or anyone acting
  213.                in your behalf (employees, etc.) to anyone who has not purchased
  214.                the Ultimate Language Tutor.  You may create and distribute an
  215.                unlimited number of copies of the UNREGISTERED version(s) to
  216. License Agreement (continued)                                           Page 3
  217.                anyone you wish as long as the maximum billed amount does not
  218.                exceed $6.00 (US) for this program, documentation, and any other
  219.                "accompanying" parts related directly to this program.
  220.           Unregistered Users:
  221.                You may make as many copies of the UNREGISTERED version(s) to
  222.                give / distribute to anyone you wish as long as the maximum
  223.                billed amount does not exceed $6.00 (US) for this program,
  224.                documentation, or any other "accompanying" parts related
  225.                directly to this program.
  226.  
  227.      (8)  Distribution:  You MAY NOT attempt to distribute this program with
  228.      the intent of mass production for the public without prior written
  229.      permission by Ultimate Software.  You MAY create individual copies for
  230.      friends or associates for their individual use.  If you are a bulletin
  231.      board system or shareware disk vendor:  you may not distribute this
  232.      diskette without prior written permission of Ultimate Software unless you
  233.      are part of the Association of Shareware Professionals and are approved by
  234.      the ASP for distribution.
  235.  
  236.      (9)  Limited Warranty:  Ultimate Software warrants to the owners of
  237.      registered copies of the Ultimate Language Tutor that the software will
  238.      operate as described in the documentation, and that the diskette and
  239.      manual will be free of defects which interfere with normal use.  This
  240.      warranty is valid for 90 days from the date of purchase from Ultimate
  241.      Software.  During this warranty period Ultimate Software will at its
  242.      option repair or replace any defective item(s), or refund the purchase
  243.      price of any defective item(s), if such defect is found to be the fault of
  244.      Ultimate Software and not the result of misuse or abuse beyond "standard"
  245.      use.  In no event will Ultimate Software be held accountable for any
  246.      financial amount exceeding the purchase price of this package.
  247.  
  248.      (10)  Guarantees:  If you are not satisfied with the registered copy of
  249.      the Ultimate Language Tutor, you may return the entire package at any time
  250.      up to 90 days after the date of purchase to Ultimate Software for a full
  251.      refund.  This applies even if you have found no software defects.  
  252. Technical Support                                                       Page 4
  253.  
  254.      Technical support is available to registered users.  If you are evaluating
  255.      a shareware version of the Ultimate Language Teacher, we will be available
  256.      to answer questions about installation, however, we cannot provide
  257.      continuing support until you register.  We have found that most of the
  258.      questions asked can be answered in the documentation, so please be sure to
  259.      review all of the documentation before calling.
  260.  
  261.      The best way currently to contact us for support is by phone.  We are
  262.      considering setting up support areas on other Bulletin Board Systems;
  263.      however, this support is not currently in effect.  You can find our
  264.      telephone number at the beginning of this documentation.
  265.  
  266.  
  267. Program Features
  268.  
  269.      The Ultimate Language Tutor was written to help people studying a foreign
  270.      language by quizzing them on words listed in a library.  As the program
  271.      developed, more and more features were requested and eventually included. 
  272.      The list of features currently is as follows:
  273.  
  274.      Libraries segmented by Noun, Verb, Misc...:
  275.           It was determined that the new language was learned easiest when the
  276.           words were grouped into like areas, for instance, Nouns, Verbs,
  277.           Miscellaneous.  When these areas are reviewed, one could then move on
  278.           to learn phrases and verb conjugation.
  279.  
  280.      Keeping track of scores for people:
  281.           If you select the people menu, you can enter your name and set up
  282.           memory to track your testing scores.  At each test area, the computer
  283.           will ask you if you would like to test for a specific person. It will
  284.           then display a list of people it knows for your selection.  After the
  285.           test is complete, you can return to the people menu and view your
  286.           scores as a graph.  If you do not complete the test, the score will
  287.           not be kept.  If you change libraries, all the scores will be erased
  288.           and you begin tracking scores under the new library, unless you have
  289.           registered.  In the registered upgrade, the scores for any tests done
  290.           by a specific person will be tracked in the database.
  291.  
  292.      Easy access to libraries:
  293.           When you pick a library from the main menu, you will be presented
  294.           with a list of the libraries on the default drive.  Simply scroll
  295.           through this list and select the new library.  The new library will
  296.           be loaded, and you may test from it.
  297.  
  298.      Database tracking (added to the registered version):
  299.           When you have started a test, your name, date, time, and the library
  300.           name will be added to a database, along with the area you are
  301.           testing.  When you have completed your test, the database will be
  302.           updated.  This database is dBase III compatible and can be modified
  303.           through dBase III, dBase III+, dBase IV, FoxBase, FoxPro, PCFile or
  304.           any dBase program capable of handling dBase III data files.
  305. Program Features (continued)                                            Page 5
  306.      Reporting (added to the registered version):
  307.           The reporting functions allow you to report to disk, screen or any
  308.           standard printer.  The database can be sorted by Name, Library, or
  309.           Date.  Then there is a list of filtering functions so that you can
  310.           isolate one student, one library, a group or groups (nouns,
  311.           verbs...), a range of dates, or only completed tests.  These
  312.           functions were set up to allow you to view how you have been doing
  313.           since you started.  For instance, you could create a report of only
  314.           your name, in all libraries, tested after 06/30/91, for only
  315.           completed tests, and include only nouns and verbs.  This would let
  316.           you isolate only areas of the database you want to view.
  317.  
  318.      Library Builder (distributed with the registered version):
  319.           The library builder allows you to create customized libraries for use
  320.           with the Ultimate Language Teacher.  This can be of great help for
  321.           tests in school or even if you are about to head to a foreign country
  322.           and don't feel that the included libraries will be enough.  The
  323.           Library Builder will also allow you to create other language
  324.           libraries -- you don't have to stick with just one.
  325.  
  326.  
  327. Installation
  328.  
  329.      The Ultimate Language Tutor was written for the IBM PC, PC/XT, PC/AT,
  330.      PS/2, and compatibles.  It requires MS/PC-DOS 2.0 or above, and at least
  331.      512K on your machine, free ram should be slightly above 269K.
  332.  
  333.      Files
  334.  
  335.      The files listed below should be included with your shareware version, or
  336.      copy you receive:
  337.  
  338.      TEACHERS.EXE        This is the Shareware version of the Ultimate Language
  339.                          Teacher.
  340.  
  341.      TEACHER.CFG         This file contains configuration information and a
  342.                          copy of the registration sheet.  You may view/print
  343.                          this sheet from within the program.
  344.  
  345.      LIB?????.DAT        These are the data files or libraries used by the
  346.                          Ultimate Language Teacher.
  347.  
  348.      For registered users, your copy should include the above, plus:
  349.  
  350.      LIBBUILD.EXE        This is the library builder used to create
  351.                          LIB?????.DAT files.
  352.  
  353.      TEACHERR.EXE        This is the Registered version of the Ultimate
  354.                          Language Teacher.
  355. Execution                                                               Page 6
  356.  
  357.      The program was designed around the use of bar menus to allow the easiest
  358.      possible interface between user and program.  All menus include mouse
  359.      support if a mouse driver is loaded.
  360.  
  361.      MAIN MENU
  362.  
  363.      The main menu will include different selections depending upon whether you
  364.      are using the registered version or not.  
  365.  
  366.           Test         ->Test from the selected library.
  367.           Libraries    ->Libraries allow for other languages and more words
  368.           People       ->Allows for up to 3 people to "compete"
  369.           Register     ->Registration form and registration number
  370.           QUIT         ->Returns you to DOS or your menu program
  371.  
  372.      In order to elaborate on each selection, I will follow each of them to the
  373.      end and then come back on the others.  Therefore, here is a cross-
  374.      reference table to the beginning of other menu selections:
  375.  
  376.           TEST                          Page 6.
  377.           LIBRARIES                     Page 7.
  378.           PEOPLE                        Page 8.
  379.           REGISTER                      Page 9.
  380.  
  381.      TEST
  382.  
  383.      The test menu will open a new menu that should appear with the following
  384.      selections:
  385.  
  386.      NOTE:  If there are not enough words in an area to test you on, there will
  387.      be a message like:  Insufficient nouns in the library.
  388.  
  389.           Nouns          ->Test from the XXX nouns in the library.
  390.           Verbs          ->Test from the XXX verbs in the library.
  391.           Phrases        ->Test from the XXX phrases in the library.
  392.           Verb Conj.     ->Test from the XXX Conjugated Verbs in the library.
  393.           Miscellaneous  ->Test from the XXX Miscellaneous words in the
  394.           library.
  395.           MAIN MENU      ->Returns you to the main menu.
  396.  
  397.      When you select what area you would like to be tested on, you will be
  398.      asked the following questions:
  399.  
  400.               Would you like to test for a specific person (Y/N)?
  401.  
  402.      NOTE:  This question only appears if you have entered a person under the
  403.      people menu.  This will allow you to track scores during this session.
  404.  
  405.                  Would you like a multiple choice test (Y/N)?
  406. Execution (continued)                                                   Page 7
  407.  
  408.      If you select no you will have fill in the blank answers, otherwise you
  409.      will be presented with a list of 5 possible answers.  NOTE:  There are no
  410.      fill in the blanks under verb conjugation.
  411.  
  412.                    Would you like ENGLISH to XXXXXXX (Y/N)?
  413.  
  414.      If you select yes, the test will display the question in ENGLISH and ask
  415.      you for the foreign language answer.  Otherwise, this will be reversed.
  416.  
  417.      During testing, the screen will be divided into two major screens, the
  418.      QUIZ ENTRY SCREEN and the QUIZ RESULTS SCREEN.  The QUIZ ENTRY SCREEN on
  419.      the left will display the question and await your answer.  The QUIZ
  420.      RESULTS SCREEN will have information on the test so far; for instance,
  421.      number correct, number tested, percentage correct, average time per
  422.      answer, and time for last answer.  The information on amount of time for
  423.      testing is not recorded and placed there for your own convenience.
  424.  
  425.      Directly below these two screens will be two bar graphs.  The top graph
  426.      shows the amount of the library you have been tested on and the other
  427.      shows you the percentage correct.  If, for instance, you get the first
  428.      question correct, the bottom bar will be all the way across the screen and
  429.      the top bar will move proportional to the amount of the library that
  430.      question represents.
  431.  
  432.      Once testing is completed or if you press ESC before completing a test
  433.      sequence, a summary box will replace the two windows and two bar graphs. 
  434.      It will tell you how you have done and if you have completed the test.  At
  435.      this point, you can press enter or click the mouse on the phrase "Press
  436.      Enter to Continue".  You will be returned to the TEST MENU to select
  437.      another area for testing or return to the MAIN MENU.
  438.  
  439.  
  440. LIBRARIES
  441.  
  442.      If during testing, you decide that you want to use another library, you
  443.      should simply select LIBRARIES from the main menu.  A list of currently
  444.      accessible libraries will be displayed for you to select from.  Simply
  445.      move the high-lighted bar up or down and press enter when you are on the
  446.      library you want.  If the library you want is not displayed, you can use
  447.      the PgDn or PgUp keys to check for another screen.  If you are using a
  448.      mouse there will be two arrows on the border for moving the high-lighted
  449.      bar, or you may simply click on the library you want.  The library
  450.      function will not load more than 50 libraries, so if there is a library
  451.      you know should be loaded, check to make sure you don't have more than 50
  452.      libraries in one directory.  All library names must match the file mask
  453.      "LIB*.DAT", for instance LIBSPAN.DAT is OK, but LSPANISH.DAT is not.
  454. PEOPLE                                                                  Page 8
  455.  
  456.      The people selection will bring up another menu, something like this:
  457.  
  458.           Add a person        ->Add a person to the list
  459.           Remove a person     ->Remove a person from the list
  460.           See Scores          ->View current scores for all people
  461.           Graph Scores        ->Show a graph of the scores, comparing all
  462.           people
  463.           MAIN MENU           ->Return to main menu
  464.  
  465.  
  466. ADD A PERSON
  467.  
  468.      The program was designed to keep an internal table of the people testing
  469.      to record there results and to show them their results compared to others
  470.      currently using the program.  When you select ADD A PERSON, the menu will
  471.      be replaced by a box showing all of the names in the internal table.  It
  472.      will then ask you for a new person.  If you choose not to enter another
  473.      person, you can simply press ENTER or ESC to return to the PEOPLE MENU. 
  474.      If you enter a person, the person will be added to the internal table and
  475.      the names in the box will be updated.  Once you have entered the maximum
  476.      number of people, the PEOPLE menu will automatically return.  If you have
  477.      the maximum number of people already entered and try to enter another, a
  478.      message will appear informing you of the problem.  You must either remove
  479.      a person or continue testing with the people currently on the list.
  480.  
  481. REMOVE A PERSON
  482.  
  483.      As mentioned under ADD A PERSON, the internal table of people is limited
  484.      to a certain number.  Once this number is reached, you must remove a
  485.      person to add a person.  This area of the people menu will help you do
  486.      this.  When you select Remove a Person, a list of the people that are
  487.      currently on the list pops up, and you can select a person to remove. 
  488.      Press ESC if you don't want to remove a person.
  489.  
  490. SEE SCORES
  491.  
  492.      This will display the current scores for the people the computer knows
  493.      about.  Once you are done viewing, you can press ENTER to return to the
  494.      people menu.
  495.  
  496. GRAPH SCORES
  497.  
  498.      This is much like SEE SCORES; however, it will display the scores as a
  499.      graph.  Some people find this method easier for determining who is ahead. 
  500.      When you select this function, there will be a list of the people on the
  501.      left, and a box on the right with the current scores for nouns listed. 
  502.      You need to use the arrow keys at this point to display each person's
  503.      scores, or select Quit.
  504. REGISTER                                                                Page 9
  505.  
  506.      When you select register from the MAIN MENU, a box will come up displaying
  507.      a message that you can either print the registration form or display it on
  508.      screen.  Then it will ask if you would like the form printed.  If you
  509.      answer Yes, please make sure your printer is set up and has paper in it. 
  510.      The registration form is only one page and there shouldn't be any problems
  511.      with printing.  If you answer No, the registration form will be displayed
  512.      on screen in three separate screens; just press a key to see the next one. 
  513.      If you are copying down the form, please make sure that you copy
  514.      everything down exactly as you see it.  Then fill out the questions.  If
  515.      you don't feel like answering the questions about your system, that is
  516.      fine.  However, please feel free to make any comments or suggestions
  517.      anywhere on the sheet.  Also make sure to copy down the special
  518.      registration number.  The registration number tells us where your copy of
  519.      the Ultimate Language Tutor came from.
  520.  
  521.      Remember that registration will bring you an upgrade to the Registered
  522.      version of the program.  The registered version has all of the features
  523.      found in this copy and includes the following:
  524.  
  525.      1.   Database functions:  All of the tests for a specific person will be
  526.           recorded.  Any record can be easily removed if you decide you don't
  527.           want anyone to be able to see your initial scores.
  528.  
  529.  
  530.      2.   Reporting functions:  Any of the scores recorded in the database can
  531.           be viewed in a report.  Reporting is very flexible, output may be
  532.           redirected to either the screen, printer, or a file.  All reports may
  533.           be sorted by Name, Library, or Date.  All reports allow you to
  534.           "filter" out whatever you don't want on the report.  For example: 
  535.           You could have a report sorted by date with only a specific person
  536.           tested on a specific library with only completed tests from nouns,
  537.           verbs, and misc.
  538.  
  539.      3.   Information about all of the other Ultimate Software programs that
  540.           are currently available, as well as new ones as they are released.
  541.  
  542.      4.   Unlimited technical support:  We have a phone number you may call in
  543.           the event that you have any problems with this program.
  544.  
  545.  
  546.                  End of Ultimate Language Tutor Documentation