home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / com_term / ca28_2a.arj / README.DOC < prev    next >
Text File  |  1991-07-25  |  22KB  |  494 lines
  1. -------------------------------------------------------------------------------
  2. 910725                COM-AND 2.8                Page  1
  3. -------------------------------------------------------------------------------
  4. This release of COM-AND:
  5. -------------------------------------------------------------------------------
  6.  
  7.      o    This is the ninth release of COM-AND (version 2.8).  This release
  8.     corrects problems reported with version 2.7 and adds features.
  9.  
  10.      o    Run instructions and installation procedures will be found following
  11.     this page.
  12.  
  13.      o    Changes to the previous version (additions and corrections) are to
  14.     be found following run/installation pages.
  15.  
  16.      o    The author asks for comments and criticisms of this program.
  17.     You may contact the author:
  18.  
  19.     CABER Software            PLINK, GEnie, Delphi: TARTAN
  20.     R. (Scott) McGinnis        UNISON: SCOTTM (PARTI: Scott McGinnis)
  21.     P.O. Box 3607 Mdse Mart     CIS: 73147,2665
  22.     Chicago, IL 60654-0607
  23.  
  24. -------------------------------------------------------------------------------
  25. Release history (not including public beta releases)
  26. -------------------------------------------------------------------------------
  27.  
  28.    860806: PC-VCO 1.0
  29.    860929: PC-VCO 1.1
  30.    861119: PC-VCO 1.2
  31.    861222: PC-VCO 1.3
  32.    861226: PC-VCO 1.31
  33.    870814: PC-VCO 2.0     COM-AND 2.0   CCHESS 1.0
  34.    871202: PC-VCO 2.1     COM-AND 2.1   CCHESS 1.1
  35.    871211:                         CBRIDG 1.0
  36.    880122:                              CCOLOR 1.0
  37.    880713: PC-VCO 2.2     COM-AND 2.2   CCHESS 1.2    CBRIDG 1.1   CCOLOR 1.1
  38.    881202:         COM-AND 2.3
  39.    890309:         COM-AND 2.4
  40.    891020:         COM-AND 2.5
  41.    900426:         COM-AND 2.6
  42.    901019:         COM-AND 2.7   CACMP 1.0
  43.    901213:                              CCOLOR 1.2
  44.    910801:         COM-AND 2.8   CACMP 1.1    (You are here)
  45.  
  46. -------------------------------------------------------------------------------
  47.  
  48. -------------------------------------------------------------------------------
  49. 910725                COM-AND 2.8                Page  2
  50. -------------------------------------------------------------------------------
  51. Files in this distribution:
  52. -------------------------------------------------------------------------------
  53.  
  54.      CA28-1.ZIP:
  55.  
  56.     COM-AND.EXE    2.8 executable program file
  57.     COM-AND.PIF    PIF file for Windows
  58.     COM-AND.DVP    DVP file for DesqView
  59.     COM-AND.ICO    WIndows 3.0 ICON file (Dr. David Snyder thank you!)
  60.     README.DOC    This file.
  61.     REGISTER.DOC    Registration form
  62.     VENDOR.DOC    Limitations on commercial redistribution
  63.  
  64.      CA28-2.ZIP:
  65.  
  66.     COM-AND.DOC    Documentation for version 2.8 manual functions
  67.     CASCRIPT.DOC    Documentation for version 2.8 script language
  68.     README.DOC    This file.
  69.     REGISTER.DOC    Registration form
  70.     VENDOR.DOC    Limitations on commercial redistribution
  71.  
  72.      CA28-3.ZIP:
  73.  
  74.     SCRIPTS.DOC    Summary documentation for scripts
  75.     README.DOC    This file.
  76.     REGISTER.DOC    Registration form
  77.     VENDOR.DOC    Limitations on commercial redistribution
  78.     *.CMD; *.DOC    REMAP.CMD, XLATE.CMD, LEARN.CMD, FILEMGR.CMD...
  79.     *.SRC        Commented scripts where *.CMD has been stripped
  80.  
  81.      CA28-4.ZIP:
  82.  
  83.     CACMP.EXE    COM-AND script syntax/semantic check
  84.     CACMP.DOC    Documentation for CACMP.EXE
  85.     OVERLAY.*    Sample script overlay files
  86.     TALKER.*    Sample script overlay supporting limited speech synth
  87.     VOICE.*     Voice driver and documentation for TALKER
  88.     VEND.COM    Voice driver termination utility
  89.     PC-VCO.EXC    Exception file for TALKER.CMD script
  90.     README.DOC    This file.
  91.     REGISTER.DOC    Registration form
  92.     VENDOR.DOC    Limitations on commercial redistribution
  93.  
  94. -------------------------------------------------------------------------------
  95.    *    COM-AND creates any files it requires that it does not find on the
  96.     drive:subdirectory where it is loaded (or on the drive:subdirectory
  97.     where the environment variable COM-AND= directs the processor)
  98. -------------------------------------------------------------------------------
  99.    *    To print the document files, dearc the file onto disc and use the DOS
  100.     command "PRINT <file>.DOC".  COM-AND documents are formatted 54 lines
  101.     to the page, with top-of-forms as page breaks, using tab characters.
  102. -------------------------------------------------------------------------------
  103.  
  104. -------------------------------------------------------------------------------
  105. 910725                COM-AND 2.8                Page  3
  106. -------------------------------------------------------------------------------
  107. Notice:  Changes in this version of COM-AND require attention:
  108. -------------------------------------------------------------------------------
  109.  
  110.    *    Version 2.7 of COM-AND changed the self-encryption algorithm for use
  111.     with script files.  Script files password-lessly encrypted by version
  112.     2.6 or before must be re-encrypted for use with this version of COM-
  113.     AND.  Scripts encrypted with version 2.7 will work fine with 2.8.
  114.  
  115.     Please re-encrypt any self-encrypted scripts encrypted for version
  116.     2.6 or before, from its original.  Scripts self-encrypted with 2.6
  117.     or before will not work under 2.8.
  118.  
  119. -------------------------------------------------------------------------------
  120.  
  121.    *    This version continues a feature that may startle some and bore most,
  122.     providing a base for simplified installation of COM-AND.  If COM-AND
  123.     is loaded on a subdirectory where no COM-AND.DFT resides, AND if the
  124.     environment variable COM-AND= does not point to a subdirectory where
  125.     COM-AND.DFT may be found, COM-AND creates a new .DFT file.
  126.  
  127.     A script named INSTALL.CMD is included with this release.  If COM-AND
  128.     creates its .DFT file (as opposed to updating an existing one), and
  129.     if the script INSTALL.CMD is available, INSTALL is invoked automatic-
  130.     ally upon completion of initialization.
  131.  
  132.     The INSTALL.CMD script included with this release is a move towards
  133.     simplified installation, especially where the individual does not
  134.     have years of experience with modems and comm programs.  It is hoped
  135.     that the script included with this release will grow over time, with
  136.     suggestions and comments.
  137.  
  138.     INSTALL may be manually invoked through the F2 window, of course.
  139.     However, it is suggested that you delete INSTALL.CMD after use, to
  140.     salvage precious disk space.
  141.  
  142. -------------------------------------------------------------------------------
  143.  
  144.    *    This version of COM-AND changes the nature of the backscreen opera-
  145.     tion.  This change invalidates the backscreen functions in all pre-
  146.     viously released accessories (PC-VCO, CCOLOR, CCHESS, and CBRIDGE).
  147.  
  148.     Previously released accessories simply report 'last page' if their
  149.     backscreen is invoked with this version.  CCOLOR is being updated
  150.     to accomodate this change (a beta is available at this date).
  151.  
  152. -------------------------------------------------------------------------------
  153.  
  154. -------------------------------------------------------------------------------
  155. 910725                  COM-AND 2.8                Page  4
  156. -------------------------------------------------------------------------------
  157. Run instructions:
  158. -------------------------------------------------------------------------------
  159.  
  160. o    To run COM-AND from the DOS prompt, install the release as
  161.     described below, then type:
  162.  
  163.     C> COM-AND <carriage return>
  164.  
  165. -------------------------------------------------------------------------------
  166. Installation:
  167. -------------------------------------------------------------------------------
  168.  
  169. 1)    Set the current subdirectory to the subdirectory where you wish to
  170.     install COM-AND... where you've already installed previous COM-ANDs
  171.     (if you've used one).  I'd suggest "\COM-AND".
  172.  
  173. 2)    Dearc the distribution file.  Have a care not to overwrite files
  174.     you want to keep!
  175.  
  176. 3)    Load COM-AND (i.e. COM-AND <return>).  If this is the first time,
  177.     follow the prompts provided by INSTALL.CMD (automatically invoked).
  178.     After INSTALL (if INSTALL was automatic) and otherwise:
  179.  
  180.     o  Check Alt-S
  181.        .. Check modem parameters - you may want to change them.
  182.        .. The backscreen buffer size defaults to 4K.  It may be set
  183.           up to 64K, for redisplay and transcripting.
  184.        .. Remember to save the new settings.
  185.  
  186.     o  Check Alt-P
  187.        .. Check the COM port you use (1/2/3/4).
  188.        .. Default speed selection is not usually important (if you
  189.           always use the dialing directory).  Set it anyway.
  190.        .. Remember to save new settings.
  191.  
  192.     o  Check Alt-O
  193.        .. Set flags the way you want them (e.g. exit query on, d*mned
  194.           advert off, and so on;  Note BIOS/DIRECT and PCJr settings)
  195.        .. Remember to save new settings.
  196.  
  197. 4)    Review the accessories (F1).
  198.  
  199.        You may review the contents of accessory definitions with the 'r'
  200.        subcommand.    You may wish to add entries for a listing program
  201.        and editor.. and perhaps PC-VCO... CCOLOR...  Remember to save...
  202.  
  203. 5)    Exit COM-AND with Alt-X, and restart.
  204.  
  205.  
  206. -------------------------------------------------------------------------------
  207. 910725                  COM-AND 2.8                Page  5
  208. -------------------------------------------------------------------------------
  209. Additions and corrections this release:
  210. -------------------------------------------------------------------------------
  211.  
  212.     ---------------------------------------
  213.     Changes and corrections to 2.7 COM-AND:
  214.     ---------------------------------------
  215.  
  216. o    Changed BIOS send to wait on THRE (should not be necessary)
  217. o    Changed MACROs to use grave (`) as a forcing character as scripts
  218. o    Changed Alt-D to invoke redial display (and function) when dialing
  219. o    Changed modem status display to widen by 6 chars in redial display
  220. o    Changed input-pop-up over Alt-O to uncover current settings
  221. o    Changed highlight bars to 'follow' Home and End keys in all windows
  222. o    Changed method of display within a menu window to speed display
  223. o    Changed LD code as suffix as well as prefix in Alt-D.  Suffixing and
  224.     prefixing LD codes are now independent!  [Suffix is added to dialing
  225.     string after the number and before Modem Suffix String of Alt-S.]
  226. o    Changed to force previously released accessories to report 'last page'
  227.     on a backscreen request with this version of COM-AND
  228. o    Changed Alt-B backscreen.  Drastically revised.  By popular demand.
  229. o    Changed Alt-A, when setting OFF, not to scroll display down
  230. o    Changed all aux files to be opened read-only at program initialization
  231.     to accomodate scripted LAN users (DFT, TUN, XLT, RMP, MAC, DIR, ACC)
  232. o    Changed BIOS run time parm to allow port other than 0,1,2 or 3 to be
  233.     used.  E.g.: "d>" COM-AND BIOS(5)
  234. o    Changed redial to send init to modem during hangup if option set
  235. o    Changed ZMODEM to send cancel sequence SLOW;  buffered send would
  236.     often fail at high speeds
  237.  
  238. o    Corrected Alt-O to set/reset Alt-A correctly when Alt-O closed
  239. o    Corrected XMODEM to allow checksum send... was doing CRC
  240. o    Corrected YMODEM to display retries
  241. o    Corrected YMODEM/BYMODEM/BYMODEMG to test for ESC after NAK received
  242. o    Corrected Alt-D to display entry # invoked by script DIAL on next
  243.     manual use (highlight and page disp were OK).
  244. o    Changed all references to 56k baud to 57k baud
  245. o    Changed SLOW XFER to default ON, and XSUI to 5 when DFT file created
  246.     (does not affect existing DFT values)
  247. o    Changed hardware flow control references to 'unidirectional' and 'bi-
  248.     directional' after polling interested parties
  249. o    Changed /R runtime switch to set bidirectional flow control instead
  250.     of unidirectional flow control
  251. o    Corrected RTSF/RTSD/HARDFLOW to avoid sequence sensitivity in setting
  252. o    Corrected BIOS redirection to accomodate parity/data bits changes
  253.     while port it open (during file transfers)
  254.  
  255. o    Improved the speed of the ANSI (and therefore VT100) display driver
  256.  
  257.  
  258. -------------------------------------------------------------------------------
  259. 910725                  COM-AND 2.8                Page  6
  260. -------------------------------------------------------------------------------
  261. Additions and corrections this release:
  262. -------------------------------------------------------------------------------
  263.  
  264.     -------------------------
  265.     Additions to 2.7 COM-AND:
  266.     -------------------------
  267.  
  268. o    Expanded BBS script (maintenance and setup scripts)
  269. o    Expanded HOST script (maintenance, setup scripts and DOORWAY)
  270. o    Added /H runtime switch to inhibit any change to screen mode on entry
  271. o    Added /Q runtime switch to inhibit COM-AND.CMD auto-execution
  272. o    Added (attempted to) clear of XOFF pending during Alt-H and dialing
  273. o    All file transfer stat windows may now be 'moved' during a file trans-
  274.     fer, with cursor up, down, right and left.
  275. o    The query for file name, prior to a file transfer, is movable too
  276. o    If no backscreen is configured, F8 doesn't ask to add backscreen
  277. o    If no backscreen is configured, Alt-B now says so
  278. o    The critical error handler now reports disk/nondisk information
  279. o    Added cumulative send error status to Alt-Y
  280. o    Added status line, remote function key, and wrap settings to Alt-V
  281. o    Added ANSI escape sequences: ESC '[?7h' and ESC '[?7l' (wrap on/off)
  282. o    Added Alt-Minus to toggle remote function key usage
  283.  
  284.     -------------------------------
  285.     Script changes and corrections:
  286.     -------------------------------
  287.  
  288. o    Corrected MDIAL to NOT issue error message if ESCape is used to exit
  289. o    Corrected FOPENO to handle files one byte long containing only ^z
  290. o    Corrected GET, MGET etc to NOT modify target string if ESC aborted
  291.     (previously rtnd content up to the ESC)
  292. o    Corrected FKEY to NOT implement ESC if ESC is pending.    Early action
  293.     caused a problem with the interpretation of compound conditionals.
  294.  
  295. o    Changed all references to 56k baud to 57k baud (SET BAUD)
  296. o    Changed the OVERLAY statement to include an optional end-address
  297.     entry point.  The end-entry point is ALWAYs executed before an overlay
  298.     is terminated.    No parameters may be passed.  See appendix, below.
  299.  
  300.  
  301. -------------------------------------------------------------------------------
  302. 910725                  COM-AND 2.8                Page  7
  303. -------------------------------------------------------------------------------
  304. Additions and corrections this release:
  305. -------------------------------------------------------------------------------
  306.  
  307.  
  308.     -------------------------------
  309.     Script language additions:
  310.     -------------------------------
  311.  
  312.     SET INTRINSIC ON!OFF       ; En/Disable string intrinsics
  313.     SET MCR <number>       ; Write MCR value
  314.     SET MULTI ON!OFF       ; Control PLAY statement mode/tempo default
  315.                    ; This command is not in CASCRIPT.DOC
  316.     SET OVENTRY (NONE!<addr>)  ; Set/reset overlay end entry addr
  317.     SET REMFTNS ON!OFF       ; Enable/disable remote function keys
  318.     SET STATUS ON!OFF       ; Enable/disable status line display
  319.     SET WRAP ON!OFF        ; Set line wrap on/off
  320.     SET ZMODEM BLOCK 0       ; Resets to default (fdx)
  321.     SET ZMODEM BLOCK 1024       ; Now allowed (previously -> hdx)
  322.  
  323.     OVERLAY <fname> [<addr>]   ; Load overlay; <addr> is optional
  324.     MCR Nx               ; Read MCR value
  325.  
  326.     ------------------------------------------
  327.     Script language intrinsic functions added:
  328.     ------------------------------------------
  329.  
  330.     _COMM               ; Rtns 'DIRECT' and 'BIOS'
  331.     _OVEN               ; Rtns NONE or overlay end entry addr
  332.     _PORT               ; Rtns value: 0,1,2... according to port
  333.     ...               ; .. set when COM-AND was run (BIOS parm)
  334.     _REMFTN            ; Rtns value: ON!OFF (remote ftn keys)
  335.     _STATUS            ; Rtns value: ON!OFF (status line display)
  336.  
  337.  
  338.     ----------------------------
  339.     CACMP additions and changes:
  340.     ----------------------------
  341.  
  342. o    Corrected FDATE in lexicon (for optional 1/0)
  343. o    Corrected STACK in lexicon (added STACK CLEAR)
  344. o    Changed SET PORT to allow string var; similarly changed the
  345.     lexicon for COMBASE, COMVEC, SET COMB and SET COMV
  346. o    All text output may now be redirected to a file
  347. o    Updated for all script changes above
  348. o    Added list of variables used in script to output summary
  349.  
  350.  
  351. -------------------------------------------------------------------------------
  352. 910725                  COM-AND 2.8                Page  8
  353. -------------------------------------------------------------------------------
  354. Updated scripts in CA28-3:
  355. -------------------------------------------------------------------------------
  356.  
  357. LEARN.CMD        A script that writes a script for you
  358. PC-2-PC.DOC        PC to PC file transfers
  359. UARTTYPE.CMD        Determine uart used on your machine
  360. DOORWAY.CMD        (new) Invoke DOORWAY (you must edit this before use)
  361.  
  362. BBMAINT.CMD        (New) Maintenance script for the BBS
  363. BBMAINT1.CMD        (New) BBMAINT extension script (users)
  364. BBMAINT2.CMD        (New) BBMAINT extension script (files)
  365. BBMAINT3.CMD        (New) BBMAINT extension script (bulletins)
  366. BBMAINT4.CMD        (New) BBMAINT extension script (mail)
  367. BBS.CMD         Ver 1.1 BBS script (stripped)
  368. BBS.DOC         Ver 1.1 BBS documentation
  369. BBS.SRC         Ver 1.1 BBS script (commented)
  370. BBSETUP.CMD        (New) Setup script for the BBS
  371.  
  372. HOST.CMD        Ver 1.1 HOST script (stripped)
  373. HOST.DOC        Ver 1.1 HOST documentation
  374. HOST.SRC        Ver 1.1 HOST script (commented)
  375. HOSETUP.CMD        (New) Setup script for the HOST
  376. HOSTART.CMD        (New) Restart script for the HOST and doorway
  377.  
  378. -------------------------------------------------------------------------------
  379. Known bugs in the current release:
  380. -------------------------------------------------------------------------------
  381.  
  382.  
  383. o    KERMIT 12 and 16 bit checksums don't seem to work with Jan van der
  384.     Eyjk's PCKERMIT.  I have not yet found the incompatibilty.
  385.  
  386. o    Reports have been received, but could not be reproduced, of the CPU
  387.     clock losing time.  No instances have been found due to COM-AND.
  388.     Several instances have been tracked to TSR's and special hardware
  389.     (e.g.  ALL-Charge card).
  390.  
  391.     Some reports suggested that the clock speeds up (!) when run in the
  392.     background under DesqView.
  393.  
  394.     If you experience a clock that 'lags' (loses time) using COM-AND, it
  395.     is suggested that you run COM-AND with the /w switch.  The /w switch
  396.     disables the interrupt driven write feature.  Transfers under DOS
  397.     will be only marginally slower.
  398.  
  399.     Please report clock problems you experience to the developer.
  400.  
  401.  
  402. -------------------------------------------------------------------------------
  403. 910725                COM-AND 2.8                Page  9
  404. -------------------------------------------------------------------------------
  405. Related release; PC-VCO:
  406. -------------------------------------------------------------------------------
  407.  
  408.  
  409.     PC-VCO is Visual Conferencing for the IBM PC.  It is completely
  410.     compatible with all three flavors of MacIntosh VCO/VMCO.  It has
  411.     been in use for more than a year by several groups of people.  On
  412.     GEnie, the IBM RT has a regularly scheduled VCO conference every
  413.     Wednesday at 9PM Eastern Standard Time.
  414.  
  415.  
  416.     The concept of VCO is that each conference attendee draws a set of
  417.     16 (or 18) ICONs, and posts them publicly.  Other attendees down-
  418.     load the ICONs (called face files), and add them to their own lib-
  419.     rary of faces.    8 (or 9) expressions (happy, sad, etc) are supported.
  420.     When someone speaks in a VCO conference, the appropriate ICON is
  421.     displayed on all PC-VCO screens.  People who've not uploaded face
  422.     files are depicted as Charlie Brown, Don Martin, or OPUS.
  423.  
  424.  
  425.     PC-VCO interfaces to a public domain text-to speech synthesizer.
  426.     The quality is less than might be desired, but its a start!
  427.     PC-VCO now includes its own speech driver for faster processors.
  428.  
  429.  
  430.     PC-VCO has been distributed (its seventh release) as PC-VCO22.ZIP.
  431.     PC-VCO may be used on either CGA, EGA or Hercules graphics adapters.
  432.  
  433. -------------------------------------------------------------------------------
  434. Related release; CCHESS:
  435. -------------------------------------------------------------------------------
  436.  
  437.     CCHESS is Conference Chess - two people can play chess over PLINK's
  438.     PARTY, CIS CB, etc.  CCHESS provides a graphics depiction of a chess
  439.     board, and a log of the last few moves.  Game play can be performed
  440.     entirely with a mouse (if you desire - not necessary).    Games may be
  441.     saved, and restored later for continuation.
  442.  
  443.  
  444.     Version 1.2 is a production release - beta testing is complete.
  445.     However,  I am still looking for comments, criticisms and thoughts
  446.     from those interested in on-line interactive gaming.
  447.  
  448.  
  449.     CCHESS has been distributed (its second release) as CCHESS12.ZIP.
  450.     Please read the CCHESS.DOC document for a description of CCHESS.
  451.     CCHESS may be used on either CGA, EGA or Hercules graphics adapters.
  452.  
  453.  
  454. -------------------------------------------------------------------------------
  455. 910725                COM-AND 2.8                Page 10
  456. -------------------------------------------------------------------------------
  457. Related release; CBRIDGE:
  458. -------------------------------------------------------------------------------
  459.  
  460.     CBRIDGE is Conference Bridge - four people can play bridge over
  461.     PLINK's PARTY, CIS CB, etc.  CBRIDGE deals cards, displays hands,
  462.     displays (and protects) the bidding, and monitors game play.
  463.     Bidding can be reviewed at any time, as can game play.
  464.  
  465.  
  466.     Version 1.1 has completed its beta trials.  It has found quite
  467.     usable.  It may be 'rough' in spots...  I am looking for comments,
  468.     criticisms and thoughts from those interested in on-line interactive
  469.     gaming.
  470.  
  471.     CBRIDGE has been distributed (its first release) as CBRIDG11.ZIP.
  472.     Please read the CBRIDG.DOC document for a description of CBRIDGE.
  473.     CBRIDGE may be used on either MDA, CGA, EGA or Hercules adapters.
  474.  
  475.  
  476. -------------------------------------------------------------------------------
  477. Related release; CCOLOR:
  478. -------------------------------------------------------------------------------
  479.  
  480.     CCOLOR is another accessory for conferencing.  It tracks the conver-
  481.     sation, and assigns different colors to each speaker.  Each speaker's
  482.     text is highlighted and easy to see.  Of course, a color adapter,
  483.     CGA or EGA is required.  It has to be seen to be appreciated!
  484.  
  485.  
  486.     CCOLOR may be used on either CGA, or EGA adapters.
  487.  
  488.  
  489.     CCOLOR has been distributed (its third release) as CCOLOR12.ARC.
  490.     Predictably, a new release of CCOLOR (1.3) may be expected shortly
  491.     after COM-AND 2.8's release, to accomodate the new backscreen
  492.     function.  It will be available as CCOLOR13.ZIP.
  493.  
  494.