home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CHATR104.ZIP / CHAT104.EXE / CHATTER.DOC < prev    next >
Encoding:
Text File  |  1995-04-12  |  11.3 KB  |  253 lines
  1.  
  2.             ▀▀▀▀▀  ▀▀   ▀▀  ▀▀▀▀▀  ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀
  3.            ▀▀   ▀▀ ▀▀   ▀▀ ▀▀   ▀▀    ▀▀       ▀▀    ▀▀      ▀▀   ▀▀
  4.           ▀▀▀      ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀    ▀▀       ▀▀    ▀▀▀▀▀   ▀▀▀▀▀▀
  5.            ▀▀   ▀▀ ▀▀   ▀▀ ▀▀   ▀▀    ▀▀       ▀▀    ▀▀      ▀▀  ▀▀
  6.             ▀▀▀▀▀  ▀▀   ▀▀ ▀▀   ▀▀    ▀▀       ▀▀    ▀▀▀▀▀▀▀ ▀▀   ▀▀
  7.              Voice chat utility for SysOps who are tired of typing!
  8.                         (C) Copyright 1995, Alex Demko
  9.                               All rights reserved.
  10.  
  11. (This document is designed to be viewed, not printed. Each Section
  12.  begins with a "***" so you could jump around the document by just setting
  13.  you viewer to search for those three asterisks.)
  14.  
  15. Sections:
  16.  Introduction
  17.  Installing
  18.  Upgrading
  19.  Running
  20.  Added Features
  21.  ShareWare
  22.  Legal Stuff
  23.  Contacting the Author
  24.  
  25. *** Introduction
  26.  
  27.     The need for CHATTER was first realized when I would look back at my
  28.     chat log and see how long it was. There was enough material in those
  29.     logs to make a small novel! :) At that time I realized how slow people
  30.     typed. Even the faster typists could never keep up with the speed of
  31.     a normal conversation, so it hit me: Wouldn't it be nice if we could
  32.     hang the modems up and voice chat for a while? So I whipped out my
  33.     compiler and a few weeks later, out came CHATTER!
  34.  
  35.     CHATTER does exactly that. First it asks the user why he is bugging
  36.     the SysOp. It then asks the user if they have a phone plugged into
  37.     their modem. If they don't CHATTER will allow them to chat using
  38.     the conventional method of typing. CHATTER then pages the SysOp
  39.     using one of the many sounds (configurable). If the SysOp is there
  40.     CHATTER then arranges the voice chat (or normal chat if the user
  41.     does not have a phone).
  42.  
  43.     CHATTER then waits until you are done and re-establishes the link.
  44.     When the modem link up, CHATTER returns the user back to the BBS
  45.     were he can continue doing his BBS activities.
  46.  
  47.     CHATTER's abilities:
  48.        - A FOSSIL driver is required. (like X00 or BNU)
  49.        - Supports COM1-COM255
  50.        - Optional multi-tasker and multi-node BBS.
  51.        - Works on any BBS that makes DOOR.SYS or DORINFO1.DEF dropfiles.
  52.          (more formats may be supported on request)
  53.        - Selectable Sound, Chat log, SysOp chat hours and Sysop chat hours
  54.          override.
  55.        - Most Options are auto-detected.
  56.  
  57.         All communications is done via the FOSSIL driver. Because of
  58.         this, you can have ports re-mapped (i.e. non-standard IRQs &
  59.         Addresses) different kinds of flow control and super high
  60.         speeds and this door will still work fine. Communications are
  61.         more standardized and thus more stable. You communications setup
  62.         is only limited by your FOSSIL driver's abilities.
  63.  
  64. *** Installing
  65.  
  66.     1. UnZip CHATTER into it's own directory.
  67.     2. Make a batch file that will move the DOOR.SYS dropfile
  68.        into CHATTER's directory, then executes CHATTER.EXE.
  69.        If you are using a DORINFO1.DEF dropfile, then just replace
  70.        DOOR.SYS with DORINFO1.DEF in the batch file. Also, if your
  71.        software actually creates DORINFOx.DEF dropfiles, where x is the
  72.        node, then you must rename them to DORINFO1.DEF. (i.e. place a
  73.        "REN DORINFO?.DEF DORINFO1.DEF" command before CHATTER.EXE)
  74.  
  75.        Example: CHATTER.BAT
  76.        ────────────────────────
  77.        @ECHO OFF
  78.        COPY \RENEGADE\DOOR.SYS \DOORS\CHATTER       <moves the dropfile
  79.        CD \DOORS\CHATTER                            <goes to the dir.
  80.        CHATTER                                      <runs CHATTER
  81.        CD \RENEGADE                                 <goes back to home dir.
  82.        ────────────────────────
  83.     3. Make a menu selection in your BBS program to run CHATTER.BAT.
  84.        It is recommended that you replace your old chat program with
  85.        CHATTER. For example, if the user presses C to chat with you,
  86.        you should intercept all the Cs to drop to CHATTER instead.
  87.     4. Run CHATSET.EXE to create the CHATTER.INI file and configure
  88.        CHATTER.
  89.        (see the Running section for details)
  90.  
  91. *** Upgrading
  92.  
  93.     To upgrade from a previous version of chatter simply copy the new
  94.     EXEs over the old ones.
  95.  
  96.     Note to registered SysOps: You should have a print out of your
  97.     registration key just incase you CHATTER.INI should somehow become
  98.     lost/corrupt.
  99.  
  100. *** Running
  101.  
  102.     To run CHATTER successfully you must configure your modem correctly.
  103.     You must find the command for your modem that disables dial tone
  104.     detection. The line (in CHATTER.INI):
  105.  
  106.  HangUp=^~ATX1|
  107.  
  108.     Not only causes the modem to hang up, but turns off dial tone detection.
  109.     The "^" toggles the DTR, which hangs up most modems, and the "ATX1|"
  110.     turns off dial tone detection. This command works for a USR Sportster
  111.     14,400, and you may have a different command for your modem.
  112.  
  113.     To re-establish the link one modem must originate (ATD) and the
  114.     other must receive (ATA). The line:
  115.  
  116.  Link=ATD|
  117.  
  118.     Must be the originate command for your modem. Notice how there is no
  119.     phone number like ATDT1234567, this is because the phone link is
  120.     already established by your voice conversation, so the only thing
  121.     left is for the modems to hook up. That is why we must also
  122.     disable dial tone detection, because when your modem types ATD it
  123.     will hear you talking and not a dial tone, so if dial tone detection
  124.     was active the modem would come back with a "NO DIAL TONE" error.
  125.  
  126.     When you have these lines correctly configured you're ready to go.
  127.     When a user is in the door, the only thing you are supposed to do is
  128.     watch the StatBar at the bottom. It will give you, the SysOp, online
  129.     instructions as needed.
  130.  
  131.     When you are done talking with the user, you must tell him to
  132.     type ATA<ENTER>. You MAY then here a little click, this is the user's
  133.     modem about to enter answer mode. You must then IMMEDIATELY press
  134.     [SPACE]. Do NOT hesitate! If you do not hear any clicks then you must
  135.     make sure you press space before he presses <ENTER> after ATA. The
  136.     important part is that you press SPACE BEFORE he presses ENTER.
  137.     Pressing [SPACE] sends your link command, which by default is ATD|.
  138.     The modems then re-establish the link and the user's BBS session
  139.     continues as usual.
  140.  
  141. *** Added Features
  142.  
  143.     Also, if for some reason to want to be able to be paged at off-hours
  144.     then create a file in the CHATTER directory called "IN.FLG". You will
  145.     always be available for chat if this file exists in your directory.
  146.     To go with IN.FLG, you may also create "OUT.FLG". If this file exists
  147.     in your CHATTER dir, you will not be available for chat until it is
  148.     deleted.
  149.  
  150.     Similar to the *.FLGs you may also use the scroll lock to set your
  151.     hours. If you set the scroll lock field in the setup program to "Here"
  152.     then whenever the scroll lock is ON, your are considered available
  153.     for chat. Alternatively, if the field is set to "Gone" then as long
  154.     as the scroll lock is on, you are NOT available for chat.
  155.  
  156.     For more customization, you may also create an ASCII file, NOHOURS.ASC
  157.     and/or an ANSI file NOHOURS.ANS in CHATTER's directory. When a user
  158.     attempts to chat with you out of the set chat hours, the appropriate
  159.     file will be displayed (.ASC for ASCII users, .ANS for ANSI users)
  160.     instead of CHATTER's internal generic message. Note that if there is
  161.     no .ANS file for an ANSI user, they will receive the .ASC file (if
  162.     it exists). Your message may contain info on how to send email to
  163.     you or your chat hours etc.
  164.  
  165.     You may also create a similar pair of files, NOPAGE.ASC & NOPAGE.ANS,
  166.     that work the same way as NOHOURS.* except that they will be displayed
  167.     after user pages you and you do not answer. This file should contain
  168.     info on how to send email to you.
  169.  
  170.     CHATTER also has multi-node support via a flag file, INUSE.FLG. If
  171.     CHATTER for some reason is not able to quit properly then the flag
  172.     file will not be deleted, in which case you, the SysOp must go and
  173.     delete it manually.
  174.  
  175. *** ShareWare
  176.  
  177.     This program represents many hours of work and many more testing.
  178.     To compensate for my time spent in making this program I am asking a
  179.     very small fee: $5 Canadian or $4 US.
  180.  
  181.     I believe this is a small price to pay for a program that will
  182.     making chatting a lot easier and more fun.
  183.  
  184.     When you register you get:
  185.         - No more delays
  186.         - Full chat hours configurability including the use of the
  187.           flag files and scroll lock.
  188.         - A relieved conscience in knowing that you are promoting
  189.           ShareWare and allowing it to grow. With out your dollars fine
  190.           programs like this would never exist!
  191.  
  192.     To register fill out and print REGISTER.TXT and mail it to the shown
  193.     address. Upon receiving your payment you will be sent you key which
  194.     will unlock all the features mentioned above. You will receive your
  195.     key via direct fido netmail, PGP (if you send your public key)
  196.     encrypted internet email or land mail.
  197.  
  198. *** Legal Stuff
  199.  
  200.     This entire program including the documentation is
  201.     (C) Copyright 1995, Alex Demko. All rights reserved.
  202.  
  203.     The unregistered version may be distributed freely as long as it
  204.     is not modified in any way. No fees may be charged for copying
  205.     (excluding reasonable coping fees).
  206.  
  207.     The registered version is to be treated as commercial software, as
  208.     such may not be copied (except to make personal backups). Using
  209.     a registered version on your BBS that you did not register is
  210.     considered and illegal act, and will be treated as such.
  211.  
  212.     I do not take ANY responsibility for the use or misuse of this
  213.     product. USE AT YOU OWN RISK!
  214.  
  215. *** Contacting the Author
  216.  
  217.     Contact me if you have any comments/suggestion/bugs/spelling errors
  218.     etc. Priority will be given to registered SysOps.
  219.  
  220.     To contact me send mail to:
  221.         Alex Demko        │  Internet: Alex_Demko@MBNet.MB.CA
  222.         P.O. Box  #1432   │  Fidonet: Alex_Demko@MBNet.MB.CA on 1:1/31
  223.         Winnipeg, MB      │  BBS:(204)632-0596, Email: Crusader
  224.         R3C 2Z4           │
  225.  
  226.     To get the latest versions call one of the distribution sites:
  227.     (login as GUEST or FREQ it as "CHATTER")
  228.            Five Starr BBS  (204) 632-0596
  229.                            (204) 632-4696
  230.            LadyDi's BBS    (412) 856-0784
  231.              1:129/275     (412) 373-5395 {28.8}
  232.  
  233.     Or if your on the Internet:
  234.         FTP: ftp.mbnet.mb.ca          DIR: /pub/ademko
  235.         Web URL: ftp://ftp.mbnet.mb.ca/pub/ademko/
  236.  
  237.     If you wish to become a distribution site please contact me.
  238.  
  239. -----BEGIN PGP PUBLIC KEY BLOCK-----
  240. Version: 2.6
  241.  
  242. mQCNAi4r59EAAAEEANUVAjbl6wDLePs0KZNyD6aRCqPhz09KtrqOjcOUB4JbPLNr
  243. OPF59/ft4PRzB8pbLhK0qsX39bt2lPdTOQIwAMwfjVwjkaLK57iVpFhvi1+2hmCr
  244. pJjRHVNaPEaqf2VE4/24+76VhthQg/sr90qGFDnHKSn4dRSJmlivi/f0SqqNAAUR
  245. tCZBbGV4IEIuIERlbWtvIDxhbGV4X2RlbWtvQG1ibmV0Lm1iLmNhPokAlQIFEC4s
  246. j3FYr4v39EqqjQEB3pUEAILKGnYQV189sRi/Jofqp3EvErDX26ePWPd/X+ioXQpw
  247. hYHXD3Zp7KlXlU//J6l7mi5mSSI0hVac4XVBOzcNgYfU3v343UX+CW3aBfF2G/I1
  248. MAfh5806kEU4BBrm4Gha0f/oaEsIllY5jxAzu4zj5WoAIixCS43xRmbGFhfMm/lB
  249. tCpBbGV4IEIuIERlbWtvIDxhbGV4X2RAc3lzNjYyNi5iaXNvbi5tYi5jYT4=
  250. =5rUf
  251. -----END PGP PUBLIC KEY BLOCK-----
  252.  
  253.