Hall of Fame

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

/ Hall of Fame / HallofFameCDROM.cdr / comm1 / tfe220.lzh / TFE.DOC < prev next >

Wrap

Text File | 1990-07-22 | 56KB | 1,444 lines

| TelixFonEd (TFE) v2.20 | | | | A full-screen editor for Telix FON files. | | | | Copyright (c) 1988-1990 by Paul Roub | | All Rights Reserved | | | | Documentation printed July 22, 1990 | Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Why Do I Need TFE? . . . . . . . . . . . . . . . . . . . . . . 1 Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 WARNING! . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Startup and Configuration . . . . . . . . . . . . . . . . . . . . . 5 HINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Movement and Editing Keys . . . . . . . . . . . . . . . . . . . . . 9 Function, Alt- and Ctrl-Keys . . . . . . . . . . . . . . . . . . . 11 Detailed Descriptions of Function Keys . . . . . . . . . . . . 12 F1 (Menu) . . . . . . . . . . . . . . . . . . . . . . . . 12 F2 (Edit TFE Data) . . . . . . . . . . . . . . . . . . . 13 F3 (Delete Duplicates) . . . . . . . . . . . . . . . . . 14 F7 (Begin or End keystroke recording) . . . . . . . . . . 15 F8 (Play back recorded keystrokes) . . . . . . . . . . . 15 Ctrl-K (Mark range) . . . . . . . . . . . . . . . . . . . 15 Ctrl-M (Mark/Unmark entry) . . . . . . . . . . . . . . . 15 Ctrl-T (Translate) . . . . . . . . . . . . . . . . . . . 16 Ctrl-U (Unmark range) . . . . . . . . . . . . . . . . . . 16 Alt-A (Add) . . . . . . . . . . . . . . . . . . . . . . . 16 Alt-B (Block Change) . . . . . . . . . . . . . . . . . . 17 Alt-C (Copy) . . . . . . . . . . . . . . . . . . . . . . 17 Alt-D (Delete) . . . . . . . . . . . . . . . . . . . . . 17 Alt-E (Export) . . . . . . . . . . . . . . . . . . . . . 17 Alt-F (Find) . . . . . . . . . . . . . . . . . . . . . . 18 Alt-H (Help) . . . . . . . . . . . . . . . . . . . . . . 18 Alt-I (Import) . . . . . . . . . . . . . . . . . . . . . 18 Alt-L (Load) . . . . . . . . . . . . . . . . . . . . . . 19 Alt-M (Move) . . . . . . . . . . . . . . . . . . . . . . 19 Alt-P (Print) . . . . . . . . . . . . . . . . . . . . . . 20 Alt-R (search-and-Replace) . . . . . . . . . . . . . . . 20 Alt-S (Sort) . . . . . . . . . . . . . . . . . . . . . . 21 Alt-W (Write) . . . . . . . . . . . . . . . . . . . . . . 21 Alt-X (eXit) . . . . . . . . . . . . . . . . . . . . . . 21 Alt-Z (Help) . . . . . . . . . . . . . . . . . . . . . . 21 Registration . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 TFE (TelixFonEd) v2.20 Introduction Introduction Why Do I Need TFE? ------------------ If you use Telix, you need TFE. Telix is the best telecommunications program around; but like most such programs, when it comes to updating, adding, deleting or any other activity involving the contents of your dialing directories, it leaves a lot to be desired. For instance, to change the password for one BBS, you have to point to that directory entry, type E, hit ENTER enough times to get past EVERY other field, and finally change the entry. Want to create a new entry that's almost identical to an existing one? Fine, just enter all the same data all over again, then hit the Toggle key enough times to make sure you got it right. If one field was wrong, prepare to abuse the ENTER key again. But there is a better way: TelixFonEd (TFE). TFE gives you easier, more complete control over the content and arrangement of your Telix version 3.0 (or higher) dialing directories (FON files). Using TFE, you can: o Translate Procomm v2.4, Procomm+, Qmodem v4, Telemate v2, GT Power v15.50, Boyan D-3, Boyan v4 and Commo v4 dialing dir- ectories into Telix format. o Manipulate entries individually, as groups of marked entries, or as highlighted ranges. o Sort any part (or all) of a dialing directory on any field, in ascending or descending order. o Insert and delete entries at random. o Copy or move data from one location in a directory to an- other. o Write part of a directory (or the entire directory) to an- other FON file. o Print selected entries (or all entries) to a file or printer. o Edit any field in the directory in a simple, intuitive full- screen format (no more ENTERing through every field in an entry just to change the password). o Pop up menus for many fields (Protocols, Terminal types, etc.) -- on request, or automatically whenever you enter invalid data. o Clean up corrupted FON files. o Merge two or more FON files, combining duplicate entries. o Store additional information about any entries in a FON file, such as "Sysop Name" or "Hours of Operation." o Change the values of an entire group of fields with one com- mand. o Search-and-Replace on any part (or all) of a field. o And more! TFE Documentation page 1 TFE (TelixFonEd) v2.20 Introduction Hopefully, this documentation will tell you all you need to know about using TFE. But if necessary, please direct further questions to me through the following means: Electronic mail: BIX: proub Compuserve: 71131,157 Fido Netmail: 1:135/47 Messages to Paul Roub in the FidoNet or RelayNet TELIX echoes Local messages to Paul Roub on: MOBS (305-895-1666) US Mail to: Paul Roub P.O. Box 141583 Coral Gables, FL 33114-1583 When reporting a bug, please be specific as to the nature of the prob- lem (i.e. what led up to it, what error message -- if any -- ensued, can you repeat it, etc.). The author makes no claims as to the suitability of this product for any application. In the event of malfunction, the author's liability shall be limited to a replacement or refund. ACKNOWLEDGEMENTS: I wish to express my gratitude to Andrew Adler, Craig Merwitzer, Dave Steinman, Ronnie Toth and Bruce Wilson for test- ing and assistance above and beyond the call of duty. Thanks also to Nick Anis and John Dvorak. Special thanks to Lloyd Burt for more than I have space to list. Particularly special thanks to Maria for making the last 2 1/2 years so amazing. TFE 2.20 was compiled by Zortech C++ v2.06 and Microsoft MASM v5.10; and written using Brief, and editor so good it's almost frightening. ----- NOTE: ----- TFE should not be confused with PFE+ (Procomm+ Fon Editor) or QFE (Qmodem Fon Editor), both of which are products of Sunflower Systems. TFE and Paul Roub are in no way affiliated with Sunflower Systems. TFE Documentation page 2 TFE (TelixFonEd) v2.20 Introduction Notes: ------ You may distribute TFE freely (in fact, I would very much appreciate your doing so), provided that you distribute only the full, unmodified archive (TFE_220.ARC), with its full name intact. If you downloaded TFE from Compuserve, please rename TFE220.ARC to TFE_220.ARC before distribution. Feel free to distribute TFE in other archive formats (such as ZIP, LHARC, ZOO, etc.) -- but again, you must retain the full name, as in TFE_220.LZH or TFE_220.ZIP. The following files must be included in the archive: ASK.COM RUNME.BAT TFE.DOC TFE.EXE TFE.REG TFE_HIST.DOC WHATIS.TFE READTHIS.NOW (Can be deleted after August 31, 1990) If you're not sure whether you have the latest version of TFE, the following systems are always kept up to date: MOBS (1:135/47) 305-895-1666 Floridays Deluxe (1:135/82) 305-235-2227 The C Workshop (1:135/1) 305-226-3310 Ramblin' Roots (1:135/54) 305-221-1571 Telix Support BBS 416-439-8293 BIX telecomm listings area Compuserve IBMCOM Forum If, after trying out TFE, you wish to continue using it, you must fill out and send in the registration form at the end of this document. You'll be supporting shareware, making possible future improved ver- sions of this and other programs; you can also get the latest version of TFE on disk. Note that TFE may NOT be used in a business or com- mercial environment without registration. For further details, see the Registration section at the end of this document. Is there something you don't like about TFE? Something you think is missing? A screw-up in the documentation, etc... let me know! We aim to please! TFE Documentation page 3 TFE (TelixFonEd) v2.20 Introduction WARNING! -------- Users of DoubleDos, DesqView and other multitasking systems: do NOT use TFE when Telix itself is running at the same time. Havoc will ensue, TRUST ME. In general, you're asking for trouble if you modify ANY file currently in use by another process. For similar reasons, when shelled to DOS from Telix, DO NOT run TFE on the same dialing directory that Telix is currently using. Various com- plaints of "TFE trashed my FON file" actually occur because Telix does not close and reopen the dialing directory before and after a DOS shell (see the "Startup and Configuration" section for a hint on getting around this problem). TFE Documentation page 4 TFE (TelixFonEd) v2.20 Startup and Configuration Startup and Configuration Telix users will feel right at home with TFE. At startup, TFE reads your Telix configuration file (TELIX.CNF) to determine which screen colors and screen write mode to use, what external protocols are avail- able, and your default modem settings (to use when adding new entries). The TFE screen should therefore look pretty much like your Telix dial- ing directory. If TELIX.CNF is not found, TFE will use the following defaults: Black-and-white colors BIOS used for screen access Modem parameters: 2400 baud, 8 data bits, 1 stop bit, No parity No external protocols TFE is quite thorough when it looks for the configuration file. If you have specified a config file name on the command line, that name is used; otherwise, TELIX.CNF is the config file name. If the filename contains a specific drive or directory name, only that particular file is searched for. If no drive or directory is given, TFE first checks the current directory. If the file is not there, TFE checks the direc- tory specified in the TELIX environment string (if any). If the file has still not been found, TFE checks each directory in the PATH envi- ronment string (consult your DOS manual for more information on envi- ronment strings and the PATH). If the file has not been located by now, TFE uses the default settings specified above. The command-line syntax of TFE is as follows (all parameters are op- tional): TFE [?] [-h] [-v<n>] [-c<name>] [filename[.ext]] ?, -h Displays a brief summary of TFE usage. -v<n> Sets TFE's screen-write mode to <n>, where <n> means: 1 - Direct video access, with no snow-checking. This should be used when you have a monochrome display or a color display which does not have a snow problem. 2 - Direct video memory access, with snow-checking. This should be used with older Color Graphics Adaptors which tend to produce video snow. 3 - BIOS screen access. To be used if you need to run TFE on a system where the other two modes don't work. In general, you shouldn't need to use this parameter, since the video mode specified in your Telix config- uration file should be sufficient. TFE Documentation page 5 TFE (TelixFonEd) v2.20 Startup and Configuration -c<name> Sets the name for the Telix configuration file to <name>. This shouldn't normally be necessary either -- TFE will usually find the file on its own, as explained later. filename[.ext] The name of the file you wish to edit. More on this below. If you don't include an extension in the name of the file for TFE to edit, TFE assumes the extension '.FON'. That is, 'TFE telix' is equiv- alent to 'TFE telix.fon'. If you wish to edit a file which has a blank extension, use a period at the end of the filename, as in 'fred.' If no filename is specified, TFE assumes '*.fon', so entering TFE with no filename will default to all .FON files in the current directory; if no FON files are found in the current directory, TFE defaults to all FON files in the TELIX directory, if any. If more than one file matches the name you specified, TFE will present a menu of all matching files. If you want to edit one of these, simply highlight it (using the move- ment keys described below) and hit the ENTER key. If you don't wish to edit any of these files, hit ESC and you will have a chance to enter a new filename; a menu will again be shown if necessary. If you hit ESC from either the filename prompt or the menu that follows, TFE will end and exit back to DOS. Once you have picked a file, TFE will proceed to read that file. If it encounters any invalid fields, it replaces them with the default values for those fields. After the file is read, TFE displays a message in- forming you how many fields (if any) were "fixed". NOTE: If you've just converted from TFE v1.00, 1.01 or 1.10, you may get a lot of 'cleaned up entries' messages the first time you load an old FON file into TFE v2.20. This is because TFE versions 1.10 and lower paid no attention to Telix's "Last Call" field, so some of them may contain garbage if they've never been updated by Telix. This is nothing to worry about, and once you have written the file to disk, all the dates will be cleaned up. NOTE: As used in this document, 'entry' refers to all of the FON file information for one system; e.g. the Name, Number, Password, etc. for one BBS. 'Field' refers to one part of an entry, such as the Name field or Script field. At this point, you'll be presented with the main TFE screen, which has several sections. At the top is TFE's copyright information, followed by a line containing the full name of the FON file currently being edited. The next (and most important) section is the editing section. This is where the contents of your FON files are actually displayed and edited. At the top of this box are the names of the fields currently visible on TFE Documentation page 6 TFE (TelixFonEd) v2.20 Startup and Configuration the screen. Down the left-hand side you'll see the numbers of the entries currently visible. Most of the box is in the Menu Foreground and Background colors specified in your Telix configuration file. However, the field which you are currently editing will be in Telix's Menu Select and Menu Bar colors. You can move this highlight bar around by using the cursor keys and other movement keys described later. At the right side of the next line is the Insert/Overstrike indicator. This lets you know whether TFE is in Insert mode (new characters 'push' old characters to the right) or Overstrike mode (new characters replace old characters). Although you won't see it at first, the left side of this line will inform you when a keystroke macro is being recorded or played back (see the "Function and Alt-Keys" section of this document, keys F7 and F8). Below this line is a message box, where TFE will display various mes- sages, such as descriptions of fields being edited. The last section is a brief listing of available function, Ctrl- and Alt-keys. For more details, enter Alt-H, or consult the "Function, Alt- and Ctrl-Keys" section of this document. TFE Documentation page 7 TFE (TelixFonEd) v2.20 Startup and Configuration HINT: ----- As mentioned earlier, TFE should not be used on Telix's current FON file when shelled-to-DOS from Telix. Telix will not realize that the file has been modified, and things will get very confused (and poten- tially dangerous). However, you CAN shell from Telix to edit ANOTHER file. To facilitate easy TFE use, I use a short SALT script which loads a dummy FON file into Telix (forcing the old file to be written to disk and closed), calls TFE to edit TELIX.FON, then reloads TELIX.FON into Telix. I recommend assigning this script to the Alt-E (for Edit) key in Telix (after all, how often do you really need to Toggle Local Echo?); of course, you can assign it to any function key you wish. To accomplish, create the following script file: main() { loadfon("zzz.fon"); // load a dummy run("tfe", "telix", 0); // work on the real thing loadfon("telix.fon"); // load the real thing again } Save this script as TFE.SLT, and compile it using the command 'CS tfe'. Then, from Telix's Keyboard Macro menu, assign the string @TFE to the Alt-E key (consult your Telix manual for explanations of key reassign- ment). Using Telix or TFE, create an empty FON file named ZZZ.FON. Now whenever you enter Alt-E in Telix, you can safely edit TELIX.FON. Note, however, that any entries which were marked for dialing will be unmarked when you return to Telix. If you use more than one dialing directory, you'll need to expand on this idea a bit. These problems are due to the fact that SALT does not (as of Telix version 3.12) have a method of accessing the current FON file's name, or of manipulating dialing marks. TFE Documentation page 8 TFE (TelixFonEd) v2.20 Movement and Editing Keys Movement and Editing Keys Using the various movement keys, you can move through the dialing directory fields in a manner very similar to using a spreadsheet or word processor. If you move up or down past the end of the currently visible entries, the screen will scroll up or down as necessary. Sim- ilarly, moving right or left past the edge of the screen will let you edit fields beyond those currently shown on screen. At any time you can edit the data in the current field using the editing keys. Most of these keys are also available when entering file names, search strings, etc. By playing with the movement and editing keys a bit, you should get a feel for their functions quickly. The following movement and editing keys are used: Hyphenated notations mean to hold down the first key and hit the second. Shift-Tab, for example, means to hold down either Shift key and press Tab. Left: Move left one character within the current field. If at the beginning of the field, move to the previous field. Right: Move right one character within the current field. If at the end of the field, move to the next field. Up: Move to the previous entry, if any. Down: Move to the next entry, if any. Tab: Move to the next field. Shift-Tab: Move to the previous field. Home: Move to the beginning of the current field. End: Move to the end of the current field. Control-Left: Move to the first field of the current entry. Control-Right: Move to the last field of the current entry. Control-PgUp: Move to the first entry in the directory. Control-PgDn: Move to the last entry in the directory. PgUp: Move one page up the entry list. PgDn: Move one page down the entry list. Del: Delete the current character in the current field. Ins: Toggle insert mode. When insert mode is TRUE, entering a character pushes all following characters in the same field to the right. The Insert/Overstrike indicator will inform you which mode you are in. Backspace: Delete the previous character in the current field. Ctrl-End: Erase all characters from the cursor to the end of the current field. F1: Pop-up a menu of allowable values for this field. Pick one by pointing to it and hitting ENTER, or ESC to can- cel the operation. Menus are not available for all fields. ESC: Undo any editing done to the current field. ENTER: Accept the current edited value for the current field. TFE Documentation page 9 TFE (TelixFonEd) v2.20 Movement and Editing Keys When you leave a field (by hitting ENTER, selecting a menu option, or moving to another field or entry), TFE checks the validity of the field whenever possible. Although a few fields have no restrictions as to what kind of data they may contain (e.g. BBS Name or Password), most have a specific range of acceptable values. If the value entered into a field is 'illegal' (such as a letter in the 'Times Called' field), one of two things will happen. If available, a menu of valid options will pop up, as explained earlier; just pick one of these. Otherwise, TFE will display a message informing you that the value you have en- tered is invalid. You must then re-enter an acceptable value. TFE Documentation page 10 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Function, Alt- and Ctrl-Keys In addition to the editing and movement keys, several 'function' keys are defined. Some are called 'Alt-keys', because they are used by hitting a letter key while holding down the 'Alt' key; some are 'Ctrl-keys'; others use the PC's function keys. All of TFE's functions are accessed through these keys. Here is a quick list of the keys; a detailed explanation of each key's function starts on the following page. F1: Menu for current field (if available). F2: Edit "TFE Data" for this entry. F3: Merge duplicate entries. F7: Begin or end recording of keystrokes (macro). F8: Playback recorded keystrokes (macro). Ctrl-M: Mark or Unmark the current entry. Ctrl-K: Mark a range of entries (or all entries). Ctrl-T: Translate Procomm v2.4, Procomm+, Qmodem v4, Telemate v2, GT-Power v15.50, Boyan D-3, Boyan v4 and Commo v4 dialing directories to Telix format. Ctrl-U: Unmark a range of entries (or all entries). Alt-A: Add a specified number of entries. Alt-B: Change the value of an entire group of fields. Alt-C: Copy a range of entries. Alt-D: Delete a range of entries. Alt-E: Export a range of entries to another FON file. Alt-F: Find the next entry whose name contains a given string. Alt-H: Display a brief description of all function keys. Alt-I: Import another FON file into the current directory. Alt-L: Load a new FON file. Alt-M: Move a range of entries to another part of the direc- tory. Alt-P: Print part (or all) of the current directory. Alt-R: Search-and-Replace in the current field. Alt-S: Sort all or part of the current directory by any field. Alt-W: Write the current FON file to disk. Alt-X: eXit TFE. Alt-Z: Same as Alt-H. Several of the commands will ask you to indicate a range or a line. When indicating a range, you will use the Up, Down, Home, End, PgUp and PgDn keys to highlight a range of entries beginning or ending with the current line. The range can extend above or below the current line. Indicating a line is similar -- just move the highlight bar to the row you wish to indicate and press ENTER. Pressing ESC when indicating a range or line will cancel the current command (except where otherwise noted). TFE Documentation page 11 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Detailed Descriptions of Function Keys F1 (Menu): Menus are available for the following fields: Baud, Parity, Data, Stop, Script, Terminal, Protocol, Local Echo, Add Line Feeds, BS Translate, BS Sends DEL, Strip High Bits, and Prefix. If you enter invalid data in any of these fields, you will see these menus automatically. However, whenever you are editing one of these fields, you can hit the F1 key to see the appropriate menu. You may now select an item from the menu, and the proper data will be inserted into the field for you. You can select an item by pointing to it and hitting enter, or by hitting the letter or digit which is highlighted in that item's name. Note that the highlighted letters are the same as those used by Telix, even for external file-transfer protocols. If you hit ESC instead, you will return to the field you were editing without changing any- thing. NOTE: The menu for the Script field is a special case - it won't show up in the event of an invalid entry, since TFE doesn't vali- date script fields. In fact, it may not be available at all; the menu is a list of all .SLC files found in your script directory -- if no files are found, no menu is displayed. TFE Documentation page 12 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys F2 (Edit TFE Data): A number of people have complained that Telix's dialing directory does not let them store information on a system's Sysop Name, Hours of Operation, or whatever extra information they might want to keep track of. TFE has the ability to manipulate these extra details, through something called "TFE Data." When you're editing an entry, hitting F2 will pop up a window containing the TFE Data for that entry. You can enter a Sysop Name, Hours of Operation, and up to three lines of random data (whatever you wish). You can even use TFE Data as the sort field when Sorting your directory (see below)! Naturally, when you Read, Write, Import or Export FON file data, the TFE Data comes along. TFE Data is stored in the same directory as its corresponding FON file, in a file with the same name but the extension TFE. Telix, of course, is com- pletely unaware of TFE Data. NOTE: Since each TFE Data item is stored according to the NUMBER of the FON entry it is related to, if you insert or delete entries from the FON file using Telix, TFE will become confused (when it tries to edit the FON file later) about which TFE Data relates to which entries. While this is not dangerous in any way, you WILL end up with the Sysop, etc., matched with the wrong systems. So if you are going to use TFE Data, you must perform ALL additions and deletions from within TFE, not Telix, apart from simply adding entries to the end of the file. There is no way around this, but I think it's worth the small sacrifice to have the extra informa- tion on hand. TFE Documentation page 13 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys F3 (Delete Duplicates): One thing I use TFE for is combining various FON files. For in- stance, when a new version of MIAMIBBS.LST (a local BBS listing) comes out, I run it through a utility which converts it to a FON file. Then, using TFE, I Import the result into TELIX.FON. Since many of the new entries are already in my directory, I now have a number of duplicates. To solve this problem, I use the Delete Duplicates function; this sorts the directory by Name and Phone Number (to make looking for duplicates easier). It then looks for any entries with the same Name and Phone Number. Having found a duplicate, TFE combines the two in the following manner: The highest Last Call date of the two is used. If both Last Call dates are identical, the first entry is considered to be the most recent. The Total Calls fields of the two are added together. If only one entry has TFE Data, that data is used. Other- wise, the TFE Data from the two are merged: if only one entry contains a given field, that field is used; if both contain it, the field from the most recent entry (as judged by the Last Call date) is used. The Script and Password fields are handled similarly. The highest baud rate of the two entries is used. To use this function, press the F3 key. Now indicate the range in which you wish to Delete Duplicates (ESC will cancel the opera- tion). At this point, TFE will ask you to confirm that you want to delete all duplicate entries. Hitting 'n' or ESC will cancel the operation. When the function is complete, TFE will report the number of duplicates deleted. TFE Documentation page 14 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys F7 (Begin or End keystroke recording): You may often need to perform the same task repeatedly. It can get rather boring typing in the exact same keystrokes again and again. For instance, to change a group of Phone Numbers to long distance, for EACH field you'd have to enter '1-', then move to the next field. No big deal, but if you had to do this to 100 numbers in a row it could get quite tedious. If you record '1-' and DOWN as a macro (a group of recorded keystrokes), however, you'd simply need to play back the macro the appropriate number of times. This is a trivial example, but you can actually record much more intricate macros (up to 1000 keystrokes long), and play them back with one key! Note that ANY keystrokes you would use in TFE (menu selections, reading in files, popping and removing the help screen, whatever) can be recorded in this way. The only keys you CAN'T record are F7 and F8. To begin recording a macro, hit the F7 key. The word "Recording" will appear near the bottom of the screen. Enter the keystrokes you wish to record, then hit F7 again -- the "Recording" notice will go away. To play back these keystrokes, hit F8 (see below). Note that when you record a new macro, the old one is replaced. Also, macros are NOT saved between TFE sessions, so your macro will be lost the next time you run TFE. F8 (Play back recorded keystrokes): F8 plays back keystrokes recorded as macros (see F7 above). If no macro has been recorded, nothing will happen. Otherwise, the words "Playing Back" will appear near the bottom of the screen, and all of the recorded keystrokes will be executed just as if you were typing them. When playback is finished, the "Playing Back" message will disappear. Ctrl-K (Mark range): Ctrl-K allows you to mark a range of entries, or all entries (see Ctrl-M, below). Highlight the range you wish to mark, and press enter; or press ESC to mark the entire dialing directory. Ctrl-M (Mark/Unmark entry): Ctrl-M toggles the current entry between Marked and Unmarked stat- us. Marked entries can be used by the Block Change, Copy, Delete, Export, Move and Print commands to act on a group of entries which can't all be highlighted as one range. If an entry is Marked, an asterisk ('*') will appear to the far left of that entry on screen. Ctrl-M causes Unmarked entries to become Marked, and vice-versa. To Mark or Unmark more than one entry at a time, use the Ctrl-K (Mark range) and Ctrl-U (Unmark range) commands. NOTE: This command should NOT be confused with marking entries for dialing in Telix. TFE Documentation page 15 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Ctrl-T (Translate): Ctrl-T allows you to translate dialing directories from other programs (specifically, Procomm v2.4, Procomm+, Qmodem v4, Tele- mate v2, GT Power v15.50, Boyan D-3, Boyan v4 and Commo v4) into Telix FON files. If the current FON file has not been saved, you will be given an opportunity to Write the current file, go ahead anyway or abort the Translate command. Afterwards, specify the name (or wildcard mask) of the file you wish to translate. A menu of all files matching this mask will be presented. Point at the file you choose and press ENTER, or press ESC to abort the com- mand. You will then see a list of possible dialing directory formats to convert from. Pick the appropriate one, or press ESC to abort. Now, specify the name (or mask) of the Telix FON file you want to translate TO. Again, a menu will be presented and you can ESC if you wish. Finally, the translation will occur, and the translated entries will be loaded into TFE for editing -- the new directory will not be written to disk unless you do so explicitly with the Alt-W (Write) command. NOTE: In cases where a field from another directory format does not exist in Telix, it is discarded. If a Telix field is not present in the foreign directory, the default value is used (de- fault are also used when the value of a field has no exact Telix equivalent). If dates in the foreign directory are not in the same format as that specified in your Telix configuration, they will be converted to the correct format. Ctrl-U (Unmark range): Ctrl-U allows you to Unmark a range of entries, or all entries (see Ctrl-M, below). Highlight the range you wish to Unmark, and press enter; or press ESC to Unmark the entire dialing directory. Alt-A (Add): Use the Add command to add new entries at any position in the FON directory. After hitting Alt-A, move the highlight bar to the position where you wish to add the new entries; then hit ENTER. TFE will prompt you for the number of entries to insert. All entries added will use the default field values specified in your TELIX.CNF file. Note that this is different from Telix's Add command in that the new entries can be added at any position rather than always at the end of the directory. TFE Documentation page 16 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Alt-B (Block Change): Block Change is useful when you want to change the same field to the same value in more than one entry. For example, if you had just gotten a 2400 baud modem, you could change all the "Baud" fields from 1200 to 2400 at once. Just move to the column you want to modify; highlight the range of entries in which you wish to change the field values (if any entries are marked, those en- tries will be changed, and you will not be asked to highlight a range); press ENTER; and enter the value you wish to change these fields to. Note that the F1 menus (if available) will work, and the usual validity checks apply. This command is also useful when cleaning up directories created by some conversion utilities, which occasionally insert random data in some fields. For in- stance, you can quickly set all Parity fields to N, Stop Bits to 1, etc. Alt-C (Copy): The Copy command lets you duplicate a group of entries and insert the new range anywhere in the FON directory. This is useful when you want to add new entries which are similar to existing entries. If any entries are marked, those entries will be copied; otherwise highlight the range you wish to copy and press ENTER. Next, point to the position you want to copy the entries to. The duplicate lines will be inserted at the specified position, and all entries past this position will be "moved down" to make room. Alt-D (Delete): The Delete command allows you to remove a range of lines, or a group of marked lines, from the FON directory. If entries are marked, they will be deleted -- otherwise highlight the entries you wish to delete. Press ENTER to delete the entries, or ESC to abort. Alt-E (Export): The Export command writes a specified range of entries, or a group of marked entries, to a file. If any entries are marked, they will be Exported; otherwise highlight the range you wish to write to a new FON file, then hit ENTER. You will be prompted to enter a filename; if you leave out the extension, .FON will be added for you. If the new file does not exist, it will be created. If the specified output file already exists, you have the option of either overwriting it or adding the new entries to the end of the old file. The entries in the current directory will be left un- changed. TFE Documentation page 17 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Alt-F (Find): Use the Find command when you want to 'jump' to a specific entry without scrolling around looking for it. You will be asked to enter a string. The highlight bar will search all entries FOLLOW- ING the current one, and move to the first entry containing the string in one of its fields; case is not significant. For exam- ple, if you entered 'foo', possible matches would be 'foo', 'FOObar', 'egg foo yong', etc. All fields (including TFE data fields) are searched for the string; if a match is found, the cursor is moved to the appropriate field. If you want to see ALL occurrences of a given string in the directory, you would move to the top of the directory; using Alt-F once would find the FIRST occurrence; using it again would find the second, and so on. Alt-H (Help): Alt-H brings up TFE's context-sensitive help system, with abbrevi- ated versions of the function descriptions from this manual. If you are in the middle of some operation (Sorting, Translation, Loading or Writing a file, etc.), the help for that function will be displayed. Otherwise, an Index of available help will be shown. At any time while in the help system, hitting any Function, Alt- or Ctrl-key will display the help for that key's function. Alt-H will always bring you back to the Help Index. When the help for a function extends above or below the text currently on screen, a message in the lower right corner of the screen will tell you which keys can be used to see the extra text. Pressing the ESC key returns you to TFE. Alt-Z will also bring up the help system, for compatibility with Telix's Help key. Alt-I (Import): The Import command reads in the entries from a specified FON file and inserts them at a specified position in the directory you're editing. After you hit Alt-I, point to the position where you want the Imported data to go. Then enter a FON filename when prompted, and the entries from the specified file will be inserted. If you enter a filename with wildcards (* or ?), you will need to choose from a menu of matching files. You can use this command in combination with the Delete Duplicates (F3) com- mand to merge two FON files into one. TFE Documentation page 18 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Alt-L (Load): The Load command replaces the currently edited FON directory with one read from a specified file, just as if you had exited TFE and run it again with a different FON file name on the command line. Just enter the filename when prompted. If you enter a filename with wildcards (* or ?), you'll need to pick a matching file from a menu. If the current directory has been modified (by Inserting, Deleting, Copying, Moving, editing, etc.) since the last Load or Write command, you will be asked to confirm whether you want to clear the current directory without saving it to disk, and given the option to Write it to disk first. Alt-M (Move): The Move command lets you move a range of entries, or a group of marked entries, to another part of the directory. It is similar to the Copy command, except that the original lines are deleted. If any entries are marked, they will be moved; otherwise highlight the desired range and press ENTER. Finally, indicate the position to which you wish to move the entries. TFE Documentation page 19 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Alt-P (Print): The Print command prints a range of entries (or a group of marked entries) to the printer (or a file) as a formatted, paginated list (similar to that created by Telix's Print command). If any en- tries are marked, they will be printed; otherwise highlight the range you want to print, or hit ESC to print the entire directory (note that this is one of the few times that ESC won't cancel a command; don't worry, you'll get more chances when you're entering the filename and fields). TFE will present you with a menu of fields, including TFE data fields. Select the fields you wish to print -- the default is those fields currently visible on the editing screen. To select or deselect a field, point to it and press ENTER (a '*' next to a field indicates that it is currently selected for printing). You may ESC at any time to abort the Print command. When you have selected the fields you want printed, hit F10. At this point, enter the file or printer name to print to (or just hit ENTER to print to PRN, the default print- er). The entries and fields you have indicated will be printed. Alt-R (search-and-Replace): The replace command allows you to search the current field for a given string of characters, and replace that string wherever it is found. All entries are checked. For instance, if you had just moved into area code 305, you might want to change all numbers in that area code to local numbers (assuming that they previously had been listed as '1-305-...'). You would move to the Number field and hit Alt-R. TFE would ask you what string to Replace, and you would respond '1-305-'. TFE would then ask what to replace '1- 305-' WITH, and in this case you would enter a blank string, since you only want to replace the string with "nothing". At each entry where a number containing '1-305-' was found, TFE would show you the field and ask if you wish to change it. Your answer can be one of four things: Y (yes) to change the field; N (no) to leave the field alone, but look for more; A (all) to tell TFE to change ALL future matches and stop asking for your permission; or Q (quit) to stop looking for strings to replace. TFE Documentation page 20 TFE (TelixFonEd) v2.20 Function, Alt- and Ctrl-Keys Alt-S (Sort): The Sort command sorts all or part of the current FON directory by any field. TFE first prompts you to highlight the range you wish to Sort. Like the Print command, hitting ESC at this point will quickly mark the entire directory for sorting. You will now be asked which field you wish to Sort by; you may hit ESC at this point to abort sorting. Finally, specify whether you wish to Sort in Ascending or Descending order; again, ESC will cancel. There are two sort keys whose behaviors merit description: Sorting by name: Case is not significant when sorting. Leading spaces are ignored, so "That BBS" and " That BBS" are treated as the same name. Also, if the first word in a name is "the," it will be ignored, so "BBS" and "The BBS" will also compare the same. Also, blank names go to the END of the list, not the beginning. Sorting by phone number: When two numbers are of different lengths, the shortest one will come first when sorted. This will generally put local numbers before long-distance numbers. Numbers with the same length will be sorted by a string comparison. Alt-W (Write): The Write command writes the current directory as a FON file. You will be prompted for the name of the file to write to (the default is the same name it was originally read from). As always, if you omit the file extension, .FON will be appended for you. The cur- rent directory is not disturbed. Alt-X (eXit): The eXit command quits TFE and exits to DOS. If the current file has been changed since the last Read or Write command, you will be asked to confirm your intention, and given the option to Write the file to disk first. Otherwise, TFE will exit without further incident. Alt-Z (Help): See Alt-H. TFE Documentation page 21 TFE (TelixFonEd) v2.20 Registration Registration NOTE: TFE may NOT be used in a business or commercial envi- ronment without registration. TelixFonEd is distributed as shareware. The advantage of this is that you get to try out the full, working program and see whether or not it suits your needs. If you find TFE useful, you must register the pro- gram. Just to prod your good will along, registration has a few perks: you will receive the latest version of TelixFonEd on disk, along with inexpensive on-disk updates to future versions. Comments, suggestions, and requests from registered users will of course have a higher prior- ity. Without registrations, there will soon cease to BE future ver- sions of TFE, simply because I've got to make a living, and I have no choice but to devote the bulk of my time to projects that will help me pay my bills. To register TFE, just fill out the registration form below; be sure to include your check or money order (in US Dollars), and mail it to the address below. The price of registration is ten dollars, including shipping, handling, and the cost of a floppy disk (5 1/4", MS-DOS DS/DD, with the latest version of TFE). Registered users of previous TFE versions can upgrade to the latest version for five dollars. Of course, once you've registered one version of TFE, you've registered all future versions as well -- so you can simply download the latest version from a BBS. I provide the upgrade service for those who can't find the latest version elsewhere. For a special price of only $15, you can register both TFE and SLEARN (the SALT learn utility), receiving both on disk, along with a collec- tion of Telix scripts, tips and utilities. Thank you for registering TFE. The registration form follows. TFE Documentation page 22 TFE (TelixFonEd) v2.20 Registration Please send this form, along with your check or money order for the appropriate amount of US dollars, to: Paul Roub P.O. Box 141583 Coral Gables, FL 33114-1583 I would like to register TFE in the following manner (check one): __ Regular registration (with the latest version on disk) $10.00 __ Previously registered user, upgrading to the latest version $ 5.00 __ Register TFE and SLEARN, plus bonus scripts and utilities $15.00 Name: ___________________________________________________ Company: ___________________________________________________ Street Address: ___________________________________________________ City, ST: ___________________________________________________ Zip: _____________ Home phone number (optional): (_____)-______________ Work phone number (optional): (_____)-______________ BIX, CIS or Netmail addresses (optional): _____________________________ Where did you find TFE? ______________________________________________ Comments and/or Suggestions: _________________________________________ _______________________________________________________________________ _______________________________________________________________________ _______________________________________________________________________ _______________________________________________________________________ TFE Documentation page 23