home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / scht503r.zip / SCHAT!.DOC < prev    next >
Text File  |  1993-04-30  |  33KB  |  815 lines
  1.  
  2.    ┌──────┐ ┌──────┐ ┌─────┐  ┌─────┐ ┌─────┐ ┌─────┐ ┌─┐ ┌─┐ ┌─────┐ ┌─────┐
  3.    └──────┘ └──────┘ └─────┘  └─────┘ └─────┘ └─────┘ └─┘ └─┘ └─────┘ └─────┘
  4.    ┌──────┐ ┌──────┐ ┌──────┐ ┌─────┐ ┌──┐    ┌─┐     ┌─────┐ ┌─────┐   ┌─┐
  5.    └────┐ │ │ ┌──┐ │ │ ┌──┐ │ │ ┌┐ ┌┘ │ ┌┘    │ │     │ ┌─┐ │ │ ┌─┐ │   │ │
  6.    ┌────┘ │ │ │  │ │ │ └──┘ │ │ ││ │  │ └───┐ │ └───┐ │ │ │ │ │ │ │ │   │ │
  7.    └──────┘ └─┘  └─┘ └──────┘ └─┘└─┘  └─────┘ └─────┘ └─┘ └─┘ └─┘ └─┘   └─┘
  8.  
  9.           SabreChat! Version 5.02.00 Copyright (C) 1993 Shawn Gresham
  10.  
  11.  
  12. What is SabreChat!?
  13. ───────────────────
  14.  
  15.         SabreChat! is simply a user to user chat program. It is run
  16.         from each node of a bulletin board system allowing the users
  17.         online to talk with each other.  This connection is made
  18.         possible by the SabreMixer! TSR that comes with the SabreChat!
  19.         package.
  20.  
  21.         This SabreChat! version has the following features:
  22.  
  23.           Line-by-line or character-by-character chat modes that
  24.           are toggled by the user.
  25.  
  26.           Communication between nodes separated by a multi-tasker or a
  27.           network in character-by-character mode.  Disk-based
  28.           communication in line-by-line mode.
  29.  
  30.           Full ANSI color coding support.
  31.  
  32.           Multiple conferencing support for more than one chat session
  33.           at the same time.
  34.  
  35.           Supports up to 50 nodes.
  36.  
  37.           Sysop-defined action commands for user entertainment.
  38.  
  39.           Sysop-defined questionnaire feature to give each user
  40.           more identity.
  41.  
  42.           Three different prompting modes for user identification.
  43.  
  44.           Ability to capture conversations to a text file.
  45.  
  46.           Log file generation.
  47.  
  48. By The Way
  49. ──────────
  50.  
  51.         SabreChat! is distributed as shareware with nothing stating
  52.         the user has to register the program within a certain number
  53.         of days.  The unregistered version of SabreChat! has a
  54.         built-in limitation of 10 minutes for each execution and no
  55.         other limitations.  There is no restriction for use by
  56.         corporations or govermental agencies.  The software is
  57.         distributed as is.  I am not liable for any damage cause by
  58.         the use of this software.
  59.  
  60.         Trademarks of any companies mentioned in this doc appears for
  61.         identification purposes only and likewise, belong to their
  62.         respective companies.
  63.  
  64. Requirements
  65. ────────────
  66.  
  67.         The following are required to execute SabreChat!:
  68.  
  69.                 8086 or better
  70.                 DOS 3.3 or newer
  71.                 a communication fossil for port access
  72.                 SHARE.EXE must be loaded
  73.  
  74.         SabreChat! uses the following files:
  75.  
  76.         File            Description                     Found
  77.         ─────────────── ───────────────────────         ───────
  78.         SCHAT!.EXE      Main Executable                 archive
  79.         SCHT!WC.DOC     Documentation                   archive
  80.         SMIXER!.COM     SabreMixer!                     archive
  81.         SMIXER!.DOC     Doc for SabreMixer!             archive
  82.  
  83.         SCHT!HI.ASC     welcome text (ASCII)            archive
  84.         SCHT!HI.ANS     welcome text (ANSI)             archive
  85.         SCHT!HLP.ASC    help text (ASCII)               archive
  86.         SCHT!HLP.ANS    help text (ANSI)                archive
  87.         SCHT!MNU.ASC    menu text (ASCII)               archive
  88.         SCHT!MNU.ANS    menu text (ANSI)                archive
  89.  
  90.         SCHT!ACT.EXE    action compiler                 archive
  91.         SCHT!ACT.TXT    sample actions (text)           archive
  92.         SCHT!ACT.DAT    sample actions (compiled)       archive
  93.  
  94.         SCHT!REG.EXE    registration program            archive
  95.         SCHT!KEY.DAT    registration key file           created
  96.  
  97.         SCHT!QST.EXE    questionnaire compiler          archive
  98.         SCHT!ASK.TXT    questionnaire questions         archive
  99.         SCHT!QST.TXT    uncompiled questionnaire data   archive
  100.         SCHT!QST.DAT    compiled questionnaire data     created
  101.  
  102.         SCHT!USR.SWD    user data                       created
  103.         SCHT!CNF.SWD    conference data                 created
  104.         SCHT!LIN.SWD    line data                       created
  105.         SCHT!LOG.SWD    log file                        created
  106.         SCHT!CAP.xxx    capture file for node xxx       created
  107.         SCHT!ALS.SWD    user alias information          created
  108.         SCHT!NFO.SWD    user questionnaire information  created
  109.  
  110.                 ARCHIVE = found in the SabreChat! archive.
  111.                 CREATED = created by SabreChat!.
  112.  
  113.  
  114. Registering SabreChat!
  115. ──────────────────────
  116.  
  117.         The copy of SabreChat! that you possess is the full-working
  118.         version with only one drawback.  Users are limited to ten
  119.         minutes in the door before they are returned to the board.
  120.         Afterwards they may return to SabreChat! for another ten
  121.         minutes and so on.  This limitation is merely to allow the
  122.         user and sysop to have a sufficent evaluation periods to
  123.         determine if they wish to register SabreChat!.
  124.  
  125.         Why register at all then?  Well, there are few reasons you
  126.         might consider...
  127.  
  128.         1) Upon registration, you will be added to a list of names
  129.            that I personally inform when a newer version of SabreChat!
  130.            comes out.
  131.  
  132.         2) You will receive priority support, in the unlikely event that
  133.            you run into any problems or if you just have some questions.
  134.  
  135.         3) Registrations keep me informed on just how interested
  136.            people are in my software.  If I don't receive any feedback
  137.            then I can only assume that my efforts were in vain and I
  138.            should find something else to do.
  139.  
  140.         4) Registrations are forever.  Once registered, you will never
  141.            have to register for a newer version of SabreChat!.
  142.  
  143.         5) Upon receiving the registration key, the ten minute
  144.            limitation will be removed.
  145.  
  146.         To register SabreChat!, please fill out the registration form
  147.         included in the archive and send fifteen US dollars ($15 US)
  148.         address found at the end of this document.
  149.  
  150.         Be sure that the names given are the names that you wish to
  151.         appear in the registration.  The registration will look
  152.         similar to this:
  153.  
  154.         Registered to SHAWN GRESHAM of MAXIMUM INTENSITY.
  155.                       -------------    -----------------
  156.  
  157.         The information is merely for my records so that I can keep
  158.         tabs on where the program is headed and such.  Plus the
  159.         comments and suggestion are invaluable to the production of
  160.         future versions.
  161.  
  162.  
  163. Installation
  164. ────────────
  165.  
  166.         To install SabreChat! please read the installation text file
  167.         also included in this archive.  This fill will be called
  168.         INST!xxx.DOC with xxx being the bbs software type.
  169.  
  170.                 RA  = Remote Access
  171.                 WC  = Wildcat
  172.                 TAG = TAG BBS
  173.  
  174.         Also note that though all of the installation docs for each
  175.         system (RA/WC/TAG) are included, only the system supported
  176.         by Schat!.exe will work.
  177.  
  178.         NOTE:  I have included a user tutorial text file,
  179.                SCHT!USR.DOC, that can be set up as a bulletin on your
  180.                system to help people get the hang of SabreChat!.
  181.  
  182.  
  183. Customizing SabreChat!
  184. ──────────────────────
  185.  
  186.         Using the installation instructions, you should have a
  187.         standard working version of SabreChat!.  The following section
  188.         gives a list of command line options that you can use to
  189.         customize the way SabreChat! works on your system.  I would
  190.         recommend make very few changes until you are certain that the
  191.         base setup will operate correctly.   Customizing would
  192.         complicate debugging a problem.
  193.  
  194.         Note that some options are already set by the DOOR.SYS or
  195.         DORINFO1.DEF file for you.  These commands are identified by
  196.         having [DOOR.SYS] or [DORINFO1.DEF] after their name. Normally
  197.         you would not have to set these commands unless you wanted to
  198.         over-ride the DOOR.SYS or DORINFO1.DEF settings.
  199.  
  200.         The command line parameters are listed in the following
  201.         format:
  202.  
  203.         Option <letter>, <short description> [DOOR.SYS] [DORINFO1.DEF]
  204.  
  205.                 <full description>
  206.  
  207.                 Usage   : SCHAT! <option usage description>
  208.                 Default : SCHAT! <example>
  209.                                 Example of how to activate option from
  210.                                 command line.
  211.                           DOOR.SYS
  212.                                 Means that the option is read from
  213.                                 DOOR.SYS if the Y option has been set.
  214.                           DORINFO1.DEF
  215.                                 Means that this option will be set if
  216.                                 you use the O (read dorinfo1.def)
  217.                                 option.
  218.                           None
  219.                                 Means that the option has no default
  220.                                 value or is not activated by default.
  221.                           AutoDetect
  222.                                 Means that SabreChat! tries to
  223.                                 determine this value when it is
  224.                                 executed, and that by setting this
  225.                                 option, you are overriding the
  226.                                 detected value.
  227.  
  228.  
  229.         Option A, Select Graphics Mode [DOOR.SYS] [DORINFO1.DEF]
  230.  
  231.                 This command is set by DOOR.SYS and DORINFO1.DEF.
  232.  
  233.                 This command selects the graphic codes that SabreChat!
  234.                 uses to send colors to an online user.  SabreChat!
  235.                 supports two standard graphic conventions, ANSI and
  236.                 AVATAR. This option will be set by DOOR.SYS and
  237.                 DORINFO1.DEF, if you are using option Y or O, based on
  238.                 the user's flags in RA.
  239.  
  240.                 Usage : SCHAT! A<0..3>
  241.  
  242.                         0       No graphic codes
  243.                         1       ANSI graphics
  244.                         2       AVATAR graphics
  245.                         3       Both ANSI and AVATAR
  246.  
  247.                 Example : SCHAT! A1
  248.                 Default : SCHAT! A0 or DOOR.SYS or DORINFO1.DEF
  249.  
  250.         Option B, Black and White Local Screen
  251.  
  252.                 This command informs SabreChat! not to use colors
  253.                 locally.   Color codes will still be sent to the user
  254.                 online.  This is necessary on some black and white
  255.                 monitors that translate certain colors as black and
  256.                 cannot been seen against the black background.
  257.  
  258.                 Usage : SCHAT! B
  259.                 Default : Color used.
  260.  
  261.         Option C, Set Default Conference Name
  262.  
  263.                 This option sets the conference name that user will
  264.                 be joined to when he enters SabreChat!.
  265.  
  266.                 Usage   : SCHAT! C<conference name>
  267.                 Example : SCHAT! CCOMICS
  268.                 Default : SCHAT! CPUBLIC
  269.  
  270.         Option E, Enable DOS 3.3 COMMIT flushing
  271.  
  272.                 This option enables file flushing for some of the
  273.                 temporary files that SabreChat! uses to communicate.
  274.                 Enabling this will slow down operation a tad, but will
  275.                 ensure that the data gets written to the disk as soon
  276.                 as possible.  Do not use this unless some nodes are
  277.                 receiving the wrong text lines (ie. old lines of text
  278.                 or massive garbage, etc).
  279.  
  280.                 Usage   : SCHAT! E
  281.                 Default : Inactive
  282.  
  283.         Option F, Set Page Search Frequency
  284.  
  285.                 This command defines the frequency that SabreChat!
  286.                 checks to see if someone has paged you while in
  287.                 SabreChat!. SabreChat! looks for pages once every 5
  288.                 seconds by default.  Using the F command line option,
  289.                 you can change this value or disable page checking
  290.                 entirely by setting it to zero.
  291.  
  292.                 Usage   : SCHAT! F<frequency in seconds or 0 (disabled)>
  293.                 Default : SCHAT! F5
  294.  
  295.         Option G, Log Activity
  296.  
  297.                 This option creates a file called SCHT!LOG.SWD and
  298.                 logs the doors activity.  You can safely delete this
  299.                 file whenever it becomes to larger and SabreChat! will
  300.                 create a new one.  This keeps a list of who enters and
  301.                 leaves and any errors that may occur.
  302.  
  303.                 Usage: SCHAT! G
  304.                 Default: Disabled.
  305.  
  306.         Option I, Set SabreMixer! Interrupt Number
  307.  
  308.                 This option sets the interrupt number that SabreChat!
  309.                 will expect to find SabreMixer! installed.  The default
  310.                 for SabreChat! is interrupt $66.  If you suspect an
  311.                 interrupt conflict with other software, be sure to change
  312.                 both SabreChat! and SabreMixer! to the same interrupt.
  313.                 I would suggest placing I$68 on both command lines, this
  314.                 will change both to interrupt $68. Use this option with
  315.                 extreme caution and only if you are sure that SabreMixer!
  316.                 and another TSR are conflicting.
  317.  
  318.                   Usage: SCHAT! I<int number>
  319.                 Default: SCHAT! I$66
  320.                 Example: SCHAT! I$68
  321.  
  322.         Option L, Line-by-line Mode
  323.  
  324.                 By putting this option on the command line, SabreChat!
  325.                 will default to line-by-line mode instead of
  326.                 character-by-character mode.
  327.  
  328.                 Usage  : SCHAT! L
  329.                 Default: Disabled.
  330.  
  331.         Option M, User Prompting
  332.  
  333.                 This command sets the type of prompting that
  334.                 SabreChat! while use to distinguish between users.
  335.  
  336.                 Usage   : SCHAT! M<0..3>
  337.                                 0       No prompting
  338.                                 1       Initial prompting
  339.                                 2       Full name prompting
  340.                                 3       Preceding Fullname
  341.                 Default : SCHAT! M2
  342.  
  343.         Option N, Select Node [DOOR.SYS]
  344.  
  345.                 This command is set by DOOR.SYS.
  346.  
  347.                 This option tells SabreChat! which node it is
  348.                 operating on.  This option is also read from DOOR.SYS
  349.                 if the Y option is selected and will not need to be
  350.                 explicitly set.
  351.  
  352.                 Usage   : SCHAT! N<node 1..50>
  353.                 Default : SCHAT! N1 or DOOR.SYS or DORINFO1.DEF
  354.  
  355.         Option O, Read User Information from DORINFO1.DEF.
  356.  
  357.                 This option tells SabreChat! to read DORINFO1.DEF for
  358.                 information pertaining to the user setup.  This
  359.                 command will automatically set the com port, graphic
  360.                 mode, and time remaining.  Theses options should not
  361.                 need to be set once the O command has been used unless
  362.                 the values are desired to be forced.
  363.  
  364.                 Usage   : SCHAT! O<path to DORINFO1.DEF>
  365.                 Default : None
  366.  
  367.         Option P, Select Online Communications Port [DOOR.SYS]
  368.                                                     [DORINFO1.DEF]
  369.                 This command is set by DOOR.SYS and DORINFO1.DEF.
  370.  
  371.                 This command sets the communications port (COM) that
  372.                 it will talk to an online user with.  A port value of
  373.                 zero is assumed to be a local user.  A communications
  374.                 fossil will be used to access the port.
  375.  
  376.                 Usage   : SCHAT! P<0,1..8> (local,com1..com8)
  377.                 Default : No ComPort or DOOR.SYS
  378.  
  379.         Option Q, Activate Questionnaire.
  380.  
  381.                 This command activates SabreChat! questionnaire
  382.                 feature.  The files SCHT!QST.TXT and SCHT!ASK.TXT will
  383.                 need to have been created and SCHT!QST.EXE executed
  384.                 before this works correctly.
  385.  
  386.                 Usage   : SCHAT! Q
  387.                 Default : Inactive
  388.  
  389.         Option S, Set SEMAPHORE Path
  390.  
  391.                 Remote Access allows you to specify a semaphore path
  392.                 to a drive for quick access temporary files.  This is
  393.                 usually a ramdisk drive.  Remote Access will put its
  394.                 paging files in there.  If you specified RA to use a
  395.                 semaphore path, then you will need to tell SabreChat!
  396.                 where this path is with the S<path> command.
  397.  
  398.                 Usage   : SCHAT! S<semaphore path>
  399.                 Default : None
  400.                 Example : SCHAT! SE:\
  401.  
  402.         Option T, Set User Time Remaining [DOOR.SYS] [DORINFO1.DEF]
  403.  
  404.                 This command is set by DOOR.SYS and DORINFO1.DEF.
  405.  
  406.                 This option tells SabreChat! how long the user has
  407.                 access to this door in minutes.  Once this time is
  408.                 used, the user is returned to the board.
  409.  
  410.                 NOTE : This command is ignored in the unregistered
  411.                        version of SabreChat! and the user time limit
  412.                        is set to 10 minutes.
  413.  
  414.                 Usage   : SCHAT! T<1..255 minutes>
  415.                 Default : SCHAT! T20 or DOOR.SYS or DORINFO1.DEF.
  416.  
  417.         Option U, Auto-Line Mode Switch
  418.  
  419.                 This command line option sets the number of users that
  420.                 must be in SabreChat! before SabreChat! will
  421.                 automatically switch to line-by-line mode.  Setting
  422.                 this value to 0, disables the auto-switch.
  423.  
  424.                 Usage   : SCHAT! U<number of users>
  425.                 Example : SCHAT! U5
  426.                         -- go to line-by-line mode when the 5th user
  427.                         enters a SabreChat! conference
  428.                 Default : SCHAT! U3
  429.  
  430.  
  431.         Option Y, Read User Information from DOOR.SYS
  432.  
  433.                 This option tells SabreChat! to read DOOR.SYS for
  434.                 information pertaining to the user setup.  This
  435.                 command will automatically set the user node, com
  436.                 port, graphic mode, and time remaining.  This options
  437.                 should not need to be set once the Y command has been
  438.                 used unless the values are desired to be forced.
  439.  
  440.                 Usage   : SCHAT! Y<path to DOOR.SYS>
  441.                 Default : None
  442.  
  443.         Option Z, Set Local Screen Length
  444.  
  445.                 This option informs SabreChat! of the size of the
  446.                 local screen.  Though the size of the local screen is
  447.                 read from BIOS upon program initialization, you may
  448.                 desired to force the size if SabreChat! does not read
  449.                 the value correctly or if you wish to make the
  450.                 SabreChat! window shorter than screen.  The latter use
  451.                 is nice if you are using SabreChat! in a windowed
  452.                 enviroment and you wish to see the status bar at the
  453.                 bottom of each window.
  454.  
  455.                 Usage   : SCHAT! Z<1..50 lines>
  456.                 Default : AutoDetect
  457.  
  458.         Option &, Immediate User Mode
  459.  
  460.                 This option allows you to use SabreChat! without the
  461.                 need of a BBS user file (NODEINFO.DAT or USERON.BBS).
  462.                 The user name is set to the name entered on the node
  463.                 specified by the N option, and on the port specified
  464.                 by the P option.
  465.  
  466.                 Usage   : SCHAT! &<FirstName_LastName>
  467.                 Default : SCHAT! None
  468.                 Example : SCHAT! &Shawn_Gresham
  469.  
  470.                 Note:  This option also allows you to use SabreChat!
  471.                        as network chat utility by assigning a node
  472.                        number to each workstation.  Thus workstation
  473.                        #5 could just type 'SCHAT! &John_Doe N5' and
  474.                        JOHN DOE would enter SabreChat! as node 5.
  475.  
  476.  
  477. Customizing Menus
  478. ─────────────────
  479.  
  480.         There are three screens in SabreChat! that can be modified.
  481.         These are SCHT!HLP, SCHT!MNU, and SCHT!HI.  Each consists of
  482.         two files that end with .ASC, a straight ASCII file, and .ANS,
  483.         an ANSI file.  You may modify these files as you wish to give
  484.         any extra information or flash to your copy of SabreChat!.
  485.         However, modifying the command names in the SCHT!MNU file will
  486.         NOT modify the command names in SabreChat!.  This will only
  487.         confuse your users.
  488.  
  489.         Also, some ANSI screens may contain commands that SabreChat!
  490.         does not correctly interpret.  This screens will appear wrong
  491.         on the local side only.
  492.  
  493. Action Commands
  494. ───────────────
  495.  
  496.         SabreChat!'s action feature allows the user to make gestures
  497.         with just a few keystrokes.  An example would be /SMILE that
  498.         sends "SHAWN GRESHAM smiles."  to each user in his conference.
  499.         These commands are an attempt to give SabreChat! a more
  500.         conversation atmosphere.
  501.  
  502.         The action commands can be altered by modifing the file
  503.         SCHT!ACT.TXT.  Before doing so, be sure to change into the
  504.         directory containing that file.  Each line of SCHT!ACT.TXT
  505.         is in this format:
  506.  
  507.                 <COMMAND> <TEXT>
  508.  
  509.         <COMMAND> is a word of ten characters or less that will be used
  510.                 by the users to invoke this action command.  Verbs usually
  511.                 work best for this.
  512.  
  513.         <TEXT> is a coded string that is used to produce the action text
  514.                 that will be displayed to everyone in the chat.
  515.  
  516.                 example defined in SCHT!ACT.TXT:
  517.  
  518.                         SUCK  There is a vast sucking noise.
  519.  
  520.                 example as used in chat:
  521.  
  522.                         /SUCK
  523.                         There is a vast sucking noise.
  524.  
  525.                 There are also two special variables that can be used.
  526.  
  527.                 These are:
  528.  
  529.                         %1      user's name
  530.                         %2      destination user's name
  531.  
  532.                 Example defined in SCHT!ACT.TXT:
  533.  
  534.                         JUMP    %1 jumps.
  535.                         KISS    %1 kisses %2!!
  536.  
  537.                 example used in chat:
  538.  
  539.                         /JUMP
  540.                         SHAWN jumps.
  541.  
  542.                         /KISS Gina
  543.                         SHAWN kisses GINA!!
  544.  
  545.                 And one last special command that is based off of the sex
  546.                 of the user.
  547.  
  548.                 This is:
  549.  
  550.                         @male string@female string@
  551.  
  552.                 Example defined in SCHT!ACT.TXT:
  553.  
  554.                         FLAP %1 flaps @his@her@ arms.
  555.  
  556.                 example used in chat:
  557.  
  558.                         /FLAP
  559.                         SHAWN flags his arms.
  560.  
  561.  
  562.         SabreChat! will support as many action commands as memory
  563.         allows.
  564.  
  565.         After modifying the file SCHT!ACT.TXT, you will need to run
  566.         SCHT!ACT.EXE.  This will convert SCHT!ACT.TXT into
  567.         SCHT!ACT.DAT that is read by SabreChat!.  SCHT!ACT.EXE will
  568.         notify you if you have made any mistakes regarding the size of
  569.         an action command.
  570.  
  571. Questionnaire
  572. ─────────────
  573.  
  574.         The questionnaire feature of SabreChat! allows you to ask
  575.         additional information on a user.  This information will be
  576.         available to other users when they encounter each other by
  577.         using the /LOOK command.  This feature is an attempt to
  578.         'flesh' out a chatting session.  Users will be able to put a
  579.         description along with the 'voice' of the person they are
  580.         chatting with.
  581.  
  582.         The questionnaire consists of three files: the aspect
  583.         definition file (SCHT!QST.TXT), the ask file (SCHT!ASK.TXT),
  584.         and the show file (SCHT!SHW.TXT). To set up a questionnaire
  585.         file you can edit the files that came in the SabreChat!
  586.         archive or by create a new ones by deleting the SCHT!QST.TXT,
  587.         SCHT!ASK.TXT, SCHT!SHW.TXT files and doing it from scratch.
  588.         For a start, I suggest slightly altering the ones that I made
  589.         until you get the hang of it.
  590.  
  591.         Following I will explain how each of these files are set up:
  592.  
  593.         The aspect definition file - SCHT!QST.TXT
  594.         -----------------------------------------
  595.  
  596.         We start with the aspect definition file which is the heart of
  597.         the questionnaire.  It contains information about the various
  598.         aspects of an user.  Each line in this file defines an aspect.
  599.         The format for each line is as follows:
  600.  
  601.         <aspect name> <length in characters of entry>
  602.  
  603.         for example:
  604.  
  605.                 hair_color      10
  606.  
  607.         defines the aspect HAIR_COLOR that can be up to 10 characters
  608.         long.  This information will be used by SabreChat! when the
  609.         user answers the questionnaire. Which leads us to...
  610.  
  611.         The ask file - SCHT!ASK.TXT
  612.         ---------------------------
  613.  
  614.         The ask file is displayed when a user enters SabreChat! for
  615.         the first time or when the user wishes to change his/her
  616.         current aspects/answers.  Basically, the ASK file asks the
  617.         questions that the ASPECT DEFINITION file will contain. The
  618.         format for this file is simple.  Everything will be printed as
  619.         is except lines that begin with a % (percent) character.  A
  620.         line beginning with a percent character is expected to contain
  621.         an aspect name (for example HAIR_COLOR).  Using the example
  622.         above:
  623.  
  624.                 SCHT!ASK.TXT:
  625.  
  626.                         What color is your hair?
  627.                         %HAIR_COLOR%
  628.  
  629.         This sample prints the line 'What color is your hair?' and
  630.         then prompts for a string up to 10 characters long as defined
  631.         in SCHT!QST.TXT and assigns the string to the name HAIR_COLOR.
  632.  
  633.         The show file - SCHT!SHW.TXT
  634.         ----------------------------
  635.  
  636.         Where the ASK file asks the questions, the show file shows the
  637.         answers.  The show file will appear to the users when they use
  638.         the /LOOK command from SabreChat!. The format for this file is
  639.         a little more complicated than the previous SCHT!ASK file as
  640.         it allows for some minor formatting of the aspects. The text
  641.         will printed as is to the user except for the user aspects
  642.         which should be prefixed and suffixed with a % (percent)
  643.         character.  Using the previous example, you might display the
  644.         user's hair color with the following line:
  645.  
  646.                 SCHT!SHW.TXT:
  647.  
  648.                         Hair color : %HAIR_COLOR%
  649.  
  650.         The show file also allows you to define how big the space is
  651.         that the answer will appear in.  Though this may seem awkward
  652.         at first, it becomes very powerful when you wish to align your
  653.         text into two or more columns.  You can specify the aspect
  654.         field size by placing the field size in letters between the
  655.         first % (percent) and the aspect name:
  656.  
  657.                 %<field size>[ASPECT name]%
  658.  
  659.         Using the example above with a few new aspects:
  660.  
  661.                 Hair Color : %38HAIR_COLOR% Eye Color : %EYE_COLOR%
  662.                 Height     : %38HEIGHT% Weight    : %WEIGHT%
  663.  
  664.         This example would display the four aspects with the WEIGHT
  665.         and EYE_COLOR being lined up regardless of the lenght of the
  666.         HAIR_COLOR or HEIGHT answers.
  667.  
  668.         The field size is completely optional and is assumed to be the
  669.         length of the answer if left out.
  670.  
  671.         Finally
  672.         -------
  673.  
  674.         After completing these three files, you will need to run
  675.         SCHT!QST.EXE to compile SCHT!QST.TXT into SCHT!QST.DAT.  The
  676.         compiler will notify you of any errors found in the TXT file.
  677.  
  678.         And very last, you will need to use the Q option on the
  679.         command line to activate the questionnaire.
  680.  
  681.  
  682. Technical Information
  683. ─────────────────────
  684.  
  685.         Following is some technical information that may be useful in
  686.         debugging application conflicts.
  687.  
  688.         ■ The communication fossil is expected to be at interrupt 14h.
  689.         ■ NetBIOS is accessed through interrupt 5Ch.
  690.         ■ Interrupt 66h is used to communicate with SabreMixer!.
  691.         ■ NetBIOS datagrams are used in NetBIOS mode.
  692.         ■ Record locking is used to safely access USERON.BBS (ra/tag)
  693.           and NODEINFO.DAT (wc) files.
  694.  
  695. Thanks
  696. ──────
  697.  
  698.         Thanks to my very very responsive beta testers!!!!  Give these
  699.         guys a call to see the lastest SabreChat! in action!
  700.  
  701.                              Wildcat BBS
  702.                              -----------
  703.  
  704.         Greg Day                        Steve Henry
  705.         Suburban Computer Connection    AMBASSADOR BOARD
  706.         Garden City, MI                 Ontario, Canada
  707.         1-313-427-0223                  1-519-925-0724 v.32bis
  708.         1:2410/193
  709.  
  710.         Jeff Shapiro                    Chuck Alpert
  711.         Computer Junction               Short Circuit
  712.         Elizabeth, NJ                   Boca Raton, FL
  713.         1-908-354-6979                  1-407-997-2235
  714.         1:107/900                       1:369/78
  715.  
  716.                                TAG BBS
  717.                                -------
  718.  
  719.         Allen Crist
  720.         Code Three
  721.         Prescott, AZ
  722.         1-602-771-8646
  723.         1:15/23
  724.  
  725.                           Remote Access BBS
  726.                           -----------------
  727.  
  728.         Rick Sande                      Josh Zerlan
  729.         LifeStyles BBS                  The Temporal Alliance
  730.         Branford, CT                    Ft. Collins, CO
  731.         1-203-481-4836                  1-303-490-1047
  732.         1:141/107                       1:306/23
  733.  
  734.         Chris DeClerk
  735.         Yolanda's Wonderland
  736.         State University, AR
  737.         1-501-972-6549
  738.         1:389/12
  739.  
  740.  
  741.         Also many thanks to Joel Karr for initially getting me started
  742.         in SabreChat! and offering his system as the birth place of
  743.         this program.
  744.  
  745.         To Ellis Green of Ellwye's Funhouse the use of his system as
  746.         a distribution point and mail contact before my arrival into
  747.         the FIDOnet and BBS world.
  748.  
  749.         To Gina Lewter for the many hours of putting up with me and my
  750.         'puter and, foremost, for agreeing to be my wife (May 8, 1993!
  751.         everybody be there!) Love you babe! (yes, we can go eat now)
  752.  
  753.         And to everyone of you users out there who poke, jab, pummel,
  754.         and basically pull the arm of your sysop to register
  755.         SabreChat!!!!
  756.  
  757. Future Versions
  758. ───────────────
  759.  
  760.         Here are a few ideas that my beta testers and I have come
  761.         up with for future versions:
  762.  
  763.         * adding a KNOCK command for users to request entrance to a
  764.           private conference (room)
  765.         * expanding the IGNORE command to allow a user to ignore a
  766.           certain node
  767.         * possibly adding a sysop page option and apporiate handling
  768.         * detection of users logging on/off the board...
  769.  
  770.         Let me know what you think or if you have any other
  771.         suggestions.
  772.  
  773. Contacting The Author
  774. ─────────────────────
  775.  
  776.         You can reach the author by sending netmail to SHAWN GRESHAM
  777.         on the following board:
  778.  
  779.                 Maximum Intensity
  780.                 Whitesboro, Texas, 76273
  781.                 FIDOnet 1:19/129
  782.                 1-903-564-3853 22:00 to 06:00 cst
  783.  
  784.         Or by sending a letter to:
  785.  
  786.                 Shawn Gresham
  787.                 Route 1 Box 544
  788.                 Gordonville, Texas 76245-9789 USA
  789.  
  790.         Or, by dropping a message on the RA_UTIL or WILDCAT echos to
  791.         SHAWN GRESHAM.
  792.  
  793.         Any comments or suggestions would be treasured.
  794.  
  795.         If you are having problems and wish to contact me, please
  796.         have the following information handy:
  797.  
  798.                 BBS System (ra/wildcat/tag)
  799.                 Machine types. (8086, 80286-10, 80486DX-50, etc)
  800.                 Memory Manager (if any) (QEMM, 386MAX, etc...)
  801.                 System Type (DESQview, network, WINDOWS, etc...)
  802.                 Operating System (MS-DOS 3.3, MS-DOS 5.0, DRDOS 6.0, etc...)
  803.                 Number of nodes in your system
  804.                 Command line used for SabreChat! (as in the MAIN1.RUN)
  805.                 Command line used for SabreMixer! (as in AUTOEXEC.BAT)
  806.                 Current S!NODE= environment setting (as in AUTOEXEC.BAT)
  807.                 Current S!EXE= environment setting (as in AUTOEXEC.BAT)
  808.  
  809.         This information is invaluable for debugging SabreChat! problems.
  810.  
  811.                ──────────────────────────────────────────────
  812.                  SabreChat! Copyright (C) 1993 Shawn Gresham
  813.  
  814.  
  815.