home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / road31b.zip / ROADWAYS.DOC < prev    next >
Text File  |  1992-03-19  |  86KB  |  2,135 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                    Roadways PC
  18.  
  19.                            Copyright 1990, 1991, 1992
  20.  
  21.                                  By Doug Fitler
  22.  
  23.  
  24.  
  25.  
  26.                                             _______
  27.                                        ____|__     |               (R)
  28.                                     --|       |    |-------------------
  29.                                       |   ____|__  |  Association of
  30.                                       |  |       |_|  Shareware
  31.                                       |__|   o   |    Professionals
  32.                                     -----|   |   |---------------------
  33.                                          |___|___|    MEMBER
  34.  
  35.  
  36.  
  37.  
  38.  
  39.         SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . . . . . .   1
  40.  
  41.         DISTRIBUTED FILES . . . . . . . . . . . . . . . . . . . . . .   1
  42.  
  43.         INSTALLING ROADWAYS PC ON YOUR COMPUTER . . . . . . . . . . .   2
  44.  
  45.         REGISTRATION  . . . . . . . . . . . . . . . . . . . . . . . .   5
  46.  
  47.         USING ROADWAYS PC . . . . . . . . . . . . . . . . . . . . . .   6
  48.              Controlling Roadways PC with the Keyboard  . . . . . . .   6
  49.              Selecting a City . . . . . . . . . . . . . . . . . . . .   7
  50.              Hint . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  51.              Menu Bar . . . . . . . . . . . . . . . . . . . . . . . .   8
  52.                   File  . . . . . . . . . . . . . . . . . . . . . . .   8
  53.                   Utilities . . . . . . . . . . . . . . . . . . . . .   9
  54.                   Help  . . . . . . . . . . . . . . . . . . . . . . .   9
  55.                   ROADWAYS PC . . . . . . . . . . . . . . . . . . . .   9
  56.                   Quit  . . . . . . . . . . . . . . . . . . . . . . .   9
  57.                   Shortest Distance (or Time) . . . . . . . . . . . .   9
  58.  
  59.         UTILITIES MENU  . . . . . . . . . . . . . . . . . . . . . . .   9
  60.              Mileage Rate Change  . . . . . . . . . . . . . . . . . .   9
  61.              Default Settings . . . . . . . . . . . . . . . . . . . .  11
  62.              Set Home (Starting) City . . . . . . . . . . . . . . . .  11
  63.              Re-run Last Route  . . . . . . . . . . . . . . . . . . .  12
  64.              Toggle Shortest Time/Dist  . . . . . . . . . . . . . . .  12
  65.  
  66.         ROUTE SCREEN  . . . . . . . . . . . . . . . . . . . . . . . .  12
  67.  
  68.         Print . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  69.              Disk Output  . . . . . . . . . . . . . . . . . . . . . .  13
  70.              Mileage Calc.  . . . . . . . . . . . . . . . . . . . . .  14
  71.              Quit . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  72.              Space Bar to Continue  . . . . . . . . . . . . . . . . .  14
  73.  
  74.         CONTROLLING ROADWAYS PC WITH A MOUSE  . . . . . . . . . . . .  14
  75.              [Yes/No] PROMPTS . . . . . . . . . . . . . . . . . . . .  15
  76.              Using the Mouse on the Route Screen  . . . . . . . . . .  15
  77.  
  78.         QUITTING ROADWAYS PC  . . . . . . . . . . . . . . . . . . . .  15
  79.  
  80.         COMMAND LINE SWITCHES . . . . . . . . . . . . . . . . . . . .  16
  81.  
  82.         ENVIRONMENT USE . . . . . . . . . . . . . . . . . . . . . . .  16
  83.  
  84.         ADDING CITIES TO ROADWAYS PC  . . . . . . . . . . . . . . . .  17
  85.              Different Kinds of Roads . . . . . . . . . . . . . . . .  20
  86.              Things to Keep in Mind . . . . . . . . . . . . . . . . .  21
  87.              The City Sorter  . . . . . . . . . . . . . . . . . . . .  21
  88.              Common Pitfalls When Adding cities . . . . . . . . . . .  22
  89.  
  90.         TROUBLESHOOTING PROBLEMS WITH ROADWAYS PC . . . . . . . . . .  22
  91.  
  92.         A NOTE ABOUT THE WINDOWS IN ROADWAYS PC . . . . . . . . . . .  24
  93.  
  94.         UPGRADING ROADWAYS PC . . . . . . . . . . . . . . . . . . . .  24
  95.  
  96.         BACKGROUND ON ROADWAYS PC . . . . . . . . . . . . . . . . . .  24
  97.  
  98.  
  99.  
  100.  
  101.         ABOUT THE AUTHOR  . . . . . . . . . . . . . . . . . . . . . .  25
  102.  
  103.         ABOUT ROADWAYS PC . . . . . . . . . . . . . . . . . . . . . .  26
  104.  
  105.         DISCLAIMER  . . . . . . . . . . . . . . . . . . . . . . . . .  27
  106.  
  107.         ASSOCIATION OF SHAREWARE PROFESSIONALS OMBUDSMAN POLICY . . .  28
  108.  
  109.         SUMMARY OF CHANGES  . . . . . . . . . . . . . . . . . . . . .  29
  110.  
  111.         INVOICE . . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                    ROADWAYS PC
  120.                                Release Version 3.1
  121.                                  By: Doug Fitler
  122.                                  Copyright 1992
  123.  
  124.              Roadways PC is an easy to use program to help you find the
  125.         shortest route from one city to another.  It fully supports
  126.         either a mouse or keyboard entry and will work on any IBM PC/PC-
  127.         XT, AT or compatible computer with MS-DOS 2.11 or newer.
  128.              Roadways is distributed as Shareware and as such is free to
  129.         be copied, passed on and uploaded to any computer service or
  130.         bulletin board.  After a trial period, it is expected that the
  131.         user will register his or her copy if it is going to continue to
  132.         be used.
  133.              Registration has many advantages.  You will not only be
  134.         assured of having the most up-to-date copy of Roadways PC, you
  135.         will also get free technical support and a subscription to the
  136.         Roadways Times, a newsletter produced just for the registered
  137.         users of Roadways PC.  Also you will be able to by-pass the
  138.         opening copyright screen as well as having access to the Roadways
  139.         PC support conference on the Missing Link BBS.
  140.              If you have a modem, you may get the latest news and version
  141.         of Roadways PC as well as technical help by calling the Missing
  142.         Link bulletin board at (618)233-6982, 1200 to 9600 baud, 8 bits,
  143.         No parity and 1 stop bit (i.e. - 2400, N, 8, 1), and [J]oin the
  144.         Roadways conference, number 5.  Whenever any new datafiles,
  145.         suggestions or hints come in from other registered users, they
  146.         too will be posted here for other Roadways PC users to use.
  147.              To register your copy, see the registration form at the end
  148.         of this documentation.
  149.  
  150.         SYSTEM REQUIREMENTS
  151.  
  152.              Here are the requirements for running Roadways PC on your
  153.         computer:
  154.  
  155.         An IBM PC/XT/AT/286/386/486 or compatible computer 
  156.         Minimum 384K of RAM
  157.         Any type display (Monochrome, CGA, EGA, VGA, etc.)
  158.         One Floppy Drive (any size or density) (Hard drive recommended)
  159.         Microsoft or Logitech Compatible Mouse or Trackball (Optional)
  160.         Printer (Optional)
  161.  
  162.         DISTRIBUTED FILES
  163.  
  164.              Your copy of Roadways PC should include the following files. 
  165.         If it does not, please contact the author with information about
  166.         where your copy came from, so a good copy of Roadways can be sent
  167.         to both you and your source.  This will ensure everyone will have
  168.         a complete copy of Roadways PC, with all of its features intact.
  169.              When you pass a copy of Roadways PC on to your friends or
  170.         upload it to a computer bulletin board, remember to NOT include
  171.  
  172.                                         1
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.         the file ROADWAYS.CFG.  This is the configuration file that was
  181.         created on YOUR computer and may cause other folks problems if
  182.         they use it.  When they run Roadways for the first time, a new
  183.         configuration file will be created.
  184.  
  185.         ROADWAYS.EXE ----------- The main Roadways PC program file
  186.         ROADWAYS.DAT ----------- The text file containing the city data
  187.         ROADWAYS.DOC ----------- This documentation file
  188.         ROADWAYS.STA ----------- Data sorted by State
  189.         ROADWAYS.CTY ----------- Data sorted by City
  190.         ROADWAYS.TIM ----------- Data for the shortest time routes
  191.         PRINTDOC.BAT ----------- Documentation Printer File
  192.         INSTALL.EXE  ----------- Roadways PC installation program
  193.         README.DOC ------------- Special information not in the manual
  194.  
  195.         INSTALLING ROADWAYS PC ON YOUR COMPUTER
  196.  
  197.              Installing Roadways PC is very simple.  You may install
  198.         Roadways PC to either a floppy disk or to your hard disk if you
  199.         have one.  If you are upgrading from an earlier version, please
  200.         go to page 15 and perform the procedures in the section entitled,
  201.         UPGRADING ROADWAYS PC.  
  202.              If you try to run Roadways PC without first running the
  203.         INSTALL program, Roadways will remind you.  You will see a screen
  204.         that informs you that Roadways PC has not been configured for
  205.         your system.  At this point, Roadways will end and you can run
  206.         INSTALL to configure the program.
  207.  
  208.              To install Roadways PC, all you need to do is follow these
  209.         instructions:
  210.  
  211.         1.  Insert the disk containing Roadways PC into your disk drive.
  212.  
  213.         2.  Type INSTALL and press <enter>.
  214.  
  215.         3.  You should now see a menu that gives you the option to do one
  216.         of four things:
  217.  
  218.              1 - Install or change installation of Roadways PC
  219.              2 - Register your copy of Roadways PC
  220.              3 - Run Roadways PC
  221.              4 - Exit this program
  222.  
  223.         Select option 1.
  224.  
  225.         4.  Next, you will be asked if you wish to make a backup of your
  226.         Roadways PC program disk.  If you answer Y to this question, you
  227.         will be exited from INSTALL so you can use DISKCOPY to back up
  228.         your original disk.  If you answer N to this question, you will
  229.         be allowed to continue with the installation procedure.
  230.  
  231.  
  232.  
  233.                                         2
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.         5.  Next the question "Do you want to install Roadways now?" is
  242.         asked.  This is just to make sure you really do want to install
  243.         Roadways, and is only to give you a chance to change your mind
  244.         (although you really should go ahead and install it!).
  245.  
  246.         6.  Now you will be asked if you wish to install Roadways PC onto
  247.         a Hard drive.  If you answer Y to this question:
  248.  
  249.              a.  You will be asked if the subdirectory C:\ROADWAYS
  250.              is where you want Roadways installed.  If you want
  251.              Roadways installed in a sudirectory on drive C: called
  252.              ROADWAYS, type Y. 
  253.              b.  You can enter a different drive and subdirectory if
  254.              you want.  Just enter the letter of the drive you want
  255.              Roadways installed to, and when asked for the
  256.              subdirectory name, type in any legal DOS name.
  257.              c.  The subdirectory will be created on the specified
  258.              drive and Roadways will install (or copy) itself into
  259.              that subdirectory.
  260.  
  261.         7.  The next question asks if you have a color monitor.  If you
  262.         have any type of color monitor and card, type Y.  If you have a
  263.         monochrome or Hercules display of any type, type N.  If you typed
  264.         N, you will be asked if you have a Hercules video adapter or
  265.         display.  Answer Y if you have a Hercules card, N if you don't.
  266.              If you answer N to the Hercules question, and get either an
  267.         error when you try to run Roadways or the screen stays blank, try
  268.         re-running INSTALL and selecting Y for Hercules.
  269.  
  270.         8.  The next question asks if you want Roadways PC to calculate a
  271.         mileage reimbursement cost per mile.  This option is primarily
  272.         designed for folks that get reimbursed for their mileage on
  273.         business trips, although it has other uses as well, such as
  274.         calculations for IRS mileage deductions and so forth.  
  275.              Please note, however, that the author of Roadways PC makes
  276.         no claims as to the accuracy of the mileages calculated. 
  277.         Roadways PC is primarily a tool to help you plan your trip, and
  278.         as such should not be used when accuracy is important.
  279.              If you want Roadways PC to calculate a cost per mile, simply
  280.         type 'Y'.  Next you will be asked for the mileage rate.  This is
  281.         the amount per mile you want Roadways PC to use.  You must enter
  282.         this number as a decimal.  For example, if you want to use 24
  283.         cents per mile as the rate, type .24 and hit <enter>.
  284.              Don't worry if the amount you want to use changes later, as
  285.         you can easily update it from within Roadways PC.
  286.  
  287.         9.  Next, you will need to choose the type of printer you have. 
  288.         Simply select your printer from the list.  You will notice that
  289.         this list is very general.  This is because the options differ
  290.         only in the characters that are printed from the trip route
  291.         screen.  If you have a dot matrix or laser printer, it is
  292.  
  293.  
  294.                                         3
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.         probably IBM compatible.  You can tell by looking at the printout
  303.         when you do a route.
  304.              If you selected the IBM, laser or EPSON selections from the
  305.         list, when you print out a route, you should see smooth,
  306.         uninterrupted lines between the headings and the list of cities
  307.         and routes.  If you have a dot matrix printer and you get a bunch
  308.         of letters instead of smooth lines, you will need to change your
  309.         printer dip switches to the IBM character set if there is one on
  310.         your printer.  Otherwise, you'll have to choose option 5 (Other).
  311.              The same applies to other printers, if you see a bunch of
  312.         letters across the page separating the headings and the list of
  313.         cities.  This indicates that you will need to select either
  314.         option 4 or 5.  This will use the '-' and the '=' instead of the
  315.         extended characters.
  316.              If you do not have a printer, it doesn't matter what you
  317.         select, but you must select something!
  318.  
  319.         10.  The next questions are to establish the average speed you
  320.         want used for calculating driving times.  By default, Roadways
  321.         will use 55 mph for roads with a 65 mph speed limit and 45 for
  322.         all other roads.
  323.              With this release of Roadways PC, changes were made to
  324.         handle states with the lower 55 mph speed limit on interstates. 
  325.         As a result, the times for the eastern seaboard states are much
  326.         more accurate.
  327.              Just by way of explanation, the 55 and 45 mph averages were
  328.         chosen as the defaults based on quite a few tests with several
  329.         different users.  Although most people are absolutely certain
  330.         they average 70 mph in 65 mph areas, all but a VERY few actually
  331.         average much over 60.  If you have a family, 55 may be a little
  332.         high on many trips, but most folks were surprised at how close
  333.         these numbers came to their actual driving times.
  334.              This option was added for those 'out-of-the-ordinary' folks
  335.         that drive either faster or slower than the average person.  To
  336.         accept the default speeds of 55 and 45 mph, just hit <enter> to
  337.         both of the questions.  To enter your own speeds, simply type the
  338.         numbers in.  Decimals and letters are not allowed, only numbers,
  339.         and the range can be from 0 up to ludicrous speed!
  340.  
  341.         11.  Now you need to choose the name of the city datafile
  342.         Roadways PC will use.  This is primarily for those folks that
  343.         plan on using or creating datafiles for other countries or to
  344.         cover, in detail, some particular area.
  345.              For the first time user, I suggest just hitting <enter>
  346.         since this will select the datafiles that came with your copy of
  347.         Roadways PC.
  348.              Please note that if you type in the name of a datafile that
  349.         does not exist, Roadways PC WILL NOT RUN!  You will have to re-
  350.         run the INSTALL program to enter the name of an existing
  351.         datafile.
  352.  
  353.  
  354.  
  355.                                         4
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.         12.  Now, Roadways PC will create a file called ROADWAYS.CFG
  364.         which will contain the configuration information for your
  365.         computer.  This file will be put in the subdirectory where you
  366.         installed Roadways or on the floppy disk if you did not put it on
  367.         a hard disk.
  368.  
  369.                                    << Note >>
  370.  
  371.              If you have configured Roadways PC for your computer,
  372.              and wish to pass Roadways along to someone else, please
  373.              do not copy the ROADWAYS.CFG file onto their disk. 
  374.              Also, do not include it in an archive or zip file, as
  375.              it may cause problems for the next person who gets the
  376.              copy.  The files that should be included are the ones
  377.              listed above in the section entitled "DISTRIBUTED
  378.              FILES".
  379.  
  380.         13.  Now the Installation program is complete.  You will be
  381.         returned to the main menu, and if you are a registered user, you
  382.         will have the option to fully register your copy of Roadways PC.
  383.  
  384.         REGISTRATION
  385.  
  386.              If you are a registered user of Roadways, you may bypass the
  387.         copyright screen that appears on bootup.  If you are already at
  388.         the INSTALL program main menu, skip to step 3.
  389.              To configure your system to by-pass the copyright screen,
  390.         follow these steps:
  391.  
  392.         1.  Insert your Roadways PC disk into your computer or go to the
  393.         subdirectory on your hard drive that contains the Roadways PC
  394.         program.
  395.  
  396.         2.  Type INSTALL <enter>.
  397.  
  398.         3.  Select option 2 from the menu, Register Roadways PC.
  399.  
  400.         4.  You will be asked for the code that was in the registration
  401.         letter that was sent to you by the author.  Enter that code and
  402.         hit <enter>.
  403.  
  404.         5.  If all has gone well, you will see a short message about
  405.         registration.  Press any key to return to the main menu, and you
  406.         should be able to select option 3 from the main INSTALL menu to
  407.         run Roadways PC.  It should now start up without the Copyright
  408.         screen.
  409.  
  410.              If at any time you should start seeing the registration
  411.         screen again, you will need to re-run this option.  This can
  412.         happen if you ever accidentally (or intentionally) delete your
  413.         ROADWAYS.CFG file.
  414.  
  415.  
  416.                                         5
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.         USING ROADWAYS PC
  425.  
  426.              Roadways PC is designed to be simple to use.  If you have a
  427.         mouse that is 100% Microsoft compatible (i.e. - Microsoft,
  428.         Logitech, Dexxa, etc.) and the driver is loaded, Roadways PC will
  429.         detect that it is present and display a Mouse cursor whenever
  430.         appropriate.
  431.              Once you have Roadways PC properly configured, the program
  432.         will load and run, presenting you with a copyright notice if you
  433.         are not a registered user.  To exit this screen, simply press any
  434.         key or left mouse button or wait for about 5 seconds.
  435.              At this point, Roadways PC will check to make sure you have
  436.         all of the necessary data files and if not, it will attempt to
  437.         create them.  The most important file of all is the file
  438.         ROADWAYS.DAT.  Without this file, Roadways PC will not run.  The
  439.         other three data files, ROADWAYS.CTY, ROADWAYS.STA and
  440.         ROADWAYS.TIM are created from the ROADWAYS.DAT file, so if they
  441.         are missing, Roadways PC can still run.  However, before it will
  442.         work, it must create the missing files.  
  443.              If for some reason, any of the sorted data files is missing,
  444.         Roadways PC will inform you of this and then it will proceed to
  445.         create the files, save them and then run Roadways PC.  This
  446.         should be an almost automatic action requiring no input from you
  447.         other than pressing a key to go on.
  448.              During the creation of the datafiles, you will notice a
  449.         small box on the bottom of center of the screen with an arrow
  450.         inside that changes direction.  This is just to let you know that
  451.         something is going on and that your computer hasn't locked up.
  452.              Once Roadways has loaded and made sure all of the required
  453.         files are present, it will begin loading the city data in.  You
  454.         will see two lines in the lower portion of the screen that look
  455.         like this:
  456.  
  457.         Counting to: 
  458.         City Number: 
  459.  
  460.              The first line indicates the number of cities in the
  461.         database.  The second line will count up until it matches the
  462.         first line.  The purpose of this is just to let you know that
  463.         something is going on, and that your computer hasn't locked up.  
  464.              When the two numbers match, you will be presented with a
  465.         choice of having the cities sorted either Alphabetically by city
  466.         or Alphabetically by state.  Press either 'C' or 'S' or use the
  467.         mouse to click anywhere on the word 'City' or 'State'.
  468.  
  469.         Controlling Roadways PC with the Keyboard
  470.              You should now be at the main program screen.  Down the left
  471.         side there should be a list of cities, arranged either by state
  472.         or by city, depending on your choice earlier, with the top choice
  473.         highlighted.
  474.              At the bottom, you will see a block with two choices,
  475.         labeled NEXT PAGE and PREVIOUS PAGE.  This block is for the Mouse
  476.  
  477.                                         6
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.         user only.  It can, however, help you remember the proper keys to
  486.         use.  The first letter of each of the commands is highlighted. 
  487.         Pressing any of these keys will do what the function says.
  488.              If you have a mouse, see the section on Controlling Roadways
  489.         PC with a Mouse for more information on their use.
  490.              Pressing any unassigned keys (say for instance the 'H' key)
  491.         will cause the Key Help block to appear just above this Mouse
  492.         block, and provides you with the functions of all of the keys
  493.         that can be used at this point in the program.
  494.              Toward the top, you will see a block with the prompt:
  495.  
  496.         Select Starting City
  497.  
  498.         You do this by using the following keys:
  499.  
  500.         Up Arrow Key --------------------- Move up the list
  501.         Down Arrow Key ------------------- Move down the list
  502.         PgUp key (or P key) -------------- Go to Previous Page
  503.         PgDn key (or N key) -------------- Next Page
  504.         Home key ------------------------- Go to the First Page
  505.         End Key -------------------------- Go to the Last Page
  506.         Enter Key ------------------------ Select a city
  507.         ALT Key -------------------------- Activate the menu bar
  508.         Q key ---------------------------- Quit Roadways PC
  509.         R key ---------------------------- Re-run the last route
  510.         D key ---------------------------- Retrieve saved routes
  511.         M key ---------------------------- Change the Mileage Rate
  512.         Any other key -------------------- Key help window
  513.  
  514.              If you have problems remembering what keys do what, just
  515.         press a key that is not on this list ('H' for example), and you
  516.         will be presented with a window that shows the primary key
  517.         commands for Roadways PC.  To clear the window, just press
  518.         <enter>, space bar or ESC.
  519.  
  520.         Selecting a City
  521.              To select a city, simply use the arrow keys to move the
  522.         highlighted area over the city you want, then press <enter>.  If
  523.         you do not see the city you are looking for on the screen, press
  524.         the PgUp (or P) or PgDn (or N) keys to flip through the 'pages'
  525.         of cities until you locate the city you are looking for.
  526.              Once you have selected a Starting City, you will notice that
  527.         the block at the top right now says:
  528.  
  529.         Select Ending City
  530.  
  531.              Also, you will see a block just below that block which now
  532.         indicates what city you chose as the starting city, and is
  533.         waiting for you to choose the ending city. 
  534.              Repeat the above procedure to select the ending or
  535.         destination city, and again press <enter>.  Now you will notice
  536.         that the window that contains the starting city also displays the
  537.  
  538.                                         7
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.         ending city along with a prompt for you to decide if these are
  547.         correct.  If so, type either 'Y' or press the <enter> key.  If
  548.         not, type 'N', and you will be able to re-select both the
  549.         starting and ending cities.
  550.              If the starting city and ending city are the same, Roadways
  551.         PC will clear the block and tell you to select the starting city
  552.         again.
  553.              Once you type 'Y', you will see a small square toward the
  554.         top of the screen that is labeled:
  555.  
  556.         Miles:
  557.  
  558.              You will see numbers count up, as Roadways PC calculates the
  559.         total mileage to the destination.  As before, this is put on the
  560.         screen mostly to let you know something is happening, since on a
  561.         slower computer, the route can take longer to complete although
  562.         it is still more than 5 times faster than my closest competitor! 
  563.         This is especially true of long, coast-to-coast routes.
  564.  
  565.         Hint
  566.              The Re-Run button (or the 'R' key or the 'Re-run last route'
  567.         option on the Utilities Menu) can be used to quickly change the
  568.         starting city while not changing the ending city (sort of the
  569.         opposite of the default starting city option!).
  570.              After running a route, go select a new starting city, then
  571.         click on 'Re-Run' or press the 'R' key.  The route will be run
  572.         with the new starting city, but with the same ending city you
  573.         used previously.
  574.  
  575.         Menu Bar
  576.              Pressing and releasing the ALT key will toggle the menu bar
  577.         at the top of the screen.  From these menus you can perform many
  578.         of the functions that are also available from the hot keys, such
  579.         as retrieving saved routes and exiting Roadways PC.  The options
  580.         on the menu are as follows:
  581.  
  582.         File
  583.         This option lets you retrieve saved routes from disk.  You will
  584.         be asked for the drive and directory name of the directory
  585.         containing your Roadways PC route files.  If you have saved the
  586.         route files in the same directory and drive that has Roadways PC,
  587.         all you have to do is press <enter> .
  588.              If there are no route files in the default directory or the
  589.         directory you specify, Roadways will tell you and give you the
  590.         option of entering a different drive and directory or you can
  591.         press 'R' to return to the main city selection screen. 
  592.              If there are files with an .RDW extension in the directory,
  593.         you will see a directory of all these files on the screen, and a
  594.         prompt asking which file you want to retrieve.  Just type in the
  595.         name of the route file (with or without the extender.  It doesn't
  596.         matter.) and press <enter>.
  597.  
  598.  
  599.                                         8
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.              You should now see the route just as you saved it.  At this
  608.         point you may elect to do one of the following:
  609.  
  610.         PRINT - Print the route you just retrieved
  611.  
  612.         MORE - Retrieve another route
  613.  
  614.         RETURN TO ROADWAYS PC MAIN - Return to the City Selection screen
  615.  
  616.              Simply press the first letter of the option you want and do
  617.         what Roadways PC tells you.
  618.  
  619.         Utilities
  620.         Here you can change the mileage rate, default settings, choose a
  621.         default starting city, re-run the last route or toggle using
  622.         either the shortest time or shortest distance calculations.
  623.  
  624.         Help
  625.         This brings up the same window as pressing an unassigned key
  626.         (i.e. - H or F1).
  627.  
  628.         ROADWAYS PC
  629.         This will bring up the introductory Copyright screen that
  630.         registered users get to by-pass.  This is just for your own
  631.         informational purposes.
  632.  
  633.         Quit
  634.         Allows you to quit Roadways PC.
  635.  
  636.         Shortest Distance (or Time)
  637.         This is just a status indicator and cannot be selected.  This is
  638.         where you can tell if you have selected to have a route run in
  639.         the shortest distance or the quickest time.
  640.  
  641.         For more information on the options in the Utilities section, see
  642.         the next chapter.
  643.  
  644.         UTILITIES MENU
  645.  
  646.              The Utilities Menu contains many different options to allow
  647.         you to customize your Roadways PC.  Here are the functions of the
  648.         different items on the menu:
  649.  
  650.         Mileage Rate Change
  651.              This option is used to change the mileage rate used to
  652.         calculate driving costs.  Here you will have 4 options:
  653.  
  654.         1) Calculate actual cost per mile based on price of gasoline
  655.              This option allows you to come up with a pretty accurate
  656.         assessment of the gasoline cost on a trip.  You will be asked for
  657.         the price of a gallon of gasoline.  Enter it like so:  1.089
  658.  
  659.  
  660.                                         9
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.         would indicate a price of one dollar, eight point 9 cents per
  669.         gallon.
  670.              You will also be asked for the gas mileage of your vehicle. 
  671.         This should be entered in miles per gallon.
  672.              For example, if gasoline was a dollar eight point 9 and your
  673.         car got 30 miles per gallon, you would enter the following to the
  674.         first question:  1.089 <enter>   and the following to the second
  675.         question:  30 <enter>.
  676.              Roadways PC is accurate to 2 decimal places on cost per mile
  677.         to operate your vehicle.  For the above example, you would find
  678.         that the cost to operate your vehicle for one mile would be 3.63
  679.         cents.  This takes into account only the cost of the gasoline and
  680.         not wear and tear on you car.
  681.  
  682.         2) Calculate cost per mile on a cents per mile rate
  683.              Use this option if you want to calculate a cost per mile
  684.         based on a set per mile rate.  For example, if you get reimbursed
  685.         by your company at the rate of .24 cents per mile, you would
  686.         select this option.
  687.              You will be asked what rate per mile you want to use.  You
  688.         must enter this amount as a decimal number.  For example, if you
  689.         get 24 cents per mile, you would enter .24 and press <enter> . 
  690.         If you forget the decimal, Roadways PC will remind you and give
  691.         you some instructions.
  692.  
  693.         3) Don't do a mileage calculation
  694.              This will turn off the mileage rate calculations.  If you
  695.         select this option, you will not have the mileage rates displayed
  696.         on the route screen or on your printout or disk save.
  697.  
  698.              If you selected one of the first 3 options, you are asked if
  699.         you want to save this rate to disk for permanent use in Roadways
  700.         PC.  If you do, press 'Y', if not, press 'N'.
  701.              If you pressed 'N', you will be asked if the amount
  702.         calculated is correct.  If it is, press 'Y' and you will be
  703.         returned to Roadways PC and that rate will be used until you exit
  704.         Roadways PC, or change it.
  705.              If the rate calculated is not the one you want used for
  706.         routes, press 'N' and you will then be asked if you want a
  707.         mileage rate calculation done.  If you answer 'N' to this
  708.         question, there will be no mileage rate calculations on your
  709.         routes, until the end of the current Roadways PC session or until
  710.         you change it again by pressing 'M' at the City Selection screen.
  711.  
  712.         4) Return to Roadways with no changes
  713.              This option does just what it says.  If you select this
  714.         option, you will be returned to the main city selection screen,
  715.         with the last selected mileage rate in use.
  716.  
  717.              As with most of the other screens in Roadways PC, this
  718.         screen also supports a mouse.  The mouse cursor will appear when
  719.         it can be used.
  720.  
  721.                                        10
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.         Default Settings
  730.              Next on the Utilities menu is the option to change the
  731.         default settings of Roadways PC.  Once you select this item, you
  732.         can change any of the following items:
  733.  
  734.         1 - Printer type - You can choose any of 5 options for the type
  735.         of printer you have.
  736.  
  737.         2 - Display type - Choose color, monochrome or Hercules displays.
  738.  
  739.         3 - City datafile name - Choose the datafile Roadways will use. 
  740.         This is of special importance to folks that want to use datafiles
  741.         for other countries or specific files for a particular state or
  742.         region.  These datafiles must be created by users and some have
  743.         already been made, and are available on the Roadways PC support
  744.         bulletin board.  See the beginning of this document for more
  745.         information on the support BBS.
  746.  
  747.         4 - Change default speed used to figure driving times - This
  748.         option lets you change the speeds used to figure the estimated
  749.         driving times on the final route.  If you change anything here,
  750.         please note that upon exiting back to Roadways PC (by menu option
  751.         5) the driving time file will be re-created to reflect your
  752.         changes.  However, in order for these changes to take effect, you
  753.         must re-start Roadways.  For this reason, I recommend using
  754.         option 6 after changing things here.
  755.  
  756.         5 - Go back to Roadways PC - Lets you return to Roadways PC
  757.         without using the changes you have selected.  The changes will be
  758.         saved to the ROADWAYS.CFG file, but until Roadways is re-started,
  759.         they will not take effect.
  760.  
  761.         6 - Re-start Roadways PC - This will reload and run Roadways PC
  762.         to enact any changes you have made to the defaults.
  763.  
  764.         7 - Get help - This option will bring up a screen of helpful
  765.         information about each of the options.
  766.  
  767.              The Set Defaults options work just like their counterparts
  768.         in the INSTALL program, so if you have questions or problems,
  769.         take a look back at the section of this manual called 'Installing
  770.         Roadways PC on your Computer'.
  771.              The Mouse is fully functional on these screens as in most of
  772.         Roadways PC.
  773.              When you select the option to return to Roadways, the
  774.         options you have changed will be saved to the ROADWAYS.CFG file,
  775.         providing you made changes.
  776.  
  777.         Set Home (Starting) City
  778.              If you are going to run several routes all from the same
  779.         starting point, you can save quite a bit of time by setting that
  780.         city as the default starting city.
  781.  
  782.                                        11
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.              When this option is selected, you will be taken to the main
  791.         city selection screen.  You will notice that just below the menu
  792.         bar, will be a prompt telling you to select the default starting
  793.         city, or press zero to for no default starting city.  
  794.              You can use the cursor keys or mouse to select the city you
  795.         wish to be the default starting city.  Once you choose it, a
  796.         block will appear showing the starting city and you will only
  797.         need to choose the ending city.  All routes run after selecting
  798.         this will ask for only the ending city.
  799.              This option will only be active until you leave Roadways PC
  800.         or go back into the 'Set Home (starting) City' selection and
  801.         press '0'.  This will turn off the default selection and you will
  802.         be able to choose both the starting and ending cities as usual.
  803.  
  804.         Re-run Last Route
  805.              This is a very handy feature if you are wanting to make
  806.         several comparisons using different re-imbursement figures for
  807.         mileage or want to see if there is a difference in fastest time
  808.         versus shortest distance.  Selecting this option will re-use the
  809.         last selected starting and ending cities.
  810.              This is the same as pressing 'R' or clicking with your mouse
  811.         on the 'Re-Run' button on the main screen.
  812.  
  813.         Toggle Shortest Time/Dist
  814.              This option allows you to decide whether you want the
  815.         fastest route or the shortest.  In most cases, the two are the
  816.         same, but if there are a lot of county roads, state roads or
  817.         passage through a state with a 55 mile per hour speed limit, the
  818.         times could vary quite a bit.
  819.              You may find that a route is quicker when you take a
  820.         slightly longer (mileage wise) drive because of the speed limits.
  821.              Selecting this option will toggle the calculation to either
  822.         the shortest (quickest) time or the shortest distance (the
  823.         default).  You can tell which is currently selected by looking at
  824.         the upper right hand corner of the screen, in the menu bar.
  825.              Due to routes being slightly different based on whether you
  826.         start in a 65 mph zone or 55 mph zone, when you select this
  827.         option, the route is actually run from both directions.  The one
  828.         problem with this is that you could wind up with the route being
  829.         opposite in direction from the one you want in direction.
  830.              For example, run a route from Washington, D.C. to St. Louis,
  831.         Mo. with the shortest time option activated.  You'll find that
  832.         the route displayed shows from St. Louis to Washington.  This can
  833.         be somewhat confusing and I hope to be able to fix this soon.
  834.  
  835.         ROUTE SCREEN
  836.  
  837.              Once the route is complete, the screen will clear and the
  838.         route will be displayed.  At the bottom of the screen, below the
  839.         block containing your options, is a line indicating the speeds
  840.         you selected for time calculations.
  841.  
  842.  
  843.                                        12
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.              If you chose the defaults of 55 and 45 Mph, the line will
  852.         look like this:
  853.  
  854.         Interstates = 55 Mph and Non-Interstates = 45 Mph
  855.  
  856.              Please note that in states with a maximum interstate speed
  857.         of 55 Mph, the lower number will be used.  For example, in
  858.         Pennsylvania, the maximum interstate speed is 55 Mph, so the
  859.         speed used for all time measurements is going to be the lower
  860.         one, or in this case, 45 Mph.
  861.              Let's take a look at the five options in the block at the
  862.         bottom of the screen:
  863.  
  864.         1.  Press 'P' to print the route out to your printer.
  865.  
  866.         2.  Press 'O' to save the route to disk.
  867.  
  868.         3.  Press 'M' to see Mileage information if it is enabled.
  869.  
  870.         4.  Press 'Q' to Quit Roadways PC completely.
  871.  
  872.         5.  Press the Spacebar to do another route.
  873.  
  874.         Print
  875.              You may print the route out as many times as you wish. 
  876.         Simply press 'P' for each copy you want.  When you are done
  877.         printing, you may either quit or run another route.
  878.              A help menu is available on this screen as well.  To
  879.         activate it, press any key not highlighted on the screen in a
  880.         command box.  I recommend either 'H' or 'F1' since these are the
  881.         normal help commands in other programs, but any unassigned key
  882.         will do.  The right mouse button will also turn this screen on. 
  883.              Once the help window is open, you can close it by pressing
  884.         either ESC, <enter> or the space bar, or by clicking in the upper
  885.         left hand corner or on the <CLOSE> spot with the mouse.
  886.              If you calculate a route that is longer than will fit on a
  887.         single screen, you will see two little boxes at the bottom of the
  888.         screen that say Scroll Up and Scroll Down.  By using the arrow
  889.         keys or the U and D keys, you can scroll through the list of
  890.         cities at your leisure.
  891.  
  892.         Disk Output
  893.              Saving routes to disk is very simple.  From the Route sceen,
  894.         press 'O'.  Roadways PC will ask you for a path and filename.  If
  895.         you want to save the route in the same directory as Roadways, all
  896.         you need to do is enter the filename you want your route saved
  897.         under.  Do not enter an extender, only a valid MS-DOS filename of
  898.         eight characters or less.
  899.  
  900.                                   *** Note ***
  901.                   You cannot save any routes under the filename
  902.              ROADWAYS.  Roadways PC will not allow this, since it
  903.  
  904.                                        13
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.              could be possible to overwrite one of the program files
  913.              by accident.
  914.                   Also, if you at any time change the extender from
  915.              .RDW to another, Roadways PC will not be able to find
  916.              the file if you wish to retrieve the route in Roadways
  917.              PC.
  918.  
  919.              All Roadways files are saved with the extender .RDW and are
  920.         simply text files.  There are no special characters or funny
  921.         formatting.  This was done to make it easy for you to read into
  922.         your favorite word processor for inclusion in a letter or
  923.         document you are preparing.
  924.  
  925.         Mileage Calc.
  926.              Selecting this option will open a small window in the middle
  927.         of the screen that displays the mileage calculations if they have
  928.         been enabled.  If you chose not to do mileage calculations, a
  929.         message will be displayed in the box informing you of this.
  930.              If you chose to do mileage calculations, the following
  931.         information will be displayed:
  932.  
  933.              The mileage rate in cents per mile
  934.              The total mileage cost one way
  935.              The round trip mileage cost
  936.  
  937.              As with other windows in Roadways PC, this one can be closed
  938.         by pressing the ESC, <enter> or spacebar keys or by clicking on
  939.         the <CLOSE> spot or upper left corner of the box.
  940.  
  941.         Quit
  942.              This option will end your Roadways PC session.
  943.  
  944.         Space Bar to Continue
  945.              Pressing this will take you back to the main city selection
  946.         screen.  If you haven't printed out your route or saved it to
  947.         disk, it will be lost.  However, if you suddenly realize this has
  948.         happened, before doing anything else, you can select 'Re-run Last
  949.         Route' from the Utilities menu or press 'R' or click on the Re-
  950.         Run button on the main screen to re-run the route with your last
  951.         selected options.
  952.  
  953.         CONTROLLING ROADWAYS PC WITH A MOUSE
  954.  
  955.              Roadways PC is a program that lends itself well to a mouse
  956.         or pointing device.  Use of the mouse is almost intuitive, since
  957.         it makes sense to point at what you want.  This is the philosophy
  958.         around which the mouse interface was designed.
  959.              When you first boot up, after the copyright screen, you are
  960.         presented with a choice of sorting the cities by either city or
  961.         state.  Simply move the mouse cursor to the one you want, and
  962.         click with the left button.  You can click on any part of the
  963.         word, not just the first letter.
  964.  
  965.                                        14
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.              Once at the main menu, the following is the assignment of
  974.         the mouse buttons:
  975.  
  976.         Left Button - Select button
  977.  
  978.         Right Button - Activate the Keyboard help window
  979.  
  980.              As this implies, to choose a city, select a menu item or do
  981.         something in a box that is on the screen, just position the mouse
  982.         cursor over what you want and press the left button.
  983.              To page through the cities, simply go to the boxes at the
  984.         bottom of the screen.  Here is the function of the boxes:
  985.  
  986.         NEXT PAGE - Selects the next page (screen) of cities
  987.  
  988.         PREVIOUS PAGE - Selects the previous page (screen) of cities
  989.  
  990.              By using the mouse cursor and clicking with the left mouse
  991.         button on your selection, you can page through the cities
  992.         effortlessly, and select your starting and ending cities.
  993.              The same thing goes for the other screens.  When you see a
  994.         box with several selections in it, simply click on the word or
  995.         box you want.
  996.  
  997.         [Yes/No] PROMPTS
  998.              When using a mouse, you can answer a yes or no prompt by
  999.         simply putting the mouse cursor over your choice.  For example,
  1000.         after selecting the ending city, you are asked:
  1001.  
  1002.         Is this Correct <[Y]es/No>?
  1003.  
  1004.              To answer yes, position the mouse cursor over the response
  1005.         you wish to make and click the left mouse button.  This is the
  1006.         way to answer all Y/N prompts if you do not want to use the
  1007.         keyboard.  This includes the ones when exiting Roadways.
  1008.  
  1009.         Using the Mouse on the Route Screen
  1010.              The only active mouse areas on the route display screen are
  1011.         in the box at the bottom of the screen.  Here you have the
  1012.         options of either Printing, Disk Output, Mileage display,
  1013.         Quitting or Space bar to continue.  By clicking with the left
  1014.         mouse button on the word with the highlighted letter, you can
  1015.         select that option.
  1016.              Also, if you have a route longer than the screen will
  1017.         display all at one time, you can click in either the Scroll Up or
  1018.         Scroll Down box to scroll the city route display.
  1019.              Again, you do not have to click on the highlighted letter,
  1020.         just anywhere on the word that contains the highlighted letter.
  1021.  
  1022.         QUITTING ROADWAYS PC
  1023.  
  1024.  
  1025.  
  1026.                                        15
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.              To end your Roadways PC session, go to either the main
  1035.         screen (the one that contains the city list) or the route display
  1036.         screen.  You may either press 'Q' or click on the appropriate
  1037.         menu selection with the mouse.
  1038.  
  1039.         COMMAND LINE SWITCHES
  1040.  
  1041.              There are several command line switches available to make
  1042.         loading and running Roadways PC easier and more customizable. 
  1043.         Here are the command line options:
  1044.  
  1045.         /C - Load Roadways and sort the cities in City order for display
  1046.         /S - Load Roadways and sort the cities in State order for display
  1047.         /I - Run the city sorter program (creates ROADWAYS.CTY
  1048.              ROADWAYS.STA, and ROADWAYS.TIM)
  1049.         /? - Provides help on the Command Line switches
  1050.  
  1051.              If at any time you cannot remember what the different
  1052.         switches are, simply type:
  1053.  
  1054.         ROADWAYS /?
  1055.  
  1056.              This will display all the switches available and return you
  1057.         to the DOS prompt.
  1058.              The /C and /S switches speed entry into Roadways PC, by
  1059.         selecting ahead of time, the way you want the cities displayed;
  1060.         whether by city or by state.
  1061.              You will find out more about using the /I switch in the
  1062.         coming section.
  1063.  
  1064.         ENVIRONMENT USE
  1065.  
  1066.              If there is one particular setup you always want to use, you
  1067.         can install it in an environment statement.  You can have up to 3
  1068.         separate environment switches to activate options in Roadways PC. 
  1069.         In reality, if you look at the list of possible command line
  1070.         switches, you will notice that there is really only a need for
  1071.         one switch.
  1072.              The most obvious use for this is to add the capability to
  1073.         have Roadways PC come up with the cities listed either by city or
  1074.         by state.  Here are the options available:
  1075.  
  1076.         SET ROADWAYS =/C    Makes Roadways PC come up sorted by City
  1077.  
  1078.  
  1079.         SET ROADWAYS =/S    Makes Roadways PC come up sorted by State
  1080.  
  1081.              To use one of these, just add the appropriate statement
  1082.         above to your AUTOEXEC.BAT file.  Please note that the command
  1083.         line will override whatever environment switches you choose.
  1084.  
  1085.  
  1086.  
  1087.                                        16
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.              While you can use some of the other command line switches in
  1096.         the environment, I don't recommend it, since Roadways PC will
  1097.         come up with those options selected every time you run it.
  1098.  
  1099.         ADDING CITIES TO ROADWAYS PC
  1100.  
  1101.              Obviously, this program would be of only limited use if it
  1102.         could not be expanded and customized.  Since the initial database
  1103.         is fairly limited, it would be good to be able to add new cities.
  1104.              There are two options for adding cities:  First, you can
  1105.         order the City Editor from the author of Roadways PC for only
  1106.         $10.00.  This is not a shareware program, but it will greatly
  1107.         speed the entry of cities and reduces the possibility of errors.
  1108.              The second option is fairly easy, but does require some
  1109.         planning.  Manually!  Here I will detail the manual method.
  1110.              Before adding your first city, make sure you have the
  1111.         following available:
  1112.  
  1113.         A good road atlas
  1114.         A calculator (to help add up the number of miles)
  1115.         A printout of the datafile ROADWAYS.DAT
  1116.         A backup copy of the datafile ROADWAYS.DAT (VERY IMPORTANT!!!)
  1117.  
  1118.              While I can't help you with the first two, I can help you
  1119.         get a good printout of the data file.
  1120.  
  1121.         1.  Set up your printer and make sure it is on-line.
  1122.         2.  At the DOS prompt, type COPY ROADWAYS.DAT PRN <enter>
  1123.  
  1124.              The data file should now print out.  Be forewarned.  This is
  1125.         a fairly long datafile (more than 5 pages) so make sure you have
  1126.         enough paper!
  1127.              Once you have all of the items at hand, sit down at a table
  1128.         and lay the data file printout out in front of you.  The first 4
  1129.         lines should look something like this:
  1130.  
  1131.         201,8
  1132.         1,ALBANY,NY,5,156,90,146,151,90,85,105,87,88,23,-7,154,14,88,142
  1133.         2,ALBERT LEA,MN,4,87,90,262,94,35,93,147,90,168,47,35,148
  1134.         3,ALBUQUERQUE,NM,4,56,40,323,37,25,365,52,25,257,192,40,114
  1135.  
  1136.         Let's look at what each piece of this data means:
  1137.              The top line is very important.  This line contains two
  1138.         pieces of data indicating the number of cities in the datafile
  1139.         and the maximum number of connections that any one city can have. 
  1140.         In this case, the first number tells us that there are 201 cities
  1141.         in the datafile.
  1142.              Your listing will have a larger number here more than
  1143.         likely, as new cities are being constantly added and the datafile
  1144.         is growing regularly. 
  1145.              The second number tells Roadways PC what the maximum number
  1146.         of cities any one city is connected to.  This will become more
  1147.  
  1148.                                        17
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.         apparent as we move on, so don't worry too much if you don't
  1157.         understand yet.
  1158.              On the second line is the first piece of city data.  Please
  1159.         note that the cities are numbered from 1 to 201 (in this example. 
  1160.         Yours may be higher), consecutively.  
  1161.              YOU MUST NOT MOVE THE CITIES AROUND!  You cannot change the
  1162.         order of the existing cities or remove a city without
  1163.         invalidating the entire listing.  You can remove the last city or
  1164.         put a new city on the end, but that is the extent of the
  1165.         modification you can make to the city file.
  1166.  
  1167.              The city data is set up like so:
  1168.  
  1169.         CNUM,CITY,STATE,CONN,C1,R1,D1,C2,R2,D2,C3,R3,D3...
  1170.  
  1171.         CNUM is the city number and applies to this line only!  In our
  1172.         example, CNUM for Albany is 1.  
  1173.  
  1174.         CITY is the city name.
  1175.  
  1176.         STATE is the state name.
  1177.  
  1178.         CONN is how many other cities this city connects to.  In the case
  1179.         of Albany, it connects to 5 other cities (in the example).
  1180.  
  1181.         C1 is the city number of the first city that this city connects
  1182.         to.  In our example, the first connection from Albany is to city
  1183.         number 156, which should be SYRACUSE,NY.
  1184.  
  1185.         R1 is the number of the route by which this city connects to the
  1186.         city indicated by C1.  Albany is connected to city number 156 by
  1187.         interstate 90.
  1188.  
  1189.         D1 is the distance from this city to the city indicated by C1. 
  1190.         Albany is connected to city number 156, by interstate 90 at a
  1191.         distance of 146 miles.
  1192.  
  1193.         C2, R2, D2, C3, R3, D3, etc. are the other cities that connect to
  1194.         this city, in exactly the same format as C1, R1, and  D1.
  1195.  
  1196.              The data for each connecting city is always entered in this
  1197.         format:  City number, route number, distance.  Spaces are not
  1198.         allowed anywhere but in the actual city name.
  1199.              To make it easier to understand adding a new city, let's
  1200.         take a look at how city number 201 was added to the data file. 
  1201.         If you haven't already, print out the city data file,
  1202.         ROADWAYS.DAT.  
  1203.              Take a look at city number 201.  We are going to pretend
  1204.         that this city does not yet exist in the datafile.  What we want
  1205.         to do is add the city MARION, Illinois.  By looking at my atlas,
  1206.         I have decided that I want it to connect to three other cities
  1207.         that are in the datafile already.
  1208.  
  1209.                                        18
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.              The cities I want Marion, Illinois to connect to are:
  1218.  
  1219.         Mt. Vernon, Il. (city number 99)
  1220.         Paducah, Ky. (city number 112)
  1221.         Sikeston, Mo. (city number 145)
  1222.  
  1223.              From my atlas, I get the route information about the roads
  1224.         like so:
  1225.  
  1226.         Mt. Vernon, Il. is 53 miles away on interstate 57
  1227.         Paducah, Ky. is 42 miles away on interstate 24
  1228.         Sikeston, Mo. is 60 miles away on interstate 57
  1229.  
  1230.              Now, I just have to build my new line entry.  Here are the
  1231.         steps for this example:
  1232.  
  1233.         1.  First is the new city number:  201
  1234.  
  1235.         2.  Next is the city name:  MARION  (all caps)
  1236.  
  1237.         3.  Next is the state name:  IL  (two letter abbreviation)
  1238.  
  1239.         4.  The number of cities we want to connect to:  3
  1240.  
  1241.         5.  City number of the first connecting city:  99 (Mt. Vernon)
  1242.  
  1243.         6.  Route number of the first connecting city:  57
  1244.  
  1245.         7.  Number of miles to the first connecting city:  53
  1246.  
  1247.         8.  City number of the second connecting city:  112 (Paducah)
  1248.  
  1249.         9.  Route number of the second connecting city:  24
  1250.  
  1251.         10. Number of miles to the second connecting city:  42
  1252.  
  1253.         11. City number of the third connecting city:  145 (Sikeston)
  1254.  
  1255.         12. Route number of the third connecting city:  57
  1256.  
  1257.         13. Number of miles to the third connecting city:  60
  1258.  
  1259.              Our new line should look like this:
  1260.  
  1261.         201,MARION,IL,3,99,57,53,112,24,42,145,57,60
  1262.  
  1263.              The order of the cities in the line is not critical, however
  1264.         the format of the data is.  In other words, it's ok to put
  1265.         Sikeston, Mo. as the first city in the line of connecting cities,
  1266.         however it is not ok to put the number of miles before the route
  1267.         number, since Roadways PC will think the route number is the
  1268.         distance and vice-versa.
  1269.  
  1270.                                        19
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.              Once you have developed the new line, you must now go and
  1279.         make the connection at the other end.  For instance, you have
  1280.         added a connection to city number 99 (Mt. Vernon, Il), but Mt.
  1281.         Vernon still does not have anything showing it's connection to
  1282.         city number 201.
  1283.              To complete the connection, go up to city number 99 and
  1284.         increase the number of cities it connects to.  Next add the
  1285.         connecting city information.  In this case you would add the
  1286.         following to the end of the line:
  1287.  
  1288.         201,57,53
  1289.  
  1290.              This should look familiar.  201 is the number of the city
  1291.         that was added at the end of the datafile.  57 is the route
  1292.         number from Marion, Il. to Mt. Vernon, Il., and 53 is the number
  1293.         of miles between the two cities.
  1294.              Repeat this for each of the connections made to the new
  1295.         city.
  1296.              To simplify matters, I usually just use a pencil to write
  1297.         the new information on the datafile printout.  This way, I can
  1298.         verify that I haven't left anything out.
  1299.              Once you have finished adding cities and making the changes
  1300.         to the printout, load up your favorite text editor.  Please be
  1301.         aware that you should avoid using a word processor if possible,
  1302.         unless you are very familiar with using it to make a true ASCII
  1303.         file.
  1304.              You MUST save the datafile as an ASCII file with hard
  1305.         carriage returns ONLY at the end of each line of data.  If you
  1306.         break any of the data lines anywhere other than at the end of the
  1307.         last piece of data for that line, Roadways PC will not work.
  1308.              I recommend using an editor such as MEDIT or even EDLIN, if
  1309.         you are familiar with it's use.
  1310.  
  1311.         Different Kinds of Roads
  1312.              Roadways PC allows six kinds of roads to be used.  They are
  1313.         1) Interstates, 2) U.S. Highways, 3) State Roads or Highways, 4)
  1314.         Turnpikes with a numeric designation (i.e- TP-9), 5) Rural Routes
  1315.         and 6) Turnpikes without a numeric designation.  To differentiate
  1316.         between them, you use the following rules:
  1317.  
  1318.         1)  To specify an Interstate, Simply type the number of the
  1319.         interstate (i.e. 64 would indicate interstate 64 or I-64).
  1320.  
  1321.         2)  To specify a U.S. Highway, simply type the number of the road
  1322.         as a negative (i.e. -64 would indicate US-64).
  1323.  
  1324.         3)  To specify a State Road or highways, simply add 1000 to the
  1325.         road number (i.e. 1052 would indicate SR-52).
  1326.  
  1327.         4)  To specify a turnpike (or toll road) that has a numeric
  1328.         designator, simply add 2000 to the road number.  For example, if
  1329.  
  1330.  
  1331.                                        20
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.         you want to specify a Turnpike that also has a state designator
  1340.         of 9, you would enter the number as 2009.
  1341.  
  1342.         5)  To specify a Rural Route, simply add 3000 to the road number
  1343.         (i.e. 3013 would indicate RR-13).
  1344.  
  1345.         6)  To specify a Turnpike (or toll road) that has no numeric
  1346.         designation (i.e. the New Jersey Turnpike), just enter a 0.  This
  1347.         will cause the word Turnpike to be printed out on the route
  1348.         screen.
  1349.  
  1350.         Things to Keep in Mind
  1351.              Here are some important things to keep in mind when adding
  1352.         cities:
  1353.  
  1354.         1.  NEVER insert a city into the datafile anywhere but at the
  1355.         end!
  1356.  
  1357.         2.  NEVER delete a city from the datafile, unless you are
  1358.         prepared to either delete all of the cities after the city you
  1359.         want to delete or completely rebuild the file to renumber all the
  1360.         cities after the deletion and change all references to the cities
  1361.         to the new numbers.
  1362.  
  1363.         3.  After adding a new city or connection, make sure you go to
  1364.         the cities connected to and make the connection back to the new
  1365.         city or connection.
  1366.  
  1367.         4.  If you add a city to the listing that is on the path between
  1368.         two cities that are already connected, it's best to remove the
  1369.         connection between the two farthest cities and connect them
  1370.         through the in-between city.
  1371.  
  1372.              Once you have made all the changes to the datafile, go to
  1373.         the top of the file to the very first two pieces of data.  If you
  1374.         remember, in our example these were the numbers 201 and 8
  1375.         separated by a comma.  You will need to change the first number
  1376.         to reflect the total number of cities now in the data file.  For
  1377.         instance, if the last city is city number 205, you should change
  1378.         the 201 to 205.
  1379.              Also, if any of the cities connects to more than 8 other
  1380.         cities, you will need to change the second number to the maximum
  1381.         number of connections.  For example, if the city with the largest
  1382.         number of connections has 10 total connections, you will need to
  1383.         change the number 8 to a 10.
  1384.  
  1385.         The City Sorter
  1386.              Now that all of your changes have been made, save the
  1387.         datafile and exit your editor.  If all has been done correctly,
  1388.         you should now be ready to run Roadways PC with the city sorter
  1389.         activated.  To do this, type:
  1390.  
  1391.  
  1392.                                        21
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.         ROADWAYS /I <enter>
  1401.  
  1402.              This will run the city sorter, recreating the sorted city
  1403.         files with your changes included.  It will also create the time
  1404.         datafile used to figure the fastest route.  This file will be
  1405.         created using the speeds that were saved in the configuration
  1406.         file, either from running the INSTALL program or from changing
  1407.         the default speeds in the Utilities menu from within Roadways PC.
  1408.              After the new datafiles have been created, Roadways will
  1409.         run, and you should see your added cities in the list.  I
  1410.         recommend you try some routes, in both directions, on your cities
  1411.         to make sure that the information you put in is correct and that
  1412.         you didn't make any errors.
  1413.  
  1414.         Common Pitfalls When Adding cities
  1415.              Probably the single biggest pitfall when adding cities is
  1416.         the temptation to try to add new cities without a printout of the
  1417.         data file.  This is NOT a good idea, and can result in errors or
  1418.         omissions.
  1419.              A recommendation from one of Roadways PC's registered users
  1420.         was, "don't try to add more than 3 cities at a time" (thanks for
  1421.         the hint, George!).  This will greatly reduce the probability for
  1422.         error.
  1423.              Another big problem area can crop up if you use a word
  1424.         processor or editor that splits the data lines.  When doing an
  1425.         ASCII save, these programs will frequently put a hard carriage
  1426.         return at the end of each screen line instead of at the end of
  1427.         the physical line.  This is why it is very important to keep a
  1428.         backup of the datafile on hand, in the event the one you are
  1429.         working with gets messed up.
  1430.              If something goes wrong with your datafile, it will be
  1431.         obvious, as the program will either not run at all or it will
  1432.         give you an error and terminate operation.  If this happens, you
  1433.         know something is wrong with your datafile, and you will either
  1434.         have to correct the problem with a word processor or re-copy your
  1435.         original datafile back to the directory or disk you are running
  1436.         Roadways PC from.
  1437.              It really isn't hard to add cities.  Just copy your datafile
  1438.         to some other place and play with it.  Just remember to run
  1439.         Roadways PC with the /I switch to allow the city sorter to update
  1440.         the lists of cities.
  1441.  
  1442.         TROUBLESHOOTING PROBLEMS WITH ROADWAYS PC
  1443.  
  1444.         1.  You get an error message that the ROADWAYS.DAT file is
  1445.         missing - This error indicates that for whatever reason, the file
  1446.         ROADWAYS.DAT is not in the same place as the ROADWAYS.EXE file. 
  1447.         There are two ways to fix this:  You can re-install Roadways PC
  1448.         from your original disk, or you can just re-copy the file
  1449.         ROADWAYS.DAT to your working disk or subdirectory.
  1450.  
  1451.  
  1452.  
  1453.                                        22
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.         2.  You get an error message that there is an error in the
  1462.         ROADWAYS.DAT file at a particular city number - This error
  1463.         usually occurs when you've added a city to Roadways and made an
  1464.         entry incorrectly.  I suggest that you print out the datafile and
  1465.         look especially close at the area around the city number where
  1466.         the error occurred, since this is where Roadways found the
  1467.         problem.  
  1468.              Usually, the problem is just that either a piece of data was
  1469.         left out or a period was put in where a comma should have been. 
  1470.         In some cases, the city number shown doesn't have a problem and
  1471.         the error is non-displayable or in city number 0.  Make sure that
  1472.         the number of connections for each city matches the number of
  1473.         cities.  For example, check to make sure that if a city you added
  1474.         has 3 connecting cities, that the number of connections shown is
  1475.         3 as well.
  1476.              If you just can't find the problem, drop your printout in
  1477.         the mail to me along with a copy of your ROADWAYS PC disk and
  1478.         I'll see if I can find the problem.
  1479.  
  1480.         3.  Roadways PC says that the sorted datafiles are corrupt - This
  1481.         usually will occur either during or just after these files are
  1482.         created using the /I command line parameter.  Usually, this means
  1483.         that something is ultimately wrong with your main ROADWAYS.DAT
  1484.         file.  Here is the best way to test this:
  1485.              Try running Roadways PC without any command line switches
  1486.         (i.e. - just type ROADWAYS and press <enter>).  If the problem is
  1487.         ultimately in your main datafile, the error listed in #2 above
  1488.         will be displayed.  If, however, you still get a message saying
  1489.         the problem is in one of your sorted datafiles, try re-running
  1490.         Roadways with the /I switch and see if it fixes the problem.
  1491.  
  1492.         4.  When I try to run ROADWAYS PC, after the copyright screen, I
  1493.         get an error right away that says I have Roadways PC configured
  1494.         for the wrong display and to select Hercules in the setup program
  1495.         - This error is due to the inability of the Hercules display to
  1496.         work in anything but 80 column text mode.  Just re-run the
  1497.         INSTALL program and answer N to whether you have a color monitor
  1498.         and Y to whether you have a Hercules card and monitor, and re-run
  1499.         Roadways PC.  This should fix the problem.
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.                                        23
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.         A NOTE ABOUT THE WINDOWS IN ROADWAYS PC
  1523.  
  1524.              You will notice that the help windows and the mileage
  1525.         calculation window are very similar.  For the mouse user, these
  1526.         windows can be either closed or moved at will.  To move a window,
  1527.         just click and hold the left mouse button down on the top bar of
  1528.         the window, and draw it where you want it.
  1529.              After the window is closed, it will revert to it's original
  1530.         location if re-opened.  You can close the windows by either
  1531.         clicking in the top left corner, clicking on 'OK', hitting
  1532.         <enter>, pressing the space bar or hitting ESC.
  1533.  
  1534.         UPGRADING ROADWAYS PC
  1535.  
  1536.              If you are upgrading from a previous release of Roadways PC,
  1537.         here are the steps you need to take to avoid losing any changes
  1538.         you have made to the city datafiles:
  1539.  
  1540.         1.  MAKE SURE YOU HAVE A BACKUP OF YOUR ORIGINAL ROADWAYS PC DISK
  1541.         AS WELL AS THE NEW ONE!!!!!!!!!!!
  1542.  
  1543.         2.  If you have added or modified your city datafiles, make a
  1544.         backup copy of YOUR city datafiles that contain the changes
  1545.         (ROADWAYS.DAT, ROADWAYS.CTY and ROADWAYS.STA).  Put the backup
  1546.         away so you don't accidentally erase or over-write it.
  1547.              If you haven't changed the datafile, you may want to use the
  1548.         newer datafile as it may contain new city data you don't
  1549.         currently have.  If this is so, copy everything from the new disk
  1550.         to your ROADWAYS subdirectory, go to step 3 and skip step 6.
  1551.  
  1552.         3.  Copy all the files EXCEPT ROADWAYS.DAT, ROADWAYS.CTY and
  1553.         ROADWAYS.STA from the newer version to your Roadways directory or
  1554.         disk.
  1555.  
  1556.         4.  Delete the file ROADWAYS.CFG from your Roadways directory or
  1557.         disk.
  1558.  
  1559.         5.  Type INSTALL at the MS-DOS prompt.  INSTALL should load and
  1560.         run.  Follow the steps listed in the section INSTALLING ROADWAYS
  1561.         PC to make the new ROADWAYS.CFG file.
  1562.  
  1563.         6.  Go through the configuration process.  When it is done, you
  1564.         should now have a completely upgraded Roadways PC!
  1565.  
  1566.              A key thing to remember is that the new configuration file
  1567.         (ROADWAYS.CFG) is incompatible with earlier releases.
  1568.  
  1569.         BACKGROUND ON ROADWAYS PC
  1570.  
  1571.              The idea for Roadways PC came from a similar program done on
  1572.         the Apple many years ago.  This program worked but was very slow
  1573.         and not at all flexible.  It seemed to me that a much better
  1574.  
  1575.                                        24
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.         implementation of the idea could be had by using the IBM PC with
  1584.         it's far superior processing speed, memory capabilities and the
  1585.         availability of better languages to work from.
  1586.              Initially, Roadways PC was done in GW-BASIC, however it
  1587.         became apparent very rapidly that this was unsuitable.  Besides
  1588.         being horrendously slow, it was also bulky, requiring the use of
  1589.         the BASIC interpreter.
  1590.              After discovering Microsoft QuickBASIC 4.0, the entire
  1591.         program was re-written in modular form without line numbers. 
  1592.         Several bugs manifested themselves, some of which were in
  1593.         Roadways PC and some which were part of QuickBASIC.
  1594.              At this point, I discovered the Microsoft BASIC Compiler,
  1595.         version 7.1.  This is what this version of the program is written
  1596.         in.  Here, finally, was the support I needed without the
  1597.         limitations and bugs in QuickBASIC.
  1598.  
  1599.         ABOUT THE AUTHOR
  1600.  
  1601.              Doug Fitler is in the U.S. Air Force and has been for the
  1602.         last 15 years.  In his spare time, he is the managing editor of
  1603.         the magazine One Thousand, a magazine geared to the Tandy 1000
  1604.         owner.
  1605.              He has been programming since 1983 and is currently trying
  1606.         to learn enough 'C' to be able to re-write Roadways PC in that
  1607.         language to increase it's speed, reduce it's size and maybe
  1608.         (don't hold your breath) provide a Windows 3.0 interface.
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.                                        25
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.         ABOUT ROADWAYS PC
  1646.  
  1647.              Roadways PC is distributed under the Shareware concept.  If
  1648.         you like it, please register it.  This will help support the
  1649.         further enhancement of the product, as well as compensate the
  1650.         author for the work put into the program.
  1651.              Registering Roadways will entitle you to free upgrades for a
  1652.         year.  Also, registered users will be able to disable the opening
  1653.         copyright screen and will receive a free subscription to The
  1654.         Roadways Times, a newsletter published quarterly for registered
  1655.         Roadways PC users.  Lifetime free upgrades are available as well. 
  1656.         See the registration form for more information on these options. 
  1657.         Basic registration costs only $10.00.
  1658.              You are free to give this program to anyone, and put it on
  1659.         any information services you wish, as long as all of the files
  1660.         listed in the section DISTRIBUTED FILES are included.
  1661.              Send registrations to the following address:
  1662.  
  1663.         Doug Fitler
  1664.         Box 25424
  1665.         Scott AFB, Il.  62225
  1666.  
  1667.              Please make all checks and money orders payable to Doug
  1668.         Fitler.
  1669.  
  1670.              If you have any questions or suggestions to improve Roadways
  1671.         PC, please drop me a line.  Thank you for supporting the
  1672.         Shareware Concept!
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.                                        26
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.         DISCLAIMER
  1706.  
  1707.              The author hereby disclaims all warranties relating to this
  1708.         software, whether express or implied, including without
  1709.         limitation any implied warranties of merchantability or fitness
  1710.         for a particular purpose.  The author will not be liable for any
  1711.         special, incidental, consequential, indirect or similar damages
  1712.         due to loss of data or any other reason, even if the author or an
  1713.         agent of the author has been advised of the possibility of such
  1714.         damages.  In no event shall the author's liability for any
  1715.         software ever exceed the price paid for the license to use this
  1716.         software, regardless of the form of the claim.  The person using
  1717.         the software bears all risk as to the quality and performance of
  1718.         the software.
  1719.              Please note that the author of Roadways PC makes no claims
  1720.         as to the accuracy of the mileages calculated.  Roadways PC is
  1721.         primarily a tool to help you plan your trip, and as such should
  1722.         not be used when accuracy is important.  It is highly recommended
  1723.         that if you wish to use Roadways PC to plan a trip, you double
  1724.         check the route with a reputable atlas to make sure it meets your
  1725.         requirements.  Roadways will provide a route that is the shortest
  1726.         based on the data it has to work with.  Any errors, omissions,
  1727.         oversights or problems with the data and the algorithm used to
  1728.         calculate the mileages and display the data are the sole
  1729.         responsibility of the user and not the author.
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.                                        27
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.         ASSOCIATION OF SHAREWARE PROFESSIONALS OMBUDSMAN POLICY
  1767.  
  1768.         "This program is produced by a member of the Association of
  1769.         Shareware Professionals (ASP).  ASP wants to make sure that the
  1770.         shareware principle works for you. If you are unable to resolve a
  1771.         shareware-related problem with an ASP member by contacting the
  1772.         member directly, ASP may be able to help. The ASP Ombudsman can
  1773.         help you resolve a dispute or problem with an ASP member, but
  1774.         does not provide technical support for members' products. Please
  1775.         write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  1776.         or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  1777.         70007,3536."
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.                                        28
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.         SUMMARY OF CHANGES
  1828.  
  1829.         Changes to version 2.0:
  1830.  
  1831.         1.  Added checking of Environment for defaults.
  1832.  
  1833.         2.  Added the ability to bypass the copyright screen for
  1834.         registered users. 
  1835.  
  1836.         3.  Added the option to save routes to disk.
  1837.  
  1838.         4.  Added Retrieval of routes from disk with optional printout. 
  1839.         Includes a directory listing of .RDW files (roadways saved
  1840.         files).
  1841.  
  1842.         5.  Added 'R' to the help menu and to the Mouse selection blocks. 
  1843.         Also added Disk Output to the display screen.  Added a mouse box
  1844.         with Print, More and Return to Roadways PC Main to the Retrieval
  1845.         screen.
  1846.  
  1847.         6.  Added the mileage rate input to the config screen.
  1848.  
  1849.         7.  Added mileage output to all output screens.
  1850.  
  1851.         8.  Added the option to change the mileage rate from within
  1852.         Roadways with the 'M' key.
  1853.  
  1854.         9.  Updated the documentation to include all of the above
  1855.         features.
  1856.  
  1857.         10.  Changed the Help box to a true window that is closeable and
  1858.         moveable.
  1859.  
  1860.         11.  Put the mileage information on the route screen into a
  1861.         moveable, closeable window.
  1862.  
  1863.         Changes to version 2.5:
  1864.  
  1865.         1.  Pull down menus have been added to the main city selection
  1866.         screen.
  1867.  
  1868.         2.  The route display is scrollable if it exceeds the room on the
  1869.         screen.
  1870.  
  1871.         3.  Starting and ending cities in the route display have been
  1872.         highlighted to make them more visible.
  1873.  
  1874.         4.  A help menu has been added to the route screen.
  1875.  
  1876.         5.  The configuration program has been removed from the main
  1877.         program and revised to include installation to a hard drive.
  1878.  
  1879.  
  1880.                                        29
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.         Changes to versions 2.51, 2.52 and 2.53:
  1889.  
  1890.         1.  Several minor bugs were fixed that caused problems with
  1891.         calculated dollar amounts in the mileage calculation routines.
  1892.  
  1893.         2.  The Up and Down keys were switched to make the Up Arrow key
  1894.         scroll the list up and the Down Arrow key scroll down. (oops!)
  1895.  
  1896.         3.  The colors were fixed for monochrome displays to make the
  1897.         display screens readable and highlighting look correct.
  1898.  
  1899.         4.  A bug in the scroll screen was fixed that caused the scroll
  1900.         up and scroll down block to appear if only 12 cities were in the
  1901.         route. The minimum should have been 13.
  1902.  
  1903.         Changes to version 2.54 and 2.54a:
  1904.  
  1905.         1.  Allowed Roadways PC to be used on a Hercules display and
  1906.         adapter card.
  1907.  
  1908.         2.  Updated the INSTALL program to include selection of the
  1909.         Hercules monochrome monitor.
  1910.  
  1911.         3.  Changed the INSTALL program to require <enter> to be pressed
  1912.         after a selection was made.  This was at the request of several
  1913.         users.
  1914.  
  1915.         4.  Fixed a bug that prevented the EPSON printer selection on the
  1916.         install menu from working properly.  Now when EPSON is selected,
  1917.         Roadways will send the code to the printer to put it into the
  1918.         graphics character set (IBM printer codes instead of the EPSON
  1919.         codes).
  1920.  
  1921.         Changes to version 3.0:
  1922.  
  1923.         1.  Fixed a bug with the output mileage calculations that made
  1924.         them incorrect until the screen was completely scrolled.
  1925.  
  1926.         2.  Added the capability to scroll continuously with the mouse by
  1927.         holding the left mouse button down while in the scroll box.
  1928.  
  1929.         3.  Changed questions to positive answer to affirm (particularly
  1930.         the exit prompt).
  1931.  
  1932.         4.  Added default answers to all Y/N prompts.  Accessed by just
  1933.         pressing <enter>.
  1934.  
  1935.         5.  Highlighted the complete city and state space.
  1936.  
  1937.         6.  Added a time out to the copyright screen (5 seconds) when
  1938.         displayed during program startup.
  1939.  
  1940.  
  1941.                                        30
  1942.  
  1943.  
  1944.  
  1945.  
  1946.         7.  Added Hercules graphic adapter support.
  1947.  
  1948.         8.  If the ROADWAYS.CFG file is not found or is incorrect, upon
  1949.         startup of ROADWAYS, an option to run the INSTALL program is
  1950.         displayed from the ROADWAYS program startup.
  1951.  
  1952.         9.  The INSTALL and REGISTER programs have been merged into one
  1953.         program called INSTALL.
  1954.  
  1955.         10.  You can now start INSTALL with a drive specifier for
  1956.         installation to a particular hard drive (range of C: to G:), by
  1957.         typing INSTALL d:, where d: is the drive you want Roadways
  1958.         installed onto.
  1959.  
  1960.         11.  Other minor bug fixes designed to make life easier and
  1961.         faster for the user.
  1962.  
  1963.         12.  Put the documentation on disk with a left margin and at 10
  1964.         cpi to make it more readable when printed out.
  1965.  
  1966.         13.  Added several new options on the drop down menus:  Default
  1967.         Settings, Set Home City, re-run last route, and Toggle Shortest
  1968.         Time/Distance.
  1969.  
  1970.         14.  Did away with some of the boxes on the main screen, and
  1971.         added a separate Quit function on the menu bar.
  1972.  
  1973.         15.  Added the option to use different data files with Roadways
  1974.         by just entering the datafile name in the INSTALL program or from
  1975.         within Roadways.
  1976.  
  1977.         16.  Added several features to the INSTALL file to fix some of
  1978.         the problems some users were having installing to a hard disk, as
  1979.         well as dressing the whole shebang up.
  1980.  
  1981.         17.  Added handling of states with 55 mile per hour maximums
  1982.         different than states with 65 mile per hour.
  1983.  
  1984.         18.  Added an option to run routes by the shortest time as
  1985.         opposed to the shortest distance.
  1986.  
  1987.         19.  Made the default speeds used for calculating driving times
  1988.         user changeable and a part of the configuration file.
  1989.  
  1990.         20.  Improved the precision of the cost per mile of operation, by
  1991.         going to 4 decimal places, versus 2.
  1992.  
  1993.         21.  Added the option to run Roadways PC from within the INSTALL
  1994.         program.
  1995.  
  1996.         22.  Added the ROADWAYS.TIM file to allow running of routes by
  1997.         shortest time.
  1998.  
  1999.         Changes to version 3.01:
  2000.  
  2001.         1.  I discovered that somehow a semicolon got erased and when
  2002.         using the arrow keys to scroll down the list of cities, when
  2003.  
  2004.  
  2005.                                        31
  2006.  
  2007.  
  2008.  
  2009.  
  2010.         reaching the bottom, the entire screen would move up a line. 
  2011.         This made a real mess of the display.  
  2012.  
  2013.         2.  When calculating speed on a stretch of highway, the speed
  2014.         assigned to the 65 mph areas was used for all roads in states
  2015.         with 65 mph speed limits.  This was fixed to make state roads
  2016.         accept the speed assigned to the 55 mph areas.  
  2017.  
  2018.         3.  Due to the above bug, I also found the same problem in the
  2019.         portion of the program that generates the .TIM file.  This was
  2020.         fixed.
  2021.  
  2022.         Changes to version 3.02:
  2023.  
  2024.         1.  Put a Re-Run last route button on the main screen to ease re-
  2025.         running routes.  Redefined the key 'R' to re-run the last route
  2026.         and changed Retreive Routes to the 'F' key.
  2027.  
  2028.         2.  Fixed a bug that allowed the re-running of previous routes
  2029.         without having run any routes.
  2030.  
  2031.         3.  Changed the Registration program so no changes were needed to
  2032.         the AUTOEXEC.BAT file.  A change is made to the ROADWAYS.EXE file
  2033.         instead.
  2034.  
  2035.         Changes to version 3.1 and 3.1a:
  2036.  
  2037.         1.  Added the capability to have 3 additional types of routes
  2038.         (State roads, Rural routes, and Turnpikes with a numeric
  2039.         designation).
  2040.  
  2041.         2.  Updated the ROADWAYS.DAT file to take advantage of the new
  2042.         route types.
  2043.  
  2044.         3.  Added a line at the bottom of the Route Screen that shows the
  2045.         selected speeds for time and driving speed calculations.
  2046.  
  2047.         4.  Added support for routes that exceed 100 hours in length
  2048.         (Thanks Donald!).
  2049.  
  2050.         Roadways PC - 3.1 has the following changed files:
  2051.         ROADWAYS.EXE
  2052.         INSTALL.EXE
  2053.         ROADWAYS.DOC
  2054.         README.DOC
  2055.  
  2056.         Roadways PC - 3.1a has the following changed files:
  2057.         ROADWAYS.EXE
  2058.         ROADWAYS.DOC
  2059.         README.DOC
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.                                        32
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.                                      INVOICE
  2076.                             Roadways PC version 3.1b
  2077.  
  2078.         Remit to:
  2079.  
  2080.         Doug Fitler
  2081.         P.O. Box 25424
  2082.         Scott AFB, Il.  62225
  2083.  
  2084.         From:
  2085.  
  2086.         Name: ________________________________________________________
  2087.  
  2088.         Company: _____________________________________________________
  2089.  
  2090.         Street Address: ______________________________________________
  2091.  
  2092.         City: ____________________   State: __________________________
  2093.  
  2094.         Zip Code: ________________
  2095.  
  2096.         Quantity: ________ 
  2097.  
  2098.         Pricing:               Check the options you wish
  2099.                                                 
  2100.              Basic Registration    :  $10.00  [  ]
  2101.              Lifetime Free upgrades:  $15.00  [  ]
  2102.              City Editor Program   :  $10.00  [  ]
  2103.  
  2104.         Special offer:
  2105.  
  2106.              All of the above      :  $30.00  [  ]
  2107.  
  2108.         Total sent :  $________
  2109.  
  2110.         I use 5.25 360K _______    5.25 1.2M _______    3 1/2" _______
  2111.  
  2112.         Home Phone (not required): (____)-____________________________
  2113.  
  2114.         Work Phone (not required): (____)-____________________________
  2115.  
  2116.         Where did you find Roadways PC?_______________________________
  2117.  
  2118.         ______________________________________________________________
  2119.  
  2120.         Comments or Suggestions: _____________________________________
  2121.  
  2122.         ______________________________________________________________
  2123.  
  2124.         ______________________________________________________________
  2125.  
  2126.         Note that Roadways PC has been delivered and accepted by the
  2127.         customer.  Upon receipt of this paid invoice, if an upgrade has
  2128.         occurred, a current disk and any updated documentation will be
  2129.         sent.
  2130.                                                                     RW31b
  2131.  
  2132.  
  2133.                                        33
  2134.  
  2135.