home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / HR / HR025.ZIP / &READ.ME next >
Text File  |  1988-03-09  |  8KB  |  193 lines
  1. -----------------------------------------------------------------
  2.  
  3.                   SamfB - The Morse Code Program
  4.  
  5. Copyright (C) 1988
  6. Tranzoa, Co.
  7. P.O. Box 911
  8. Maple Valley, WA  98038
  9.  
  10. -----------------------------------------------------------------
  11.                               SAMFB
  12. -----------------------------------------------------------------
  13.  
  14.      SamfB helps you learn to "key" and "copy" Morse code.
  15.  
  16.      SamfB  runs  on  an IBM-PC or clone with at  least  160k  of 
  17. program memory.
  18.  
  19. -----------------------------------------------------------------
  20.                               FILES
  21. -----------------------------------------------------------------
  22.  
  23.      The  SamfB  "shareware" package consists  of  the  following 
  24. files:
  25.  
  26.      &READ.ME       This file.
  27.      SAMFB.EXE      The SamfB program.
  28.      SAMFB.HLP      The on-line, context sensitive help file.
  29.      SAMFB.SCR      The front page screen image file.
  30.  
  31.  
  32. -----------------------------------------------------------------
  33.  
  34.      SamfB creates the file "SAMFB.CFG" when you stop the program 
  35. with  ALT  X.   This file stores  SamfB's  configurable  options, 
  36. including  screen type, colors, windowing and  sound  attributes, 
  37. program operation mode, and operator experience.
  38.  
  39.      SamfB  may  also  create the file,  "OPPRINT.PCF"  to  store 
  40. printer characteristics.
  41.  
  42.      Print-outs to files always go to the file, "SAMFB.PRN".
  43.  
  44. -----------------------------------------------------------------
  45.                            QUICK-START
  46. -----------------------------------------------------------------
  47.  
  48.      If you have no experience with SamfB, do this:
  49.  
  50.      --->  Make sure that you DO NOT have a file named  SAMFB.CFG 
  51. in your current directory or in your PATH.
  52.  
  53.      --->  Make sure that you DO have the file SAMFB.HLP in  your 
  54. current directory or in your PATH.
  55.  
  56.      --->  Run SamfB from the DOS command line.
  57.  
  58.      --->  If you've a two-color monitor on a color adapter (CGA, 
  59. EGA,  for  example), you may want to tell SamfB so.   When  SamfB 
  60. first starts, press ALT F10.  This will "pop-up" a service called 
  61. the "colorizer."  Repeatedly pressing SPACE-BAR to the  colorizer 
  62. will cycle between the four possible "color sets."  Find the  one 
  63. you prefer, and strike the RETURN/ENTER key to make it permanent.
  64.  
  65.      --->  If SamfB does not find SAMFB.CFG, then you'll  be  put 
  66. into the Help System immediately.  You can read whatever you want 
  67. in the help system.  When you want to get going with the program, 
  68. press  the  ESC  key.   You'll  be  put  into  the  Menu  System.  
  69. Specifically,  you'll be able to choose which of six "modes"  you 
  70. want  to  start with.  Choose one and press  ENTER.   SamfB  will 
  71. put you back into the Help System to explain the mode.  Read  it, 
  72. ESCape out of it, and - finally - you're on your own.
  73.  
  74.      ---> Enjoy the program.  Remember that it got written as  an 
  75. accident.   It  was  supposed  to be  a  file  card/address  book 
  76. program!
  77.  
  78. -----------------------------------------------------------------
  79.                            SOURCE CODE
  80. -----------------------------------------------------------------
  81.  
  82.      Complete source code for SamfB is available for only $49.
  83.  
  84.      This source code includes more than 300 public C routines in 
  85. more than  100  source code files.   It  also  includes  assembly 
  86. language  modules  for high-speed screen I/O, hardware  and  BIOS 
  87. access,  sub-micro-second  timing  routine,  multi-tasking,   and 
  88. a multi-port, interrupt-driven, RS-232 serial port driver.
  89.  
  90.      The  source code includes SK, a skeleton program that  SamfB 
  91. was built from.  SK includes "canned" code that handles "Look and 
  92. feel",  "DOS  operations", printer logic, menu  and  help  system 
  93. handlers, and code to handle configuration and data files.
  94.  
  95.      SamfB is currently compiled and linked using Borland's Turbo 
  96. C  on a 384k PC with a 10 megabyte hard disk.   Assembly  modules 
  97. are assembled with Microsoft's MASM 4.0.
  98.  
  99.  
  100.      The source code comes on 5 1/4 inch, low-density diskettes.
  101.  
  102. -----------------------------------------------------------------
  103.  
  104.      Please  support the development of SamfB and its  underlying 
  105. system  by ordering your own, private copy of the program on a  5 
  106. 1/4 inch, low density diskette.  Send $20 to:
  107.  
  108.           Tranzoa, Co.
  109.           P.O. Box 911
  110.           Maple Valley, WA  98038
  111.  
  112.      Your  own copy of SamfB will print your own name instead  of 
  113. Tranzoa's.  Be sure to include the name you want with your order.
  114.  
  115.      Feel free to copy SamfB.  Give it to your friends.
  116.  
  117.      Don't sell SamfB or include it with a product sold for  more 
  118. than $10 without written permission from Tranzoa.
  119.  
  120. -----------------------------------------------------------------
  121.                          SamfB OVERVIEW
  122. -----------------------------------------------------------------
  123.  
  124.      SamfB has 4 logical sections that you can be "in":
  125.  
  126.           1)   The main screen.
  127.           2)   The menu system.
  128.           3)   The help system.
  129.           4)   The colorizer.
  130.  
  131.      You're "in" the MAIN SCREEN - the 2nd through 24th lines  on 
  132. the  screen - when you see a cursor or a black main  screen,  and 
  133. are sending  or receiving Morse code.  In the main screen you can 
  134. be  "in"  one  of six different "modes."  Use  each  mode  to  do 
  135. different  things.  Use the "Free keying" mode, for instance,  to 
  136. send  Morse code to SamfB.  Use the "Practice copying" mode,  for 
  137. instance  to practice recognizing Morse code when SamfB sends  it 
  138. to you.
  139.      You  choose which mode you are in by selecting one  of  them 
  140. from a menu.
  141.  
  142.      You  control  SamfB through the MENU SYSTEM.   SamfB's  menu 
  143. system may be a familiar style to you.  The menus drop down  from 
  144. a  horizontal, top menu.  You move a highlighted scroll-bar  with 
  145. the  arrow  keys, select a menu item with ENTER, and get  out  of 
  146. whatever mess you've gotten into with the ESC (escape) key.
  147.      From  the  main screen, you get the menus  by  pressing  the 
  148. ESCape key.
  149.  
  150.      The  HELP SYSTEM is always available.  You get "into" it  by 
  151. pressing  Function  Key 1 ( F1 ).  The help system is  text  file 
  152. with  "frames" that pop up in windows.  Most have  an  associated 
  153. menu  that  lets  you choose another "frame" to  read.   You  can 
  154. always  use the PgUp and PgDn keys to move between  frames,  too.  
  155. SamfB  can  print the entire help file in a  readable,  paginated 
  156. form.
  157.  
  158.      The  COLORIZER is the program author's son's  favorite  toy.  
  159. It  is  always available at the touch of ALT F10.   It's  serious 
  160. purpose is to let you adjust SamfB so that the screen looks  good 
  161. to you.  Less seriously, it lets you leave your machine at  night 
  162. with a very, very flashy look.
  163.  
  164. -----------------------------------------------------------------
  165.                            ORDER FORM
  166. -----------------------------------------------------------------
  167.  
  168. Tranzoa, Co.
  169. P.O. Box 911
  170. Maple Valley, WA  98038
  171.  
  172. Please send:
  173.  
  174.   SAMFB, SK, OPTION, GUS, RSDRIVE source code       $49 __ copies $___
  175.  
  176.   My own private copy of SAMFB                      $20 __ copies $___
  177.        Private name   [__________________________]
  178.                       [..26 characters, maximum..]
  179.  
  180.   Washington state sales tax (7.9%) (Wash. residents, only).......$___.__
  181.   Total ..........................................................$___.__
  182.  
  183. Name:   __________________________    Company:  _________________________
  184.  
  185. Street: _____________________ City: _______________ State: __  Zip: _____
  186.  
  187.  
  188. -----------------------------------------------------------------
  189.                    END OF "&READ.ME" FOR SamfB
  190. -----------------------------------------------------------------
  191. -----------------------------------------------------------------
  192. 2/17/88
  193.