====[ v2.0E ]============================================================== To use an external tagline manager you MUST complete the return file field. Borland's DMPI does not like Dan Moore's secret memory method. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- ====[ v2.0d ]============================================================== First protected-mode version. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- PKZIP's DPMI is not compatible with the DPMI that SPEED uses (Borland's). Therefore you must add the -) switch to both your ZIP and UNZIP commands. See (ALT-C) Compression Prgs., ZIP, -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Swap File Megs: (ALT-C), Work/RAM Disk SPEED allows you to use disk space as virtual memory. This is particularly useful if you have limited XMS/EMS memory. Enter in this field the amount of megs of disk space you want to set aside as virtual memory. Note that if there is insufficient disk space to accommodate the amount of virtual memory requested, SPEED will not use any disk space as virtual memory. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Keep Swap File: (ALT-C), Work/RAM Disk When SPEED is set to use virtual memory with the Swap File Megs option, it creates a file in the SPEED directory called $VIRMEM.SWP. This option allows you to define whether this file is permanent or if it is created each time SPEED is run. The advantage to leaving this option "On" is it guarantees there will always be sufficient disk space for the swap file. Also SPEED will startup slightly faster when it doesn't have to create the swap file, though the speed difference is negligible on newer equipment. The obvious disadvantage of setting this option to "On" is the loss of disk space when SPEED is not running. ====[ v2.0c ]============================================================== Added #cur_msg# replaceable variable. This variable saves the message text (no header or tagline) to a file and returns the full path name of the text file. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Blank Reply: This toggle allows you to selectively quote from a reply instead of quoting the entire text. When this toggle is On, nothing is passed to your editor except what was quoted using the (Q) and (ALT-Q)/(CTRL-Q) commands. When this toggle is Off, the entire message text is quoted and passed to the editor along with any additional quotes marked with the (Q) and (ALT-Q)/(CTRL-Q) commands. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- MARK TWITS AS READ OR KILL This toggle allows you to automatically mark twitted messages as Read or Killed. If you do not ever want to see the messages, select Kill. This will will mark them for deletion the next time a packet is imported or the conference is pruned. If you select Read, the messages will flow out of the conference normally as any other read message. If you want to later go back and read the twitted messages, then select None. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Picklist Wildcards You may use DOS legal wildcards when entering text into the search field. The (*) asterisk represents a group of character at the beginning or the end of text. The (?) question mark represents a single character anywhere in the search text. For example: Search Word Matches SPEED SPEED SPEED* Any entry beginning with "SPEED" ("SPEED","SPEEDY", "SPEED READ", etc). *SPEED* Any entry containing the string "SPEED" ("SPEED", "SPEED READ","SUPER SPEED","MY SPEED READ",etc). ?ow Any 3 letter entry ending with "ow" (how, cow, etc). ====[ v2.0b ]============================================================== Backup Command If this field in not blank, SPEED will execute the command in this field to back up a message base before a QWK packet is imported. To disable this function, blank this field out. Enter the DOS command, including command line options, needed to execute the compressor program to perform a backup. If the program is not located within your PATH, the full path should be included. You should always have at least 1 command line option, %s. Use %s (the %s MUST be lower case) where the archive filename would go. SPEED will replace %s with the actual filename. For example: Backup: pkzip -uex %s -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- SYMBOLIC LANGUAGE Some languages (such as Chinese and Japanese) use a symbolic character set instead of an alphabet. These languages make extensive use of high-bit characters to extend the number of available characters. SPEED uses the high-bit characters to draw lines and boxes. This can produce a confusing display. This toggle converts high-bit line drawing characters to comparable >> low-bit characters, in selected places. Also when this toggle is On >> SPEED excludes high-bit characters when determining a quote. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- CARBON COPIES A "Y" in this field allows you to send carbon copies to other users. After the regular message is completed, the Header Window will reappear with a title of Carbon Copy and the number of the current carbon copy. Enter the new information, and press (TAB). To quit press (ESC) or change the CC: field to "N". By default, a carbon copy message will announce it is a carbon copy, show who the original message was to and which conference it was in. >> The carbon copy announcement is stored in the file CARBON.SR and can >> be customized. An asterisk (*) in this field is the same as a "Y", except the carbon copy header is not added at the beginning of each message. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- AUTO SIGNATURE When this toggle is "On", SPEED will add your custom signature to the bottom of all your replies and/or a custom header at the top of your message. The signature is stored in the file SIG.SR and the header is stored in the HEADER.SR file. If SIG.SR and HEADER.SR do not exist, use a text editor to create one or both of them in your SPEED directory. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- (CTRL-F) The Forward Message command (CTRL-F) allows you to redirect a message to another person. This is especially useful if the other person does not follow the conference where the message originated. By default, a header is added to let the user know the message was forwarded, when the original message was written and the original people involved. The forwarded message announcement is stored in the file FORWARD.SR and can be customized. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- REPLACEABLE VARIABLES SPEED supports several replaceable variables. Replaceable variables are entered directly into a reply and SPEED automatically inserts the referenced text into the final reply. In SPEED replaceable variable are most often used in the files CARBON.SR, FORWARD.SR, HEADER.SR and SIG.SR. Replaceable variables are also available in fields used to run external programs (i.e. editor, tagline manager, DOS command, etc). In the descriptions below, "Original" refers the message to which you are replying. "Original" variables are prefaced with an "o_". "First" refers to the first reply in a series of carbon copies. "First" variables are prefaced with a "f_". "Current" refers to the reply you are generating. #bbs# - Current BBS. #o_bbs# - Original BBS. #f_bbs# - First BBS (used in CARBON.SR). #conf_name# - Current conference name. #o_conf_name# - Original conference name. #f_conf_name# - First conference name (used in CARBON.SR). #conf_num# - Current conference number. #o_conf_num# - Original conference number. #f_conf_num# - First conference number (used in CARBON.SR). #to# - Current To: field. #o_to# - Original To: field. #f_to# - First To: field (used in CARBON.SR). #first# - First name of #to#. #last# - Last name of #to#. #o_from# - Original From: field. #o_subject# - Original Subject: field. #date# - Today's date in mm-dd-year format. #o_date# - Original message's date. #month# - 2-digit month (system date). #day# - 2-digit day (system date). #year# - 2-digit year (system date). #time# - Today's time in hh:mm format. #o_time# - Original message's time. #reply# - Full pathname to $REPLY.SR. #refer# - Full pathname to REFER.SR. #cur_msg# - Text file of displayed message (no header or tagline). #tag# - Inserts a randomly selected tagline. #no_tag# - Eliminates tagline in current message (Reg. Off). The case of replaceable variables, if applicable, is determined by the first letter of the variable (i.e. #bbs# would return "Lunatic" while #BBS# would return "LUNATIC"). ====[ v2.0a ]============================================================== Exclude/Include Quote: When displaying a message, SPEED tries to determine which lines are quotes so that they may be highlighted with a different color. SPEED does this by looking for certain characters within the first 5 characters of a line ('|', '>' and all high-bit characters). Exclude Quote allows you to exclude certain characters that would normally be considered a quote character. For example, if you do not want the beta symbol to cause a line to be highlighted as a quote add á (ALT-225) to this field. Include Quote allows you to include certain characters that would normally not be considered a quote character. For example, add } in this field if you want a line such as "JS} Text" to be considered a quote. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- PROGRAMMING USER-DEFINED POPUP MENUS ------------------------------------ Popup menus are available in many places by pressing the (/) key. Menus are available from the BBS List Window, Choose Conference/Area Window, Read Message Screen and Read Replies Screen. These menus are fully customizable by editing the following files: #BBS.MNU - BBS List Window Menu #AREAS.MNU - Choose Conference/Area Window Menu #READ.MNU - Read Message Screen Menu #REPLY.MNU - Read Replies Screen Menu Comments begin with two slashes (//). Comments are ignored, but should be kept to a minimum since they are parsed-out each time the menu is called. Below is an example of a full line comment: // // #BBS.MNU // //-------------------------------------------------------------------- The first two non-comment lines contain the coordinates of the upper left-hand corner of the menu, with the column first then the row. For example: 2 // Left coordinate (column) 4 // Top coordinate (row) The above tells SPEED to put the left-hand corner of the BBS Window Menu on row 4 column 2. The coordinates are relative to a 80 column by 25 row screen where column 1, row 1 is the upper-left corner of the screen and column 80, row 25 is the lower-right corner of the screen. SPEED automatically adjusts the window for screen length in excess of 25 rows. The next row contains the menu's description that will appear on the first row of the window above the selection list. For example: CHOOSE BBS // Menu description The remainder of the lines define the selections that are displayed in the picklist and what action is performed when the item is selected. The tilde (~) defines the highlighted hot-key that instantly selects and executes the option. ~Folders F // Option description The most common type of action is the the return() command. This command returns the scan code of the key SPEED expects to execute the desired command. Note this may or may not differ from the hot-key defined above with the tilde. Use the program KEY.EXE to determine the scancode. In this example 70 is the scan code for upper case F, the the key you need to press to execute the folder menu. return(70) // Return value for (F) In addition to return, two other actions are available, system() and menu(). They are described below with examples. ~View mode [DOS] // Option description system("SR /v") // Execute SPEED in View Mode The system() command executes a DOS command as if it were typed from a DOS prompt. The DOS command must be in "quotes". It is not necessary to preface batch files and internal DOS commands with "COMMAND /c". SPEED does this automatically for you. m~Ore ... // Option description menu("#bbs2.mnu") // Display #BBS2.MNU menu file The menu command executes a child menu. The child menu is a another text file using the same format as described here. You can call as many child menus as memory allows. All menu text files should terminate with the [END] statement as such: [END] To edit a displayed menu press (ALT-E). SPEED load the menu source into your text editor for editing, then will display the changed menu upon exiting your editor. TIP: User defined menus can be called anywhere a DOS program is executed. Such as the Editor:, Tagline Mgr:, External Viewer:, etc. To do this put the menu("#name.mnu") command in the program's field, where "#name.mnu" is the name of the desired menu. For example, if you routinely use more than one editor, create a user defined menu in a text file called #EDITOR.MNU and change your editor command to 'menu("#editor.mnu")'. This will popup the editor menu and allow you to select a specific editor each time before the program is loaded. The same can be done with a tagline manager, etc. Note the %s command line option is not passed to the user defined menus, thus you must explicitly refer to any file usually passed in the %s variable, such as "SE $REPLY.SR", etc. SPEED MENU ---------- The user defined menus are an extremely powerful feature. In addition to the obvious uses within SPEED, they can also be used to build a simple menu program, appropriately called SPEED MENU. To execute SPEED MENU, build the main menu in a text file called #MENU.MNU and start SPEED with the /#menu command line option. The main menu will be displayed for you to make a selection or to edit via (ALT-E).