home *** CD-ROM | disk | FTP | other *** search
/ Kids Cube / 4_History.iso / ultgeo / geograph.doc < prev    next >
Text File  |  1992-04-10  |  24KB  |  540 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                               Ultimate Geography
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                                                 Distributed by:
  46.  
  47.                                                               Ultimate Software
  48.                                                                  P. O. Box 2454
  49.                                                           White City, OR  97503
  50.                                                                  (503) 830-0501
  51.  
  52.  
  53.                        Programming by Richard W. Watson
  54.  
  55.              Documentation by Richard W. Watson and Tom Knackstedt
  56.  
  57.                          Copyright and distribution by
  58.                                Ultimate Software
  59.                                 P. O. Box 2454
  60.                              White City, OR 97503
  61.                             (503) 830-0501 (voice)
  62.  
  63.  
  64. Program and Documentation Copyright 1991-92 Ultimate Software.  All rights
  65. reserved.
  66.  
  67.  
  68. Ultimate Geography is a trademark of Ultimate Software.
  69. PC, PC XT, PC AT, PS/2 are trademarks of IBM Corporation.
  70.  
  71.  
  72.  
  73.                                ACKNOWLEDGEMENTS
  74.  
  75.  
  76. We at Ultimate Software couldn't possibly produce products like this one
  77. without help.  We would like to thank the following people:
  78.  
  79.      A special thanks to Mike for making this all possible.
  80.      To Pat who has listened even when she had no idea what I was talking
  81.      about, or why.
  82.      To Tom for his excellent beta testing and advice.
  83.      To Thomas for taking over my other responsibilities.
  84.      To Mike Smedley and SoftC, Ltd. who developed The C Extended Library and
  85.           The SoftC Database Library that made coding so much easier.
  86.  
  87.  
  88.  
  89. The following tools were used in creating this software:
  90.      
  91.      Compilers:          Borland C++ 2.00, and Borland Assembler 2.0.
  92.      Libraries:          The C Extended Library from Mike Smedley and
  93.                          TesSeRact, SoftC Database Library from SoftC, Ltd.
  94.      Debuggers:          Borland Turbo Debugger 2.0, and Borland C++
  95.                          Interactive Development Environment.
  96.  
  97.  
  98. TABLE OF CONTENTS
  99.  
  100.      Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  101.      Registration Information                                                 1
  102.      License Agreement. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  103.      Technical Support                                                        4
  104.      Program Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  105.      Installation                                                             5
  106.      Execution  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  107.           FILE                                                                6
  108.           QUIZZING. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
  109.           STATE INFO                                                          7
  110.           GRAPH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  111.  
  112. Introduction                                                            Page 1
  113.  
  114.      Welcome, and thank you for trying Ultimate Geography.
  115.  
  116.      Ultimate Geography was designed to help you learn about the United States,
  117.      while also including a wide variety of general information.
  118.  
  119.      You'll find Ultimate Geography is full of interesting statistics about all
  120.      50 states, while still holding on to an excellent quizzing system. 
  121.      Capitals as well as State names can be quizzed, and all of the states have
  122.      information about their population, size, trivia, industries, crime,
  123.      marriage, births, divorce, and death.
  124.  
  125.      Ultimate Geography is being distributed through Shareware, which allows
  126.      you to test out a program before purchasing it.  Further explanation of
  127.      Shareware and Registration can be found on this page.
  128.  
  129.      In the following pages you will learn how to install and use Ultimate
  130.      Geography to its full benefit.
  131.  
  132.  
  133. Registration Information
  134.  
  135.      Ultimate Geography is a copyrighted program protected by all applicable
  136.      U.S. and International copyright laws.  If you have obtained this copy
  137.      from a shareware disk vendor, an on-line computer service or bulletin
  138.      board, a friend or colleague, or any similar source, you have the trial
  139.      (unregistered) copy.  You are allowed to use this copy without charge for
  140.      a limited time as specified under the license agreement.  After this time,
  141.      you must register in order to continue using Ultimate Geography legally.
  142.  
  143.      This method of distribution is known as Shareware, a distribution concept
  144.      begun by Jim Button.  It allows you, as a user, to evaluate the software
  145.      in your own home to make sure it meets your needs before you pay for it.
  146.  
  147.      The registration fee for Ultimate Geography is only $15.  Payment of this
  148.      fee entitles you to:
  149.  
  150.           A disk with the latest version of Ultimate Geography, registered
  151.           directly to you.
  152.  
  153.           An upgrade to the next major release of Ultimate Geography.
  154.  
  155.           Technical Support via telephone or selected Electronic Bulletin
  156.           Boards.
  157.  
  158.           Notification of other programs within the Ultimate Software Library.
  159.  
  160. Registration Information (continued)                                    Page 2
  161.      Or, you can take the teacher/student option for $30.  Payment of this fee
  162.      entitles you to:
  163.  
  164.           A disk with the latest version of Ultimate Geography, registered
  165.           directly to you, with all of the features listed above.
  166.  
  167.           Tracking features that will keep track of every test taken, students
  168.           name, their score, the date and time.
  169.  
  170.           Report features that include the ability to display or print reports
  171.           for individuals, a certain date, a particular score, a wide variety
  172.           of selections exists.
  173.  
  174.  
  175. Ultimate Geography's License Agreement
  176.  
  177.      (1)  Copyright:  This program and documentation are Copyright Ultimate
  178.      Software 1991-92, and are protected by U.S. and International copyright
  179.      laws.  You are granted a license to use your copy of Ultimate Geography
  180.      under the terms and conditions specified in this license agreement.
  181.  
  182.      (2)  Definitions:   Ultimate Geography is being distributed in three
  183.      forms: 1.  The "registered" copy being distributed on diskette from
  184.      Ultimate Software, with the words "Registered Version" appearing on the
  185.      diskette label.  2.  The "registered" expanded version being distributed
  186.      for teachers or students from Ultimate Software, with the words
  187.      "Plus Version" appearing on the diskette label.  3.  A "shareware" copy
  188.      being distributed via electronic bulletin boards, on-line services,
  189.      shareware disk vendors, or another individual.  This copy will include
  190.      the shareware notice when you exit the program.  All forms can be easily
  191.      identified by using the "About" selection under the "File" menu within the
  192.      program itself.
  193.  
  194.      (3)  Shareware Copies:  Shareware copies are distributed to allow you to
  195.      try the program before you pay for it.  These copies are still Copyright
  196.      Ultimate Software 1991-92.  These copies are not to be confused with
  197.      "public domain" or "free" software.  You are allowed to use the shareware
  198.      copies for a trial period of 30 days.  Once the trial period is over, you
  199.      are required to register with Ultimate Software for $15 or $30.
  200.      
  201.      (4)  Registered Copies:  Registered copies are only distributed to those
  202.      persons who have purchased them through Ultimate Software or an authorized
  203.      reseller.  Your registered copies may only be used in accordance with the
  204.      License agreement and any additional specifications defined within
  205.      enclosed documents.  (In other words, for site licenses.)
  206.  
  207.      (5)  Use on Networks or Multiple Systems:  A site license agreement will
  208.      accompany your copy of Ultimate Geography if you have purchased one.  The
  209.      number of "users" permitted will be defined within this document.  If you
  210.      did not purchase a site license agreement, then you are limited to one
  211.      "user".
  212.  
  213. License Agreement (continued)                                           Page 3
  214.  
  215.      (6)  User:  A computer on which Ultimate Geography is installed,
  216.      regardless of whether the user is aware of this installation.
  217.  
  218.      (7)  Copying Ultimate Geography:  
  219.           Registered Users:
  220.                You may make as many copies of Ultimate Geography as you require
  221.                for your own backup purposes.  No copies of the REGISTERED
  222.                version shall be distributed by you or anyone acting in your
  223.                behalf (employees, etc.) to anyone who has not purchased
  224.                Ultimate Geography.  You may create and distribute an unlimited
  225.                number of copies of the UNREGISTERED version(s) to anyone you
  226.                wish as long as the maximum billed amount does not exceed $6.00
  227.                (US) for this program, documentation, and any other
  228.                "accompanying" parts related directly to this program.
  229.           Unregistered Users:
  230.                You may make as many copies of the UNREGISTERED version(s) to
  231.                give / distribute to anyone you wish as long as the maximum
  232.                billed amount does not exceed $6.00 (US) for this program,
  233.                documentation, or any other "accompanying" parts related
  234.                directly to this program.
  235.  
  236.      (8)  Distribution:  You MAY NOT attempt to distribute this program with
  237.      the intent of mass production for the public without prior written
  238.      permission by Ultimate Software.  You MAY create individual copies for
  239.      friends or associates for their individual use.  If you are a bulletin
  240.      board system or shareware disk vendor:  you may not distribute this
  241.      diskette without prior written permission of Ultimate Software unless you
  242.      are part of the Association of Shareware Professionals and are approved by
  243.      the ASP for distribution.
  244.  
  245.      (9)  Limited Warranty:  Ultimate Software warrants to the owners of
  246.      registered copies of Ultimate Geography that the software will operate as
  247.      described in the documentation, and that the diskette and manual will be
  248.      free of defects which interfere with normal use.  This warranty is valid
  249.      for 90 days from the date of purchase from Ultimate Software.  During this
  250.      warranty period, Ultimate Software will, at its option, repair or replace
  251.      any defective item(s) or refund the purchase price of any defective
  252.      item(s), if such defect is found to be the fault of Ultimate Software and
  253.      not the result of misuse or abuse beyond "standard" use.  In no event will
  254.      Ultimate Software be held accountable for any financial amount exceeding
  255.      the purchase price of this package.
  256.  
  257.      (10)  Guarantees:  If you are not satisfied with the registered copy of
  258.      Ultimate Geography, you may return the entire package at any time up to 90
  259.      days after the date of purchase to Ultimate Software for a full refund. 
  260.      This applies even if you have found no software defects.  
  261.  
  262. Technical Support                                                       Page 4
  263.  
  264.      Technical support is available to registered users.  If you are evaluating
  265.      a shareware version of Ultimate Geography, we will be available to answer
  266.      questions about installation, however, we cannot provide continuing
  267.      support until you register.  We have found that most of the questions
  268.      asked can be answered in the documentation, so please be sure to review
  269.      all of the documentation before calling.
  270.  
  271.      The best way currently to contact us for support is by phone.  We are
  272.      considering setting up support areas on other Bulletin Board Systems;
  273.      however, this support is not currently in effect.  You can find our
  274.      telephone number at the beginning of this documentation.
  275.  
  276.  
  277. Program Features
  278.  
  279.      Ultimate Geography was written to help young geography students learn the
  280.      states and capitals; however, in testing this we found that it wasn't just
  281.      the young students who needed to learn the states.  As the program
  282.      developed, we chose to include statistical information about each of the
  283.      states as well as graphs of those statistics.  Additional features will be
  284.      added as they are requested or as we develop them.  The following features
  285.      are currently available in the shareware version:
  286.  
  287.      Quizzing of both States and Capitals:
  288.           The early version included these functions.  All states and their
  289.           capitals can be quizzed using the Quizzing selection in the main menu
  290.           appearing at the top of the screen.  The top 10 scores will be
  291.           maintained in the file SCORES.DAT.  Delete this file to clear the top
  292.           10.
  293.  
  294.      Graphs and statistics:
  295.           There are statistics that can be viewed for individual states in the
  296.           following categories:
  297.                Population 1960-1990.
  298.                Population Distribution.
  299.                State Size.
  300.                Crime Statistics.
  301.                Trivia / Industries (Includes where to find travel info).
  302.                Births / Deaths.
  303.                Marriage / Divorce.
  304.  
  305.           There are also graphing functions that can be used to show the
  306.           differences between all of the states.
  307.  
  308.      Mouse Support:
  309.           Almost any Microsoft or Logitech compatible mouse will work with the
  310.           program.
  311.  
  312. Installation                                                            Page 5
  313.  
  314.      Ultimate Geography was written for the IBM PC, PC/XT, PC/AT, PS/2, and
  315.      compatibles.  It requires EGA or VGA compatible graphics, MS/PC-DOS 2.0 or
  316.      above, and at least 512K on your machine, free ram should be slightly
  317.      above 300K.
  318.  
  319.      Files
  320.  
  321.     The files listed below should be included on your SHAREWARE copy:
  322.  
  323.      GEOGRAPH.EXE        This is the shareware version of Ultimate Geography.
  324.  
  325.      MAP.DAT             This file holds the information for building the map.
  326.  
  327.      RANGE.DAT           This file holds range information for graphing.
  328.  
  329.      STATE.DAT           This file has statistical information on each of the
  330.                          50 states.
  331.  
  332.      STATET.DAT          This file holds text data for each of the 50 states,
  333.                          such as the state's motto, bird, travel information,
  334.                          etc.
  335.  
  336.      STATEX.DAT          Additional state information.
  337.  
  338.      GEOG.DAT            Graphics for About, and the beginning of the program.
  339.  
  340.      SCORES.DAT          This file is optional, in otherwords, it may or may
  341.                          not exist.  It contains the top 10 scores under both
  342.                          states and capitals.
  343.  
  344. Execution
  345.  
  346.      This program was designed around a main bar menu located at the very top
  347.      of the screen.  This menu area is not the only area used for menuing;
  348.      however, the arrow keys will move you around the menu and allow you to do
  349.      anything that you could do with a mouse.  A mouse, if you have one, will
  350.      allow you to simply point and click on what you want.
  351.  
  352. Execution (continued)                                                   Page 6
  353.  
  354.      MAIN MENU
  355.  
  356.      The main menu consists of the following areas.
  357.  
  358.      File           ->   This is where you can exit the program or view the
  359.                          registration form.
  360.  
  361.      Quizzing       ->   This area allows you to select if you would like to be
  362.                          quizzed on states or capitals.
  363.  
  364.      State Info     ->   This area will allow you both to select a state and to
  365.                          display information on the state.
  366.  
  367.      Graph          ->   This area allows you to select an area to graph.  This
  368.                          selection also contains a 'Re-draw Map' function in
  369.                          the event that anything happens to the map.
  370.  
  371.  
  372.      In order to discuss each section, I will follow each of them to the end
  373.      and then come back to the others.  Therefore, here is a cross-reference
  374.      table to the beginning of other menu selections:
  375.  
  376.           QUIZZING                           Page 6.
  377.           STATE INFO                         Page 7.
  378.           GRAPH                              Page 8.
  379.  
  380.      FILE
  381.  
  382.      Highlighting "File" and pressing Enter or simply clicking on the word
  383.      "File" with your mouse will pop-'down' a menu with the following
  384.      selections:
  385.  
  386.           ABOUT
  387.           REGISTRATION
  388.           MAIN MENU
  389.           QUIT
  390.  
  391.      Selecting "About" will show you what version of the program you have.  In
  392.      the event that you are having any kind of problem, please make sure you
  393.      know what version you are using when you call technical support.
  394.  
  395.  
  396. FILE selection (continued)                                              Page 7
  397.  
  398.      Selecting "Registration" will bring up a selection in the middle of the
  399.      screen.  In this selection you can choice to print a copy of the
  400.      registration form, or cancel the selection.  If you select no, another
  401.      window will ask if you would like to view the registration form.
  402.  
  403.      Selecting "MAIN MENU" has the same effect as the right mouse button or
  404.      pressing the ESC key on your keyboard.  "MAIN MENU" will appear on all of
  405.      the menus and operate as described here.
  406.  
  407.      Selecting "Quit" will bring up a box to make sure you want to quit, at
  408.      which time you can select "Yes", "No", or "Cancel".  No and Cancel have
  409.      the same effect, leaving you in the program.  If you press the ESC button
  410.      from the main menu, it will be the same as selecting "Quit" in that it
  411.      will bring up the "Yes"/"No" box.
  412.  
  413.  
  414.      QUIZZING
  415.  
  416.      When you select "Quizzing" from the main menu, you will see the following
  417.      selections appear directly below it.
  418.  
  419.           STATES
  420.           CAPITALS
  421.           MAIN MENU
  422.  
  423.      When you select either "STATES" or "CAPITALS" a box will appear and ask
  424.      you if you would like to see how long the answer is?  When you have
  425.      selected "Yes" or "No" ("Cancel" will return you to the main menu) a box
  426.      will appear asking you to enter the "STATE" or "CAPITAL".  If you have
  427.      selected "Yes" to the question earlier, you will have a box that is only
  428.      as long as the answer.  When the cursor disappears, you have entered
  429.      something as long as the box.  When you complete the test or if you press
  430.      ESC a box will appear showing you the high scores.  If you have finished
  431.      the test and your score is better than one of the ones currently in the
  432.      high score list, a box will pop up and ask you for your name.  You will be
  433.      added to the list of high scores. 
  434.  
  435.      The top 10 high scores are held on disk in a file called SCORES.DAT, if
  436.      you wish to clear the top 10, simply delete this file.  The program will
  437.      create another one the next time you load the program, and all of the
  438.      scores will be cleared.
  439.  
  440.  
  441.      STATE INFO
  442.  
  443.      If you select "State Info" from the main menu, you will see the following:
  444.  
  445.           SELECT STATE
  446.           DISPLAY INFO
  447.           MAIN MENU 
  448.  
  449.      If you have a mouse you can select a state simply by pointing at it and
  450.      clicking the left mouse button.  Or, if you want to select a state from
  451.      the text mode, you can highlight SELECT STATE.  This will take you back to
  452.      text mode and let you select a state.
  453.  
  454. STATE INFO selection (continued)                                        Page 8
  455.  
  456.      Once you have selected a state, you can select DISPLAY INFO to get more
  457.      information on that state.  When you do, the map will disappear and a
  458.      block out of the map, with your state selected will appear just below the
  459.      word "Menu...", clicking on the word will bring up a menu of the
  460.      selections listed below.  Just below the word "Menu..." will the states
  461.      name and capital.  The location of the capital will be highlighted in
  462.      yellow.  The following selections are available from the point:
  463.  
  464.                POPULATION 1960-1990
  465.                POPULATION DISTRIBUTION
  466.                STATE SIZE
  467.                CRIME STATISTICS
  468.                TRIVIA / INDUSTRIES
  469.                BIRTHS / DEATHS
  470.                MARRIAGE / DIVORCE
  471.                CLOSE THIS MENU
  472.                RETURN TO MAIN MAP
  473.  
  474.      Each one of these (except TRIVIA / INDUSTRIES) will display both a graph
  475.      of relevant information and the actual data that was used to create the
  476.      graph.  For example if you select POPULATION DISTRIBUTION, two graphs will
  477.      appear to the right of the menu/mini-map.  The first one will display the
  478.      break down between the races, (White, Black, Indian, Asian, Other) and the
  479.      other will show the percentage of those with a Hispanic origin.  All of
  480.      the data will appear below the mini-map.  
  481.  
  482.      When you select TRIVIA/INDUSTRIES, there will be no graphs, but instead
  483.      text of the following information:  State Name Origin, Motto, Bird,
  484.      Flower, Song, Date admitted into the Union, Nickname, Tree, Climate,
  485.      Industries, Manufactured Goods, & Tourist Information.
  486.  
  487.      Selecting CLOSE THIS MENU will simply make the menu disappear so that what
  488.      is behind it can be viewed easier.
  489.  
  490.      When you are ready to return to the main map, RETURN TO MAIN MAP will take
  491.      you there immediately.
  492.  
  493.  
  494.      GRAPH
  495.  
  496.      Upon selecting GRAPH, you will see a menu with the following selections:
  497.  
  498.           SELECT AREA
  499.           RE-DRAW MAP
  500.           MAIN MENU
  501.  
  502.      If you choose Select area, you will be returned to text mode to select an
  503.      area to graph, this area is quite long and includes most of the
  504.      information found under state info.  When you select an area to be
  505.      graphed, the program will redraw the map and fill in each of the states
  506.      according to the legend in the bottom left of the screen.  When it has
  507.      finished highlighting all of the states, a box will pop up in the lower
  508.      right with the words "Clear Map", you cannot go on until you select OK,
  509.      and then the map will be cleared and you will return to the main menu.
  510.  
  511.      Selecting RE-DRAW MAP will simply make the computer redraw the map.  It
  512.      was placed as a precautionary step in the event that the map was somehow
  513.      messed up.
  514.  
  515.  
  516. VERSION HISTORY                                                         Page 9
  517.  
  518.      Version 1.00
  519.  
  520.      This version was used as a Beta test, and was never released for public
  521.      consumption.
  522.  
  523.      Version 1.02
  524.  
  525.      First public release.  This was the first version to pass Beta testing and
  526.      was released to the public in late 1991.
  527.  
  528.      Version 1.10
  529.  
  530.      User interface improvements.   Bug in ESC sequence removed.  Graphics
  531.      library (BGI) replaced with Genus (GX, GR, PCX) libraries.  Font changes,
  532.      move from 8x8 font to 8x14 (EGA) and 8x16 (VGA).  Additional graphics
  533.      added to pre-loading routines.  Map drawn in memory.  Released during the
  534.      second quarter of 1992.
  535.  
  536.  
  537.                     End of Ultimate Geography Documentation
  538.  
  539.  
  540.