home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / cw / w1hkjcw / morse201.doc < prev    next >
Text File  |  1988-03-25  |  16KB  |  369 lines
  1. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  2. =                                                                         =
  3. =                                   MORSE                                 =
  4. =                                                                         =
  5. =                        A PROGRAM FOR CODE PRACTICE                      =
  6. =                                                                         =
  7. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  8.  
  9.  
  10. REQUIRED HARDWARE:
  11.  
  12.    IBM-PC or compatible
  13.    Color monitor for best viewing
  14.  
  15.  
  16. REQUIRED SOFTWARE:
  17.  
  18.    MS-DOS 2.02 or equivalent
  19.    Turbo Pascal (version 3.0) for uncompiled version
  20.  
  21.  
  22. PROGRAMS IN THE MORSE PACKAGE:
  23.  
  24.    MORSExxx.COM --> Morse code practice program version x.xx
  25.    MORSExxx.DOC --> This documentation
  26.    CODEnnn.TXT  --> Text files (may be several and may be collected in an
  27.                     archive called TEXTmmm.ARC, where the mmm sequence is
  28.                     a sequential numbering as additional text files are
  29.                     added to the original distribution set)
  30.    INSTAL.COM   \
  31.    INSTAL.DTA    -> These three files comprise the installation package
  32.    INSTAL.MSG   /
  33.  
  34.    The entire set of programs may be clustered as a file archive called
  35.    MORSExxx.ARC, where the xxx corresponds to the version number (x.xx).
  36.    At the time this documentation was prepared, version 5.12 of V. Buerg'sì
  37.    ARChive program was being used for this purpose.ì
  38.  
  39.  
  40. LANGUAGE:
  41.  
  42.    MORSE was written and compiled using Turbo Pascal (version 3.0).
  43.    Turbo Pascal is a registered trademark of Borland International.
  44.    From the standpoints of utility, cost, user-friendliness, and
  45.    support, there is simply no better version of Pascal available
  46.    for microcomputers today!  The installation procedure was
  47.    generated by GINST, a program supplied as part of the Turbo
  48.    Toolbox, another fine programming aid from Borland.
  49.  
  50.  
  51.  
  52. USAGE NOTES:
  53.  
  54.    This is the first version of MORSE to be released.  Full documentation
  55.    is being prepared at this time.  You should experience little, if any,
  56.    trouble handling the command structure of MORSE.  The main menu and
  57.    operations branching from there display lines offering command entry
  58.    information.  A few notes are needed with regard to the Main Menu and,
  59.    particularly, the use of text files, the option for making new textì
  60.    files, and the installation procedure.  The latter was added in versionì
  61.    2.01 in response to a demonstrated need for customized installation ofì
  62.    MORSE on a variety of MS-DOS
  63. computers.ì
  64.  
  65.    The installation procedure should be used before any attempt is made toì
  66.    run MORSE!ì
  67.  
  68.  
  69. MAIN MENU:
  70.  
  71.    -- Make your choice by pressing the indicated function key (e.g., <F1>
  72.       to begin practice, or <F4> to toggle between random code and text).
  73.    -- The most recent choice (or the default choice when beginning MORSE)
  74.       will be highlighted in bright white.
  75.    -- Code speed and pitch may be adjusted to your convenience.  Note that
  76.       speeds above 40 wpm will produce a noticeable abbreviation of the
  77.       sound for a dot.
  78.  
  79.  
  80. MAKING NEW TEXT FILES:
  81.  
  82.    The names of text files follow the naming convention CODExxx.TXT, where
  83.    xxx is a digit in the range 1-999, inclusive.  When creating a new file
  84.    using this option, the first available number will automatically be used.
  85.    Thus, the actual name may be in the form CODEx.TXT or CODExx.TXT as well.
  86.  
  87.    Text files may be created using any ASCII editor.  Be sure to follow the
  88.    naming convention.  Do not use a three-digit sequence for a two-digit
  89.    number!  "CODE026.TXT" will cause problems if the CREATOR option is
  90.    used later!
  91.  
  92.    A library of text files is available as a companion to the main MORSE
  93.    program.  Filenames follow the convention outlined above.  The current
  94.    collection is distributed as an archive using the naming convention
  95.    TEXTxxx.ARC, where xxx will be replaced with a progressive numerical
  96.    sequence.  The first release contained only CODE1.TXT and CODE2.TXT
  97.    into TEXT001.ARC.  The current release is TEXT002.ARC.  The archive
  98.    of text files may be contained within the comprehensive MORSE archive,
  99.    at the option of distributing sysops.
  100.  
  101.  
  102. TERMINAL INSTALLATION
  103.  
  104.    Before you use MORSE, it must be installed to your particular terminal,
  105.    i.e.  provided with information regarding control characters required
  106.    for certain functions.  This installation is easily perfomred using the
  107.    program INSTAL which is described in this section.
  108.  
  109.    After  having  made a work-copy,  please store  your distribution
  110.    diskette safely away and work only on the copy.
  111.  
  112.    Now start the installation by typing INSTAL at your terminal.  Select
  113.    Screen installation from the main menu.  Depending on your version of
  114.    MORSE,  the installation proceeds as described in the following two
  115.    sections.
  116.  
  117.    IBM PC Display Selection
  118.  
  119.      If you use MORSE without installation, the default screen set-up will
  120.      be used.  You may override this default by selecting another screen
  121.      mode from this menu:
  122.  
  123.      -----------------------------------------------------------------
  124.        Choose one of the following displays:
  125.  
  126.            0) Default display mode
  127.            1) Monochrome display
  128.            2) Color display 80x25
  129.            3) Color display 40x25
  130.            4) b/w   display 80x25
  131.            5) b/w   display 80x25
  132.  
  133.        Which display (enter no. or ^X to exit)  !
  134.      -----------------------------------------------------------------
  135.                       IBM PC Screen Installation Menu
  136.  
  137.      Each time MORSE runs, the selected mode will be used, and you will
  138.      return to the default mode on exit.
  139.  
  140.  
  141.    Non-IBM Installation
  142.  
  143.      A menu listing a mungber of popular terminals will appear, inviting
  144.      you to choose one by entering its number:
  145.  
  146.      -------------------------------------------------------------------
  147.         Choose one of the following terminals:
  148.  
  149.           1) ADDS 20/25/30          15) Lear-Siegler ADM-31
  150.           2) ADDS 40/60             16) Liberty
  151.           3) ADDS Viewpoint-1A      17) Morrow MDT-20
  152.           4) ADM 3A                 18) Otrona Attache
  153.                               .
  154.                               .
  155.                               .
  156.          13) Kaypro II and 4        27) None of the above
  157.          14) Lear-Siegler ADM-20    28) Delete a definition
  158.  
  159.        Which terminal? (Enter no. or ^X to exit):
  160.      -----------------------------------------------------------------
  161.                         Terminal Installation Menu
  162.  
  163.      If your terminal is mentioned, just enter the corresponding number,
  164.      and the installation is complete.  Before installation is actually
  165.      performed, you are asked the question:
  166.  
  167.      ------------------------------------------------------------------
  168.         Do you want to modify the definition before installation?
  169.      ------------------------------------------------------------------
  170.  
  171.      This allows you to modify one or more of the values being installed as
  172.      described in the following.  If you do not want to modify the terminal
  173.      definition, just type N, and the installation completes by asking you
  174.      the operating frequency of your CPU (see last item in this section).
  175.  
  176.      If your terminal is not on the menu, however, you must define the
  177.      required values yourself.  The values can most probably be found in
  178.      the manual supplied with your terminal.
  179.  
  180.      Enter the number corresponding to "None of the above" and answer the
  181.      questions one by one as they appear on the screen.
  182.  
  183.      In the following, each command you may install is described in
  184.      detail.  Your terminal may not support all the commands that can be
  185.      installed.  If so, just pass the command not needed by typing RETURN
  186.      in response to the prompt.  If Delete line, Insert line, or Erase to
  187.      end of line is not installed, these functions will be emulated in
  188.      software, slowing screen performance somewhat.
  189.  
  190.      Commands may be entered either simply by pressing the appropriate
  191.      keys or by entering the decimal or hexidecimal ASCII value of the
  192.      command.  If a command requires the two characters 'ESCAPE' and
  193.      '=', may:
  194.  
  195.      either Press first the ESC key, then the =.  The entry will be
  196.        echoed with appropriate labels, i.e.  <ESC> =.
  197.      or Enter the decimal or hexidecimal values separated by spaces.
  198.        Hexidecimal values must be preceded by a dollar sign.  Enter, e.g.,
  199.        27 61  or  $1B 61  or  $1B $3D, which are all equivalent.
  200.  
  201.      The two methods cannot be mixed, i.e. once you have entered a non-
  202.      numeric character, the rest of that command must be defined in that
  203.      mode, and vice versa.
  204.  
  205.      A hyphen entered as the very first character is used to delete a
  206.      command, and echoes the text "Nothing".
  207.  
  208.      Terminal type:
  209.      ------------------------------------------------------------------
  210.      Enter the name of the terminal you are about to install.  When you
  211.      complete INSTAL, the values will be stored, and the terminal name will
  212.      appear on the initial list of termianls.  If you later need to
  213.      re-install MORSE to this terminal, you can do that by choosing it from
  214.      the list.
  215.  
  216.      Send an initialization string to the terminal?
  217.      ------------------------------------------------------------------
  218.      If you want to initialize your terminal when MORSE starts (e.g., to
  219.      download commands to programmable function keys), you answer Y for yes
  220.      to this question.  If not, just hit RETURN.
  221.  
  222.      If you answer Y, you may enter up to 13 characters for this string.
  223.  
  224.      Send a reset string to the terminal?
  225.      ------------------------------------------------------------------
  226.      Here, you may define a string to be sent to the terminal when MORSE
  227.      terminates.  The description of the intiialization command above
  228.      applies here.
  229.  
  230.      CURSOR LEAD-IN command:
  231.      ------------------------------------------------------------------
  232.      Cursor Lead-In is a special sequence of characters which tells your
  233.      terminal that the follwoing characters are an address on the screen on
  234.      which the cursor should be placed.
  235.  
  236.      When you define this command, you are asked the following
  237.      supplementary questions:
  238.  
  239.  
  240.           CURSOR POSITIONING COMMAND to send between line and column:
  241.           ------------------------------------------------------------
  242.           Some terminals need a command between the two numbers defining
  243.           the row and column cursor address.
  244.  
  245.           CURSOR POSITIONING COMMAND to send after line and column:
  246.           ------------------------------------------------------------
  247.           Some terminals need a command after the two numbers defining the
  248.           row and column cursor address.
  249.  
  250.           Column first?
  251.           ------------------------------------------------------------
  252.           Most terminal require the address on the format: first ROW, then
  253.           COLUMN.  If this is the case on your terminal, answer N.  If your
  254.           terminal wants COLUMN first, then ROW, then answer Y.
  255.  
  256.           OFFSET to add to LINE:
  257.           ------------------------------------------------------------
  258.           Enter the number to add to the LINE (ROW) address.
  259.  
  260.           OFFSET to add to COLUMN
  261.           ------------------------------------------------------------
  262.           Enter the number to add to the COLUMN address.
  263.  
  264.           Binary address?
  265.           ------------------------------------------------------------
  266.           Most terminals need the cursor address sent in binary form.  If
  267.           that is true for your terminal, enter Y.  If your terminal
  268.           expects the cursor address as ASCII digits, enter N.  If so, you
  269.           are asked the supplementary question:
  270.  
  271.                2 or 3 ASCII digits?
  272.                -------------------------------------------------------
  273.                Enter the number of digits in the cursor address for your
  274.                terminal.
  275.  
  276.      CLEAR SCREEN command:
  277.      ------------------------------------------------------------------
  278.      Enter the command that will clear the entire contents of your screen,
  279.      both foreground and background, if applicable.
  280.  
  281.      Does CLEAR SCREEN also HOME cursor?
  282.      ------------------------------------------------------------------
  283.      This is normally the case; if it is not so on your terminal, enter
  284.      N, and define the cursor HOME command.
  285.  
  286.      DELETE LINE command:
  287.      ------------------------------------------------------------------
  288.      Enter the command that deletes the entire line at the cursor position.
  289.  
  290.      INSERT LINE command:
  291.      ------------------------------------------------------------------
  292.      Enter the command that inserts a line at the cursor position.
  293.  
  294.      ERASE TO END OF LINE command:
  295.      ------------------------------------------------------------------
  296.      Enter the command that erases the line at the cursor position from the
  297.      cursor position through the right end of the line.
  298.  
  299.      START OF 'LOW VIDEO' command:
  300.      ------------------------------------------------------------------
  301.      If your terminal supports different video intensities, then define the
  302.      command that initiates the dim video here.  If this command is defined,
  303.      the following question is asked:
  304.  
  305.             START OF 'NORMAL VIDEO' command:
  306.             -----------------------------------------------------------
  307.             Define the command that sets the screen to show characters in
  308.             'normal' video.
  309.  
  310.      Number of rows (lines) on your screen:
  311.      ------------------------------------------------------------------
  312.      Enter the number of horizontal lines on your screen.
  313.  
  314.      Number of columns on your screen:
  315.      ------------------------------------------------------------------
  316.      Enter the number of vertical column positions on your screen.
  317.  
  318.      ------------------------------------------------------------------
  319.      Delay after CURSOR ADDRESS (0-255 ms):
  320.      Delay after CLEAR, DELETE, and INSERT (0-255 ms):
  321.      Delay after ERASE TO END OF LINE and HIGHLIGHT On/Off (0-255 ms):
  322.      ------------------------------------------------------------------
  323.      Enter the delay in milliseconds required after the functions
  324.      specified.  Return means 0 (no delay).
  325.  
  326.      Is this definition correct?
  327.      ------------------------------------------------------------------
  328.      If you have made any errors in the definitions, enter N.  You will
  329.      then return to the terminal selection menu.  The installation data
  330.      you have just entered will be included in the installation data file
  331.      and appear on the terminal selection menu, but installation will not
  332.      be performed.
  333.  
  334.      When you enter Y in response to this question, you are asked:
  335.  
  336.      ------------------------------------------------------------------
  337.      Operating frequency of your microprocessor in MHz (for delays):
  338.      ------------------------------------------------------------------
  339.      As the delays specified earlier are depending on the operating
  340.      frequency of your CPU, you must define this value.
  341.  
  342.      The installation is finished, installation data is written to MORSE,
  343.      and you return to the outer menu.  New installation data is also saved
  344.      in the installation data file and the new terminal will appear on the
  345.      terminal selection list when you run INSTAL in future.
  346.  
  347.  
  348.                     -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  349.  
  350. To report bugs, suggest improvements, or make a donation to ensure continued
  351. improvement of this program, please contact:
  352.  
  353.                          Jim Aman
  354.                          Dot...Space Software
  355.                          731 Londonderry Lane, #215
  356.                          Denton, Texas  76205
  357.  
  358.  
  359.  
  360.  
  361. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  362.  
  363.  
  364.                Denton, Texas  76205
  365.  
  366.  
  367.  
  368.  
  369. -=-