home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / LCT1012.ZIP / LATECHAT.DOC next >
Text File  |  1991-09-01  |  7KB  |  167 lines
  1.  
  2.  
  3.  LateChat -- A split screen chat program.  By Chris Laforet and Kelly Hughes
  4.  
  5.  
  6.  Purpose:
  7. --------------------
  8.  
  9.         This program is an alternate chat program that can be run from
  10.         a BBS.  Unlike many other external chat programs, this one
  11.         splits the screen and keeps the sysop's typing in the top half
  12.         and the user's typing in the bottom.  By keeping typing
  13.         separated, the sysop and user may type at the same time without
  14.         confusion!
  15.  
  16.         LateChat provides automatic word-wrap, and provides keys to
  17.         redraw screen (remotely or locally), shell to the operating
  18.         system (locally), as well as a quick-hangup key for the sysop.
  19.  
  20.  
  21.  Requirements:
  22. --------------------
  23.  
  24.         The OS/2 version does not require anything except normal OS/2.
  25.         Under DOS, a FOSSIL driver (e.g. Ray Gwinn's X00.SYS) is required.
  26.         This fossil provides interrupt driven input and output and enables
  27.         automatic watching of the carrier detect signal on the modem.
  28.         By providing CD watching, it is not necessary to run LateChat
  29.         from a batch file.
  30.  
  31.         Most DOS bulletin board software is written to be used with the
  32.         fossil, and source code written for the fossil is easily ported
  33.         to other systems for which a fossil exists.
  34.  
  35.         LateChat depends on ANSI escape sequences to control the screen,
  36.         so it must be active for a user that is going to use it. By
  37.         passing the ANSI status in the call from the board, you will
  38.         automatically prevent someone from accidentally using LateChat
  39.         with their graphics flag turned off.  LateChat will give the
  40.         user a message if this happens.
  41.  
  42.  
  43.  Summary screen:
  44. --------------------
  45.  
  46.  If you run LateChat with no parameters, you get a screenload of
  47.  explanation.  Here is a breakdown...
  48.  
  49.  Usage DOS:  LateChat port baud secs ansi firstname lastname [string to show]
  50.  Usage OS/2: LateCht2 port baud secs ansi firstname lastname [string to show]
  51.  
  52.             port  =  DOS: com port being used  (1=com1 2=com2 etc)
  53.  
  54.                     Notice that the port number differs from those of
  55.                     the fossil.  LateChat wants a 1 for Com1, 2 for Com2,
  56.                     0 for local test, etc.  The fossil expects 0 for Com1,
  57.                     1 for Com2, etc.  Keep this in mind if you use a batch
  58.                     file to run latechat that diddles with the fossil.
  59.                    
  60.             port  =  OS/2: com port handle
  61.  
  62.                     In OS/2 you pass the opened handle to the comm
  63.                     port, not the actual port number.
  64.  
  65.  
  66.             baud  =  baud rate of caller as passed from board
  67.  
  68.                     As of version 1.01, 0 is passed to indicate that
  69.                     the port is locked and LateChat should not attempt
  70.                     to set the baudrate.  Otherwise, the board should
  71.                     pass the regular values, such as 2400, 1200, 300, etc.
  72.  
  73.             seconds  =  time to give sysop to hit a key
  74.  
  75.                     This is how long the sysop thinks is the longest
  76.                     time it would take him to get to the keyboard if he
  77.                     is home when the user calls for a chat.
  78.  
  79.             ansi status  =  non-zero value if ansi active
  80.  
  81.                     This is the flag for ANSI from the BBS.  A zero
  82.                     indicates no ANSI enabled for the caller, and
  83.                     makes LateChat give the user a message. Usually a 1
  84.                     means ANSI is enabled, though any non-zero will be
  85.                     interpreted as ANSI turned on.
  86.  
  87.             [string to show]  =  string to display during paging
  88.  
  89.                     This parameter is optional.  If no string is given,
  90.                     LateChat will provide "Paging Sysop ...".  If you
  91.                     desire, any other string can be used, and is just
  92.                     rolled out as entered on the command line.
  93.  
  94.  
  95.  
  96.  
  97.  Keystrokes:
  98. --------------------
  99.  
  100.     During chatting, the following keystrokes perform special functions.
  101.  
  102.         ctrl-R : Redraws screen, including the existing typing.
  103.         ctrl-G : Bell.
  104.         alt-J  : Jump to DOS (if memory permits).
  105.         alt-H  : Hang up on caller.
  106.  
  107.     Alt keys are not passed over modems, so they are not available to the
  108.     remote, but the ctrl key functions are available to the caller.
  109.  
  110.  
  111.  
  112.  Example calls:
  113. --------------------
  114.  
  115.     (notice the fossil is left "hot" during shell by *H param)
  116.  
  117.     Sample Qbbs call for Com1 (type 7) and 12 second page:
  118.         *H c:\qbbs\latechat.exe 1 *B 12 *G *F *L Hollering for sysop...
  119.  
  120.     Sample Qbbs call for Com2 and 14 second page with custom page message:
  121.         *H c:\qbbs\latechat.exe 2 *B 12 *G *F *L Calling Joe Schmoe ...
  122.  
  123.     Sample Simplex call with auto port-picking and 15 sec page (type 240) :
  124.         $* latechat $p $b 15 $a $f $l Paging Sysop...
  125.  
  126.  
  127.  
  128.  Miscellaneous Info:
  129. ---------------------
  130.  
  131.     You might recognize Chris's name as the person who wrote SIMPLEX BBS
  132.     software for both DOS and OS/2, as well as several other goodies
  133.     floating around in OS/2 utility file areas on BBSes.
  134.  
  135.     LateChat was originally conceived and written by Kelly Hughes for a
  136.     BBS program that never got released.  The chat section was rewritten
  137.     from the ground up to use the fossil, and we added the word-wrapping
  138.     and special keystroke functions, and the result is LateChat.
  139.  
  140.     LateChat is released to the public domain and is free for anyone to
  141.     use who finds it of interest. If you have questions, comments,
  142.     postcards of praise, donations for releasing such a robust piece of
  143.     interesting code to the public domain, or just want to say thanks,
  144.     you may reach us at the following locations.  Any new versions of
  145.     LateChat will be found on the boards we run.
  146.  
  147.  
  148.         Chris Laforet                     Kelly Hughes, KB4UAO
  149.         511-D Poplar St                   1217 Teakwood Place
  150.         Graham, NC 27253                  Raleigh, NC 27606
  151.  
  152.         BBS:  Programmer's Oasis          BBS: BedSide Manor
  153.               919-226-6984                     919-233-8566
  154.               9600 HST,2400,1200,300           2400,1200,300
  155.  
  156.               Programmer's Oasis II
  157.               919-226-7136
  158.               9600 HST,2400,1200,300
  159.  
  160.  
  161.  
  162. Version Changes:
  163. ---------------------
  164.  
  165. Version 1.01: CML: Added support for locked baudrates.
  166.  
  167.