Garbo

home *** CD-ROM | disk | FTP | other *** search

/ Garbo / Garbo.cdr / pc / termprog / ca28_3.zoo / readme.doc < prev next >

Wrap

Text File | 1991-07-26 | 21.5 KB | 494 lines

------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 1 ------------------------------------------------------------------------------- This release of COM-AND: ------------------------------------------------------------------------------- o This is the ninth release of COM-AND (version 2.8). This release corrects problems reported with version 2.7 and adds features. o Run instructions and installation procedures will be found following this page. o Changes to the previous version (additions and corrections) are to be found following run/installation pages. o The author asks for comments and criticisms of this program. You may contact the author: CABER Software PLINK, GEnie, Delphi: TARTAN R. (Scott) McGinnis UNISON: SCOTTM (PARTI: Scott McGinnis) P.O. Box 3607 Mdse Mart CIS: 73147,2665 Chicago, IL 60654-0607 ------------------------------------------------------------------------------- Release history (not including public beta releases) ------------------------------------------------------------------------------- 860806: PC-VCO 1.0 860929: PC-VCO 1.1 861119: PC-VCO 1.2 861222: PC-VCO 1.3 861226: PC-VCO 1.31 870814: PC-VCO 2.0 COM-AND 2.0 CCHESS 1.0 871202: PC-VCO 2.1 COM-AND 2.1 CCHESS 1.1 871211: CBRIDG 1.0 880122: CCOLOR 1.0 880713: PC-VCO 2.2 COM-AND 2.2 CCHESS 1.2 CBRIDG 1.1 CCOLOR 1.1 881202: COM-AND 2.3 890309: COM-AND 2.4 891020: COM-AND 2.5 900426: COM-AND 2.6 901019: COM-AND 2.7 CACMP 1.0 901213: CCOLOR 1.2 910801: COM-AND 2.8 CACMP 1.1 (You are here) ------------------------------------------------------------------------------- ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 2 ------------------------------------------------------------------------------- Files in this distribution: ------------------------------------------------------------------------------- CA28-1.ZIP: COM-AND.EXE 2.8 executable program file COM-AND.PIF PIF file for Windows COM-AND.DVP DVP file for DesqView COM-AND.ICO WIndows 3.0 ICON file (Dr. David Snyder thank you!) README.DOC This file. REGISTER.DOC Registration form VENDOR.DOC Limitations on commercial redistribution CA28-2.ZIP: COM-AND.DOC Documentation for version 2.8 manual functions CASCRIPT.DOC Documentation for version 2.8 script language README.DOC This file. REGISTER.DOC Registration form VENDOR.DOC Limitations on commercial redistribution CA28-3.ZIP: SCRIPTS.DOC Summary documentation for scripts README.DOC This file. REGISTER.DOC Registration form VENDOR.DOC Limitations on commercial redistribution *.CMD; *.DOC REMAP.CMD, XLATE.CMD, LEARN.CMD, FILEMGR.CMD... *.SRC Commented scripts where *.CMD has been stripped CA28-4.ZIP: CACMP.EXE COM-AND script syntax/semantic check CACMP.DOC Documentation for CACMP.EXE OVERLAY.* Sample script overlay files TALKER.* Sample script overlay supporting limited speech synth VOICE.* Voice driver and documentation for TALKER VEND.COM Voice driver termination utility PC-VCO.EXC Exception file for TALKER.CMD script README.DOC This file. REGISTER.DOC Registration form VENDOR.DOC Limitations on commercial redistribution ------------------------------------------------------------------------------- * COM-AND creates any files it requires that it does not find on the drive:subdirectory where it is loaded (or on the drive:subdirectory where the environment variable COM-AND= directs the processor) ------------------------------------------------------------------------------- * To print the document files, dearc the file onto disc and use the DOS command "PRINT <file>.DOC". COM-AND documents are formatted 54 lines to the page, with top-of-forms as page breaks, using tab characters. ------------------------------------------------------------------------------- ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 3 ------------------------------------------------------------------------------- Notice: Changes in this version of COM-AND require attention: ------------------------------------------------------------------------------- * Version 2.7 of COM-AND changed the self-encryption algorithm for use with script files. Script files password-lessly encrypted by version 2.6 or before must be re-encrypted for use with this version of COM- AND. Scripts encrypted with version 2.7 will work fine with 2.8. Please re-encrypt any self-encrypted scripts encrypted for version 2.6 or before, from its original. Scripts self-encrypted with 2.6 or before will not work under 2.8. ------------------------------------------------------------------------------- * This version continues a feature that may startle some and bore most, providing a base for simplified installation of COM-AND. If COM-AND is loaded on a subdirectory where no COM-AND.DFT resides, AND if the environment variable COM-AND= does not point to a subdirectory where COM-AND.DFT may be found, COM-AND creates a new .DFT file. A script named INSTALL.CMD is included with this release. If COM-AND creates its .DFT file (as opposed to updating an existing one), and if the script INSTALL.CMD is available, INSTALL is invoked automatic- ally upon completion of initialization. The INSTALL.CMD script included with this release is a move towards simplified installation, especially where the individual does not have years of experience with modems and comm programs. It is hoped that the script included with this release will grow over time, with suggestions and comments. INSTALL may be manually invoked through the F2 window, of course. However, it is suggested that you delete INSTALL.CMD after use, to salvage precious disk space. ------------------------------------------------------------------------------- * This version of COM-AND changes the nature of the backscreen opera- tion. This change invalidates the backscreen functions in all pre- viously released accessories (PC-VCO, CCOLOR, CCHESS, and CBRIDGE). Previously released accessories simply report 'last page' if their backscreen is invoked with this version. CCOLOR is being updated to accomodate this change (a beta is available at this date). ------------------------------------------------------------------------------- ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 4 ------------------------------------------------------------------------------- Run instructions: ------------------------------------------------------------------------------- o To run COM-AND from the DOS prompt, install the release as described below, then type: C> COM-AND <carriage return> ------------------------------------------------------------------------------- Installation: ------------------------------------------------------------------------------- 1) Set the current subdirectory to the subdirectory where you wish to install COM-AND... where you've already installed previous COM-ANDs (if you've used one). I'd suggest "\COM-AND". 2) Dearc the distribution file. Have a care not to overwrite files you want to keep! 3) Load COM-AND (i.e. COM-AND <return>). If this is the first time, follow the prompts provided by INSTALL.CMD (automatically invoked). After INSTALL (if INSTALL was automatic) and otherwise: o Check Alt-S .. Check modem parameters - you may want to change them. .. The backscreen buffer size defaults to 4K. It may be set up to 64K, for redisplay and transcripting. .. Remember to save the new settings. o Check Alt-P .. Check the COM port you use (1/2/3/4). .. Default speed selection is not usually important (if you always use the dialing directory). Set it anyway. .. Remember to save new settings. o Check Alt-O .. Set flags the way you want them (e.g. exit query on, d*mned advert off, and so on; Note BIOS/DIRECT and PCJr settings) .. Remember to save new settings. 4) Review the accessories (F1). You may review the contents of accessory definitions with the 'r' subcommand. You may wish to add entries for a listing program and editor.. and perhaps PC-VCO... CCOLOR... Remember to save... 5) Exit COM-AND with Alt-X, and restart. ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 5 ------------------------------------------------------------------------------- Additions and corrections this release: ------------------------------------------------------------------------------- --------------------------------------- Changes and corrections to 2.7 COM-AND: --------------------------------------- o Changed BIOS send to wait on THRE (should not be necessary) o Changed MACROs to use grave (`) as a forcing character as scripts o Changed Alt-D to invoke redial display (and function) when dialing o Changed modem status display to widen by 6 chars in redial display o Changed input-pop-up over Alt-O to uncover current settings o Changed highlight bars to 'follow' Home and End keys in all windows o Changed method of display within a menu window to speed display o Changed LD code as suffix as well as prefix in Alt-D. Suffixing and prefixing LD codes are now independent! [Suffix is added to dialing string after the number and before Modem Suffix String of Alt-S.] o Changed to force previously released accessories to report 'last page' on a backscreen request with this version of COM-AND o Changed Alt-B backscreen. Drastically revised. By popular demand. o Changed Alt-A, when setting OFF, not to scroll display down o Changed all aux files to be opened read-only at program initialization to accomodate scripted LAN users (DFT, TUN, XLT, RMP, MAC, DIR, ACC) o Changed BIOS run time parm to allow port other than 0,1,2 or 3 to be used. E.g.: "d>" COM-AND BIOS(5) o Changed redial to send init to modem during hangup if option set o Changed ZMODEM to send cancel sequence SLOW; buffered send would often fail at high speeds o Corrected Alt-O to set/reset Alt-A correctly when Alt-O closed o Corrected XMODEM to allow checksum send... was doing CRC o Corrected YMODEM to display retries o Corrected YMODEM/BYMODEM/BYMODEMG to test for ESC after NAK received o Corrected Alt-D to display entry # invoked by script DIAL on next manual use (highlight and page disp were OK). o Changed all references to 56k baud to 57k baud o Changed SLOW XFER to default ON, and XSUI to 5 when DFT file created (does not affect existing DFT values) o Changed hardware flow control references to 'unidirectional' and 'bi- directional' after polling interested parties o Changed /R runtime switch to set bidirectional flow control instead of unidirectional flow control o Corrected RTSF/RTSD/HARDFLOW to avoid sequence sensitivity in setting o Corrected BIOS redirection to accomodate parity/data bits changes while port it open (during file transfers) o Improved the speed of the ANSI (and therefore VT100) display driver ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 6 ------------------------------------------------------------------------------- Additions and corrections this release: ------------------------------------------------------------------------------- ------------------------- Additions to 2.7 COM-AND: ------------------------- o Expanded BBS script (maintenance and setup scripts) o Expanded HOST script (maintenance, setup scripts and DOORWAY) o Added /H runtime switch to inhibit any change to screen mode on entry o Added /Q runtime switch to inhibit COM-AND.CMD auto-execution o Added (attempted to) clear of XOFF pending during Alt-H and dialing o All file transfer stat windows may now be 'moved' during a file trans- fer, with cursor up, down, right and left. o The query for file name, prior to a file transfer, is movable too o If no backscreen is configured, F8 doesn't ask to add backscreen o If no backscreen is configured, Alt-B now says so o The critical error handler now reports disk/nondisk information o Added cumulative send error status to Alt-Y o Added status line, remote function key, and wrap settings to Alt-V o Added ANSI escape sequences: ESC '[?7h' and ESC '[?7l' (wrap on/off) o Added Alt-Minus to toggle remote function key usage ------------------------------- Script changes and corrections: ------------------------------- o Corrected MDIAL to NOT issue error message if ESCape is used to exit o Corrected FOPENO to handle files one byte long containing only ^z o Corrected GET, MGET etc to NOT modify target string if ESC aborted (previously rtnd content up to the ESC) o Corrected FKEY to NOT implement ESC if ESC is pending. Early action caused a problem with the interpretation of compound conditionals. o Changed all references to 56k baud to 57k baud (SET BAUD) o Changed the OVERLAY statement to include an optional end-address entry point. The end-entry point is ALWAYs executed before an overlay is terminated. No parameters may be passed. See appendix, below. ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 7 ------------------------------------------------------------------------------- Additions and corrections this release: ------------------------------------------------------------------------------- ------------------------------- Script language additions: ------------------------------- SET INTRINSIC ON!OFF ; En/Disable string intrinsics SET MCR <number> ; Write MCR value SET MULTI ON!OFF ; Control PLAY statement mode/tempo default ; This command is not in CASCRIPT.DOC SET OVENTRY (NONE!<addr>) ; Set/reset overlay end entry addr SET REMFTNS ON!OFF ; Enable/disable remote function keys SET STATUS ON!OFF ; Enable/disable status line display SET WRAP ON!OFF ; Set line wrap on/off SET ZMODEM BLOCK 0 ; Resets to default (fdx) SET ZMODEM BLOCK 1024 ; Now allowed (previously -> hdx) OVERLAY <fname> [<addr>] ; Load overlay; <addr> is optional MCR Nx ; Read MCR value ------------------------------------------ Script language intrinsic functions added: ------------------------------------------ _COMM ; Rtns 'DIRECT' and 'BIOS' _OVEN ; Rtns NONE or overlay end entry addr _PORT ; Rtns value: 0,1,2... according to port ... ; .. set when COM-AND was run (BIOS parm) _REMFTN ; Rtns value: ON!OFF (remote ftn keys) _STATUS ; Rtns value: ON!OFF (status line display) ---------------------------- CACMP additions and changes: ---------------------------- o Corrected FDATE in lexicon (for optional 1/0) o Corrected STACK in lexicon (added STACK CLEAR) o Changed SET PORT to allow string var; similarly changed the lexicon for COMBASE, COMVEC, SET COMB and SET COMV o All text output may now be redirected to a file o Updated for all script changes above o Added list of variables used in script to output summary ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 8 ------------------------------------------------------------------------------- Updated scripts in CA28-3: ------------------------------------------------------------------------------- LEARN.CMD A script that writes a script for you PC-2-PC.DOC PC to PC file transfers UARTTYPE.CMD Determine uart used on your machine DOORWAY.CMD (new) Invoke DOORWAY (you must edit this before use) BBMAINT.CMD (New) Maintenance script for the BBS BBMAINT1.CMD (New) BBMAINT extension script (users) BBMAINT2.CMD (New) BBMAINT extension script (files) BBMAINT3.CMD (New) BBMAINT extension script (bulletins) BBMAINT4.CMD (New) BBMAINT extension script (mail) BBS.CMD Ver 1.1 BBS script (stripped) BBS.DOC Ver 1.1 BBS documentation BBS.SRC Ver 1.1 BBS script (commented) BBSETUP.CMD (New) Setup script for the BBS HOST.CMD Ver 1.1 HOST script (stripped) HOST.DOC Ver 1.1 HOST documentation HOST.SRC Ver 1.1 HOST script (commented) HOSETUP.CMD (New) Setup script for the HOST HOSTART.CMD (New) Restart script for the HOST and doorway ------------------------------------------------------------------------------- Known bugs in the current release: ------------------------------------------------------------------------------- o KERMIT 12 and 16 bit checksums don't seem to work with Jan van der Eyjk's PCKERMIT. I have not yet found the incompatibilty. o Reports have been received, but could not be reproduced, of the CPU clock losing time. No instances have been found due to COM-AND. Several instances have been tracked to TSR's and special hardware (e.g. ALL-Charge card). Some reports suggested that the clock speeds up (!) when run in the background under DesqView. If you experience a clock that 'lags' (loses time) using COM-AND, it is suggested that you run COM-AND with the /w switch. The /w switch disables the interrupt driven write feature. Transfers under DOS will be only marginally slower. Please report clock problems you experience to the developer. ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 9 ------------------------------------------------------------------------------- Related release; PC-VCO: ------------------------------------------------------------------------------- PC-VCO is Visual Conferencing for the IBM PC. It is completely compatible with all three flavors of MacIntosh VCO/VMCO. It has been in use for more than a year by several groups of people. On GEnie, the IBM RT has a regularly scheduled VCO conference every Wednesday at 9PM Eastern Standard Time. The concept of VCO is that each conference attendee draws a set of 16 (or 18) ICONs, and posts them publicly. Other attendees down- load the ICONs (called face files), and add them to their own lib- rary of faces. 8 (or 9) expressions (happy, sad, etc) are supported. When someone speaks in a VCO conference, the appropriate ICON is displayed on all PC-VCO screens. People who've not uploaded face files are depicted as Charlie Brown, Don Martin, or OPUS. PC-VCO interfaces to a public domain text-to speech synthesizer. The quality is less than might be desired, but its a start! PC-VCO now includes its own speech driver for faster processors. PC-VCO has been distributed (its seventh release) as PC-VCO22.ZIP. PC-VCO may be used on either CGA, EGA or Hercules graphics adapters. ------------------------------------------------------------------------------- Related release; CCHESS: ------------------------------------------------------------------------------- CCHESS is Conference Chess - two people can play chess over PLINK's PARTY, CIS CB, etc. CCHESS provides a graphics depiction of a chess board, and a log of the last few moves. Game play can be performed entirely with a mouse (if you desire - not necessary). Games may be saved, and restored later for continuation. Version 1.2 is a production release - beta testing is complete. However, I am still looking for comments, criticisms and thoughts from those interested in on-line interactive gaming. CCHESS has been distributed (its second release) as CCHESS12.ZIP. Please read the CCHESS.DOC document for a description of CCHESS. CCHESS may be used on either CGA, EGA or Hercules graphics adapters. ------------------------------------------------------------------------------- 910725 COM-AND 2.8 Page 10 ------------------------------------------------------------------------------- Related release; CBRIDGE: ------------------------------------------------------------------------------- CBRIDGE is Conference Bridge - four people can play bridge over PLINK's PARTY, CIS CB, etc. CBRIDGE deals cards, displays hands, displays (and protects) the bidding, and monitors game play. Bidding can be reviewed at any time, as can game play. Version 1.1 has completed its beta trials. It has found quite usable. It may be 'rough' in spots... I am looking for comments, criticisms and thoughts from those interested in on-line interactive gaming. CBRIDGE has been distributed (its first release) as CBRIDG11.ZIP. Please read the CBRIDG.DOC document for a description of CBRIDGE. CBRIDGE may be used on either MDA, CGA, EGA or Hercules adapters. ------------------------------------------------------------------------------- Related release; CCOLOR: ------------------------------------------------------------------------------- CCOLOR is another accessory for conferencing. It tracks the conver- sation, and assigns different colors to each speaker. Each speaker's text is highlighted and easy to see. Of course, a color adapter, CGA or EGA is required. It has to be seen to be appreciated! CCOLOR may be used on either CGA, or EGA adapters. CCOLOR has been distributed (its third release) as CCOLOR12.ARC. Predictably, a new release of CCOLOR (1.3) may be expected shortly after COM-AND 2.8's release, to accomodate the new backscreen function. It will be available as CCOLOR13.ZIP.