home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / BBSKIT31.ZIP / README < prev    next >
Text File  |  1994-01-06  |  6KB  |  112 lines
  1.  
  2.         Welcome to BBSkit!  First, let me thank you for taking an interest in
  3. this package.  I feel that BBSkit is easily the best package of its kind for
  4. BBS and door applications.  (Yes, BBSkit can just as easily be used to write
  5. door programs!)
  6.  
  7. WHAT IS BBSKIT?
  8.  
  9.         BBSkit is just exactly what the name implies: it is a toolkit designed
  10. to help you, as a Pascal programmer, author a BBS.  Usually, a BBS author
  11. needs to be concerned with all kinds of dirty things like serial routines,
  12. time limits, ANSI terminal emulation, and the like.  BBSkit relieves you of
  13. this tedious burden by providing a very complete BBS template.  This template
  14. includes the various procedures and functions needed especially by a BBS
  15. author, such as:
  16.  
  17.         * Both an object and procedural calling method.  The object version
  18.           gives ideal support for a BBS, while the procedural calling method
  19.           is where most of the gritty low-level stuff is contained.  You
  20.           pick the method that works best for you!
  21.  
  22.         * Support for up to 8 simultaneously operating serial ports.
  23.  
  24.         * Low-level serial routines, written in 8088 assembler, to provide up
  25.           to 115,200 bits per second through any kind of National-based UART,
  26.           from the 8250B up to the FIFO buffered 16550A.  And since these
  27.           routines are in assembler, they're FAST!
  28.  
  29.         * FOSSIL support is also included for those that wish to write
  30.           programs that will handle an external FOSSIL as a primary
  31.           communications model (lots of doors do this).
  32.  
  33.         * BBSkit allows you complete control over where I/O goes: the console,
  34.           the serial port, the printer, a disk file, or any combination of
  35.           the four.
  36.  
  37.         * Pascal-like procedures to read and write strings of text, from
  38.           either the console or the serial port, or both at the same time!
  39.  
  40.         * A complete emulation system, allowing you to simply load a template
  41.           and have the complete control over any terminal you desire, from
  42.           simple VT-52 to full-color ANSI.  Now your BBS need only ask for
  43.           a code (for example, to change colors) and BBSkit will return the
  44.           proper string to perform this action, based on the template you have
  45.           loaded.
  46.  
  47.         * Support for the three most popular file transfer protocols,
  48.           including Xmodem (and derivatives), Ymodem and Ymodem-G.  Full
  49.           batching support is included for Ymodem.
  50.  
  51.         * DOS-like "TYPE" procedure, to send entire text files out the serial
  52.           port.  You can also define multiple keys that will interrupt a
  53.           file, which can then be processed as usual (for example: quick
  54.           select of a menu option while the menu is still being displayed).
  55.  
  56.         * Optional paging: when a screen of text fills up without any user
  57.           input, BBSkit can be instructed to wait for the user to press a
  58.           key to continue.  This works with ALL of BBSkit's output procedures.
  59.  
  60.         * Mouse support over a serial connection!  Your programs can now
  61.           allow the remote user to use a mouse to make selections on your
  62.           system, with very little additional coding on your part.
  63.  
  64.         Don't let the toolkit intimidate you.  It may seem hulking and
  65. complicated, but once you get the hang of it, serial communications will never
  66. be easier.  The included BBSKIT.DOC file is a fairly complete excerpt of the
  67. registered version's printed documentation.  This .DOC file will explain all
  68. of the procedures and functions included in BBSkit, and you can use it as a
  69. base for experimenting on your own.
  70.  
  71. INSTALLING THE TOOLKIT
  72.  
  73.         Probably the easiest way of installing the kit is to place it in your
  74. units directory, or a directory in your units path.  Optionally, you can place
  75. the files in your source directory.
  76.  
  77.         If you plan the use the toolkit in real-mode programming (TP6 or BP7
  78. in real mode target), you will need to rename some files.  TP6 users need to
  79. rename the *.TP6 files to *.TPU, and BP7 users will need to rename the *.TP7
  80. files to *.TPU.  Example:  REN *.TP7 *.TPU
  81.  
  82.         Additionally, you will need to unzip the MTASK archive contained here.
  83. MTASK is a public domain unit that provides multithreading in Turbo Pascal
  84. programs and is used by BBSkit 3.0+.  You can use any type of unzipper,
  85. including the one provided for TP6+ installations, to unarchive this file.
  86. PLEASE NOTE THAT MTASK WAS NOT WRITTEN BY BBSKIT'S AUTHOR!  I don't claim any
  87. credit for writing it; I just think it's a great unit and really useful.
  88.  
  89. COMMENTS OR QUESTIONS?
  90.  
  91.         If you have any comments or questions regarding BBSkit, I would love
  92. to hear from you!  You can reach me in several ways:
  93.  
  94. Home address: 1888 Edith Marie Drive
  95.               Beavercreek, OH  45431-3377
  96.               USA
  97.  
  98. CompuServe:   >INTERNET:sjmadsen@miavx1.acs.muohio.edu
  99. Internet:     sjmadsen@miavx1.acs.muohio.edu
  100. BITNET:       SJMADSEN@MIAVX1
  101.  
  102.         The latest version of BBSkit is always available on the Internet and
  103. is available for anonymous ftp at any time.  ftp to ftp.cas.muohio.edu and
  104. look in the directory /pub/dos/bbskit.  There are also some examples here as
  105. well as information which may be of interest to BBSkit users.  See the manual
  106. for more information on the ftp site and the mailing list which has been
  107. started for BBSkit users.
  108.  
  109.  
  110.         Thanks again, and enjoy BBSkit!
  111.  
  112.