Recent Revision History ----------------------- This file contains a list of changes to the current release and also to several recent releases. If you have used {COMMO} before, please make sure you are caught up on all the changes and improvements. ----------- --------------- {COMMO} 5.0 August 28, 1991 ----------- --------------- Support File changes since last release --------------------------------------- Changes are required to the Configuration File and Macro File. Some changes may also be needed in your Dialing Directory. Read the sections below carefully and also the appropriate sections in COMMO.DOC and MACRO.DOC (now a separate Macro Programming Guide). Configuration File ------------------ The Config File has been replaced with a keyworded Setup File. This means that items may be in any order and may vary in number. In the future it will only be necessary to add new items if the new features are desired. New items in this release include: {ddp=2400,8n1,1,A,0} Default Dialing Parameters {min=yes} Send Modem Init String (yes/no) {mac=initmac} Startup macro label {sts=yes} Status Line on (yes/no) {ers=yes} Make sounds on errors/warnings (yes/no) Plus any number of SET items to set string variables. Keep in mind that the Setup File is only processed at startup. It may be edited with the Alt-G command, but the changes do not take effect until the next time {COMMO} is started. A new command "[Alt-T] Set Toggles" has been added to allow changing many toggle parameters without affecting the permanent setup. Dialing Directory ----------------- A set of Default Dialing Parameters (separate from the Current Terminal Parameters) is now maintained by {COMMO}. These parameters are set whenever a number is dialed unless overridden by a parameter string in the Directory entry. They may be changed in the "[Alt-P] Set Terminal Parameters" window or with the DPARms macro function. The telephone number field can now have variables to be used as additional prefixes, suffixes or any other way that you can think of. Read the Dialing Directory section in COMMO.DOC if you need to use this feature. Macro Processor --------------- The PgUp and PgDn keys are now used to bring up new Upload and Download menus. If you need to use these keys for full-screen editing, change the key-labels in the menus (use F6 in the editor to scroll to the right). You can now define and use string variables within all macro functions. Read the section "Programming {COMMO} Macros" in MACRO.DOC for complete details. Macro-id's are now called Macro Labels. They may be any number of characters of which the first eight are significant and they must be preceded by a colon. For example: {:label}. Key-id's are now called Key-labels and must have a colon, also. See MACRO.DOC for details. A new feature, called Function Switches, allows you to add modifiers to certain function names to change the action of the function. The list of functions in Online Help shows which functions may have switches. Here are some examples: {asci-e file,xyz} ASCII Upload, expand blank lines {asci-s0 file,xyz} ASCII Upload, do not strinp linefeeds {exec-d c:\util\dsz.com} Direct EXEC All of the "%" parameters in the EXEC function have been eliminated. Some have been replaced with string variables, others with switches. And instead of "%i" you must now use the new INPUt function prior to the EXEC. These macro functions have been deleted: CONFig, DELAy, EXED, EXEN, TERMinal. New macro functions are as follows: ABAUd This replaces the former AUTObaud. AUTOreceive Set/reset Auto Receive strings. COMPare Compare strings, set conditions. DECRement Subtract from a numeric variable. DPARms Set Default Dialing parameters. EDIT Edit an external file. ELAPse Reset the elapsed timer to 0. GETString Get a string from the modem. HFLOw Toggle Hardware Flow Control. IFCOndition Test conditions set by COMPare. INCRement Add to a numeric variable. INPUt Input a string from the keyboard. INSTring Find a string within a string. LENGth Determine the length of a string. RCLOse Close the read file. READ Read from a disk file. ROPEn Open a file for reading. RXMOdem Receive a file using Xmodem. SETEsc Set a label to GOTO when Esc is pressed. SETGet Set parameters for GETString. SETVariable Assign a string to a variable. SFLOw Toggle Software Flow Control. SPOCtrl Serial port output control. SUBString Extract a substring from a variable. SXMOdem Send a file using Xmodem. TOGGles Open Set Toggles window. WCLOse Close the write file. WOPEn Open a file for writing. WRITe Write to a disk file. Since there is no longer a specific item in the Setup File for upload path (this is now a user-defined variable), the ASCII Upload window will not normally show a path in the input field. You can put in any path you like now by using the macro: {:ala} {asci %uldir%\,:} Use any path or variable. Notice the "\" after the path variable. This indicates to bring up the window with the path displayed in the input field. When a macro is running, messages from functions (such as LOOKfor, PAUSe, etc.) will now be displayed on the left side of the Status Line. General ------- {COMMO} now has internal Xmodem. This is provided for convenience and can also result in reduced memory usage. It supports 128 byte or 1k blocks and CRC or checksum modes. A new key command "[Alt-T] Set Toggles" allows changing many toggle parameters without changing the permanent setup. The following individual toggle key commands have been eliminated, but may be restored using macros: Alt-3 Master Sound toggle Alt-4 AutoBaud toggle Alt-5 Local Echo toggle Alt-0 Signal Lights toggle The F1 key is now used for Online Help throughout the program. To make this consistent in the Internal Editor, the F1, F2 keys to type curly braces have been changed as follows: F2 now types left and right braces alternately (it is reset to left brace when you move to a new line). F9 and F10 will type left and right braces, respectively. And F7 is now the key to bring up the Color Chart. Alt-U is now used for the Utility Menu. Multi Number Dialing is now started using Alt-N in the Terminal Screen and in the Dialing Directory window. Online Help now requires fewer keypresses to get to a topic. Just press the new two character topic code (no Enter necessary). Also the "keys" in the topic separators are now "T" followed by any character. So if you add your own topic, say "TX", you can bring it up by typing "TX" in the Help window. You can also use the macro function {help x}. Support has been increased for blind users with speech synthesizers. Many prompts and error messages are now displayed through the BIOS when the "BIOS Terminal Screen and errors" option in the Setup File is set to "yes." The "Other copy of {COMMO} running" message was being erroneously displayed after some ill-behaved programs were run. I have added an additional check to guard against this. The window with the question "Initialize modem?" has been removed. An item has been added to the Setup File in its place: {min=yes/no}. You can also use the command line switch: "/iy" or "/in" to override this setting. Using an "=" in command line switches is no longer permitted. So if you have a "/i=y", you must change it to "/iy". Some new command line switches have been added. These override Setup File items where applicable. Here is a summary of all command line switches: /iy, /in Initialize, don't initialize modem. /:label Startup macro. /sfilename Alternate Setup File. /dfilename Alternate Dialing Directory file. /mfilenmae Alternate default Macro File. /knn Size of Scrollback Buffer in kbytes. A new search function has been added to the file windows. In addition to "S", search for string from top of file, and "A", search again from top of page, there is now "D", search for a new string from top of page. The corresponding function in the Internal Editor is "Alt-D". You can now navigate in a triangle among the Macro Processor, Scrollback and Dialing Directory windows without having to exit to the Terminal Screen. There is a new input line editor for entering search strings, manual phone numbers, pathnames, etc. Keys supported are: right/left arrow, home/end, backspace, insert/delete and Alt-Y (clear input field). An "*" next to the column number in the Internal Editor indicates that the file has outstanding changes. A count of characters received from the serial port appears in the upper left hand corner of all full-screen windows. The wrapping of the last screen column in ANSI-BBS emulation has been changed to conform to the method used in VT102. I.e, the cursor will not wrap on the last column until another character comes in. This prevents double-spacing when lines are exactly as wide as the screen. I have stopped using the BIOS for serial port initialization. There were too many non-compatible BIOS's. PCjr users will have to specify Com2 now if the internal modem is not installed. ------------ ------------ {COMMO} 4.54 May 20, 1991 ------------ ------------ Support File changes since last release --------------------------------------- No changes are required to any of the support files. Bugs Fixed ---------- If carrier dropped while a macro was running and the "r" parameter was specified in a prior MACLoad function, macro processing would continue at an unpredictable location. The reload will now wait until macro processing has STOPped (also, the reload is cancelled by another MACLoad). Scrollback was refusing to display past an EOF character (ASCII 26). This caused part of the buffer to be unviewable at times. Internal Editor --------------- You can now split lines and join lines in the Internal Editor! To split a line at the cursor, just press Enter when Insert Mode is on. To join two lines, just press Del when the cursor is at the end of the line. Or press Backspace when the cursor is in column 1. Dialing Directory ----------------- Due to the public outcry concerning the change to the DIAL function, I have added a third parameter. This allows the function to behave as it did in releases prior to 4.53. Writing: ... {dial ,,c} ... will cause the Linked Macro to be started with a CALL instead of a GOTO. The final RETUrn will transfer control back to the DIAL function, resuming Multi Number Dialing if any more systems are marked. PUSH and POPS are not necessary when the "c" parameter is used. Macro Processor --------------- It is no longer necessary for the Selector Bar to be positioned on a macro-id to start a macro. Processing will start at the first macro-id or function on the selected line. This makes it a lot easier to test macros by starting at various locations. Also, macros in menus no longer require dummy macro-id's. The SETLook parameters (LOOKfor timeout, prompt response) are now reset to no timeout and no prompt response whenever macro processing stops. This will prevent undesired actions when the next macro is started. The split/join addition to the Internal Editor should make it a lot easier to write and maintain macros (see above). A string may now be specified in the MACRo function. The line on which the string appears will be displayed as the top line when the Macro Processor window is opened. This is intended for creating menus. For example: {nf6} {macro menu1} {} will search for the first occurrence of "menu1" and display from there. Macro errors are now reported in the Macro Processor window. The offending line is under the Selector Bar at the top of the screen. General ------- The opening Shareware advertisement will automatically terminate after 60 seconds if the key is not pressed. This will allow testing of unattended macro runs with the unregistered version. The Left Arrow and Right Arrow keys may now be used to scroll the screen when the Selector Bar is active (in addition to F3 and F4). This change applies in the Dialing Directory, Macro Processor and Scrollback windows. ------------ -------------- {COMMO} 4.53 March 29, 1991 ------------ -------------- Bugs Fixed ---------- The "other copy of {COMMO} running" check was causing a QEMM exception report on some Compaq 386 machines. The terminal emulation "insert mode" (ANSI-BBS, VT102) was not moving characters to the right as new characters were typed. This would sometimes cause {COMMO} to crash. The blinking message with the alarm was not always seen under DESQview. A "\" was being added to the upload path in the ASCII Upload window even if there was no path or only a drive designator. In an effort to reduce the number of erroneous {Off} log entries, I have stopped writing them unless an {On} entry has been made first. This will help modems with carrier detect "bounce." Macro Processor --------------- IMPORTANT: The DIAL macro function has been changed. When there is a Linked Macro in the Dialing Directory, {COMMO} will now do a GOTO instead of a CALL to the Linked Macro. A RETUrn at the end of unattended macros no longer goes back to the DIAL function. If there is nowhere to return to, the macro will STOP. Here are some details (see COMMO.DOC for more): o To continue dialing automatically these macros should end with (or GOTO) the following sequence (or variation thereof): ... {setlook 60} {lookfor ^jNO CARRIER^m} {dial ,} {} o This means that you can now call more than one system automatically when you: 1) Use Dialing Strings on the command line. 2) Mark numbers manually and press Alt-U. New function (see COMMO.DOC for details): IFCArrier This function will test for the presence of carrier detect. There is no longer a restriction on when COMMO.MAC can be reloaded when using the "r" parameter of the MACLoad function. If you are in a file window (including the Macro Processor), it will reload when the window is exited. Some of the macros in MACROS.TXT have been updated. In particular, the Generic Login Subroutine will now handle more boards. General ------- The Auto Receive feature has been improved. There is no longer a time period following a trigger when another one is disallowed. Instead, the serial port input buffer is cleared when returning from an EXECute-type function (during the trigger macro only). The Capture Mode can now be changed manually in the Capture File Options window. A Status Line message will be displayed during SEND functions that have any (~) delay characters. ------------ ------------- {COMMO} 4.52 March 2, 1991 ------------ ------------- Bugs Fixed ---------- A few users were having a problem with output data being sent repeatedly. The program had to be terminated to get out of it. I was unable to recreate this myself (I suspect flaky hardware). I have changed the transmit logic to accommodate more conditions and I would appreciate hearing from anyone who had this problem. The prompt timer in the LOOKfor function was expiring early when a beep was sounded. This caused difficulty in PCBoard login macros, for example, causing an "n|" to be sent too soon. The timer for the modem init string at program startup was beginning before the string was sent instead of after, leaving very little time for the modem to settle before dialing began. -------------------- Support File Changes -------------------- Configuration File ------------------ This release uses the same configuration file as 4.5 and 4.51. Dialing Directory ----------------- The [M] command, Manual Dial, no longer makes an entry in the Directory. Instead the number last entered is displayed when you press [M] again. [N] is no longer an option. Sorry, but this feature was incompatible with some of the recent changes and had to be sacrificed. Macro Processor --------------- Macro Processing has been streamlined to make execution of long macros even faster. The macro error window will now show the closest macro-id prior to the errant function. Now you can have as many as 15 GOLOoks plus the LOOKfor, for a total of 16 strings that can be scanned for at one time. New functions (see COMMO.DOC for details on these functions): STATusline This function will turn the Status Line on or off at any time. PUSHstack This will save a macro location to the macro stack. It is primarily useful for turning GOLOoks into subroutine calls. POPStack Removes an element from the macro stack. Used when a return from a GOLOok is not needed. General ------- Now you can press the [Spacebar] in ASCII Upload to get things moving when {COMMO} is waiting for a pacing character that won't come. This helps when you have specified the wrong pacing character or if you intentionally want to manually pace the output, line by line. A new key has been added in the Scrollback window. Pressing [C] will let you change the Screen Image pathname without leaving the window. Doorway Mode will now use the number of text lines on the display (instead of forcing 25 lines). This means that you must set the display correctly before starting {COMMO}. Most Doorway applications require the normal 25 line display, but {COMMO} will now handle more lines if required. The Status Line may now be turned on while in Doorway Mode. See the details under "Doorway Mode" in COMMO.DOC. Also, the DOORway macro function no longer has a y/n argument. It was too easy to get stuck in Doorway Mode! VT102 terminal emulation has been improved by holding the cursor in column 80 when 80 column lines are displayed. This will prevent double spacing when linewrap in on (linewrap now defaults to ON when you switch emulations). A message will be displayed for several seconds at startup if another copy of {COMMO} is running. This warning is intended to reduce the chance of losing support file data when files are saved at program exit (does not seem to work between DESQview windows, however). -end-