home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / cprog / spp.zip / READ.ME < prev    next >
Text File  |  1991-02-07  |  10KB  |  231 lines
  1.  
  2.      Serial++ Library
  3.      ----------------
  4.      
  5.      Serial Communications Support for Borland C++
  6.      Quality Software from Cortlandt Technologies.
  7.  
  8.      Copyright (c) 1991 Cortlandt Technologies. All rights reserved.
  9.  
  10.  
  11.      Introduction:
  12.      -------------
  13.  
  14.      Serial++ is a library of small, safe, and efficient routines
  15.      that bring interrupt driven serial port support to your
  16.      C++ programs compiled and linked with the Borland C++ compiler.
  17.  
  18.      The routines in Serial++ are as easy to use as console i/o in C,
  19.      yet give you complete access to the registers of the 8250 UART,
  20.      should your program require it.
  21.  
  22.      Implemented as C++ classes, the Serial++ library handles multiple 
  23.      ports and multiple instantiations with ease.
  24.  
  25.      Finally, Serial++ is protected against keyboard breaks, to insure 
  26.      that any application that uses communications can complete the
  27.      necessary housekeeping before terminating. You can also use the 
  28.      break trapping provided with Serial++ in you own programs,
  29.      independtly from the port support.
  30.  
  31.      Serial++ is linked into your Borland C++ programs just like any
  32.      other library... there are no TSR's or assembly coding required.
  33.      
  34.      
  35.      Installation:
  36.      -------------
  37.  
  38.      Serial++ is contained in a self-extracting compressed file,
  39.      named SPP.EXE. Copy this file to the directory where you plan
  40.      to be compiling and linking your code, and run it.
  41.  
  42.      The file named PACKING.LST contains a list of all the files that
  43.      are included with Serial++, and a brief description of each.
  44.  
  45.      Serial++ expects to find its include files, SERIAL.H and BREAK.H,
  46.      and its library files, SPP?.LIB, in the compiler's search path.
  47.      There are several ways to accomplish this, the easiest of which
  48.      is to copy these files into the directory where you compile your
  49.      source.
  50.  
  51.      For other approaches, see the manual on this topic.
  52.  
  53.  
  54.      Documentation:
  55.      --------------
  56.  
  57.      In addition to this file, you will find two other documentation files
  58.      in this package.  PACKING.LST lists all the files that make up this
  59.      package, along with a description of each.
  60.  
  61.      SPPMAN.TXT is an ASCII image of the Serial++ manual, ready to print
  62.      on any 66 lines/page printer setup. To print the manual, ready your
  63.      printer, and then issue this command:
  64.  
  65.            C:>copy SPPMAN.TXT PRN:
  66.  
  67.      The manual contains the only complete function reference in the 
  68.      package.  It is about fifty pages long.
  69.  
  70.  
  71.      Getting Started:
  72.      ----------------
  73.  
  74.      The easiest way to get started with Serial++ is to take a look at the
  75.      simple demo program supplied: SPPDEMO.EXE. Source code for this
  76.      program, along with a make file (for Borland make) are included.
  77.  
  78.      This program allows you to carry on a simple conversation with the
  79.      com port of your choice, setting the port, speed, and other parameters
  80.      from the command line. Typing SPPDEMO without any parameters will
  81.      display this quick help message:
  82.  
  83.  
  84.            Type $$$ at prompt or press Ctrl-Break to exit.
  85.  
  86.            Usage: [sppdemo [port [baud [databits [parity [stopbits]]]]]]
  87.  
  88.                port = COM1 | COM2
  89.                baud = 2400 | 1200 | 300
  90.            databits =    8 |    7
  91.              parity = NONE | EVEN | ODD
  92.            stopbits =    1 |    2
  93.  
  94.            Example (defaults):   sppdemo COM1 1200 8 N 1
  95.  
  96.  
  97.      Serial++ is Shareware:
  98.      ----------------------
  99.  
  100.      Serial++ is being marketed as shareware, which means you have the
  101.      opportunity to evaluate this product before buying it, and you may
  102.      also distribute copies of it to others under certain conditions
  103.      explained below.
  104.      
  105.      Shareware distribution gives users a chance to try software before 
  106.      buying it. If you try a Shareware program and continue using it, you 
  107.      are expected to register. Individual programs differ on details 
  108.      -- some request registration while others require it, some specify a 
  109.      maximum trial period. With registration, you get anything from the 
  110.      simple right to continue using the software to an updated program with 
  111.      printed manual.
  112.  
  113.      Copyright laws apply to both Shareware and commercial software, and the 
  114.      copyright holder retains all rights, with a few specific exceptions as 
  115.      stated below. Shareware authors are accomplished programmers, just like 
  116.      commercial authors, and the programs are of comparable quality. 
  117.      (In both cases, there are good programs and bad ones!) The main 
  118.      difference is in the method of distribution. The author specifically 
  119.      grants the right to copy and distribute the software, either to all and 
  120.      sundry or to a specific group. For example, some authors require written
  121.      permission before a commercial disk vendor may copy their Shareware.
  122.  
  123.      Shareware is a distribution method, not a type of software. You should 
  124.      find software that suits your needs and pocketbook, whether it's 
  125.      commercial or Shareware. The Shareware system makes fitting your needs 
  126.      easier, because you can try before you buy. And because the overhead 
  127.      is low, prices are low also. Shareware has the ultimate money-back 
  128.      guarantee -- if you don't use the product, you don't pay for it.
  129.  
  130.      Note that no capabilities or features are left out of this evaluation
  131.      copy -- this is a complete fully functional release of Serial++.
  132.  
  133.      
  134.      Registering Serial++
  135.      --------------------
  136.  
  137.      If you like Serial++ and wish to continue using it after a 30-day trial
  138.      period, you must pay the $24.95 registration fee. A registration form
  139.      is included with this package in file REGISTER.TXT
  140.  
  141.      You MUST register Serial++ if you intend to distribute your own
  142.      software that uses it.  Once you have paid the one time registration
  143.      fee, there are no other royalties or restrictions on distributing
  144.      your own software that includes Serial++.
  145.  
  146.      Registration entitles you to a printed manual, complete C++ source,
  147.      license to distribute software you build using Serial++, technical
  148.      support by mail or via Compuserve for 1 year, and notice of
  149.      version upgrades and new product announcements.
  150.  
  151.      For complete details of Serial++ license and registration information,
  152.      please read the appropriate sections in the manual, SPPMAN.TXT.
  153.  
  154.  
  155.      Distributing Serial++
  156.      ---------------------
  157.  
  158.      Please distribute Serial++ in its original compressed file to
  159.      any interested friends and colleagues, and to upload it to any BBS's 
  160.      that you use.  
  161.      
  162.      If you distribute Serial++ via diskette, you may not charge anything
  163.      for the program, although you may impose whatever nominal charge is
  164.      required to pay for the disk media and handling.
  165.      
  166.      Anyone distributing Serial++ for any kind of remuneration must first 
  167.      contact Cortlandt Technologies at the address below for authorization.
  168.      This authorization will be automatically granted to distributors
  169.      recognized by the (ASP) as adhering to its guidelines for shareware 
  170.      distributors, and such distributors may begin offering Serial++ 
  171.      immediately (However Cortlandt Technologies must still be advised so
  172.      that the distributor can be kept up-to-date with the latest version of 
  173.      Serial++.).
  174.  
  175.      For complete details of the Serial++ limited distribution license 
  176.      please read the appropriate sections in the manual, SPPMAN.TXT.
  177.  
  178.  
  179.      Disclaimer:
  180.      -----------
  181.                  
  182.      Users of Serial++ must accept this disclaimer of warranty:
  183.      Serial++ is supplied as is.  The author disclaims all warranties, 
  184.      expressed or implied, including, without limitation, the warranties of 
  185.      merchantability and of fitness for any purpose. The author assumes no 
  186.      liability for damages, direct or consequential, which may result from 
  187.      the use of Serial++.
  188.  
  189.      
  190.      ASP:
  191.      ----
  192.                  
  193.      This program is produced by a member of the Association of
  194.      Shareware Professionals (ASP).  ASP wants to make sure that the
  195.      shareware principle works for you. If you are unable to resolve a
  196.      shareware-related problem with an ASP member by contacting the
  197.      memberdirectly, ASP may be able to help. The ASP Ombudsman can
  198.      help you resolve a dispute or problem with an ASP member, but
  199.      does not provide technical support for members' products.  Please
  200.      write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  201.      or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  202.      70007,3536.
  203.  
  204.           
  205.      And Finally...
  206.      --------------
  207.  
  208.      Thank you for taking the time to evaluate Serial++ and for supporting
  209.      the shareware concept.
  210.  
  211.      Please feel free to contact me if you have any questions about Serial++
  212.      or require additional information.
  213.  
  214.        Mike Aiello
  215.        Cortlandt Technologies
  216.        P.O. Box 195
  217.        Pleasantville, NY 10570
  218.  
  219.        Compuserve: 71066,155
  220.                                             _______
  221.                                        ____|__     |                (R)
  222.                                     --|       |    |-------------------
  223.                                       |   ____|__  |  Association of
  224.                                       |  |       |_|  Shareware
  225.                                       |__|   o   |    Professionals
  226.                                     -----|   |   |---------------------
  227.                                          |___|___|    MEMBER
  228.           
  229.           
  230. 
  231.