| TelixFonEd (TFE) v2.21 |
| |
| A full-screen editor for Telix FON files. |
| |
| Copyright (c) 1988-1991 by Paul Roub |
| All Rights Reserved |
| |
| Documentation printed April 29, 1991 |







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.21 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 direc-
tories 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 anoth-
er.
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.21 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
Messages to Paul Roub in the FidoNet or RelayNet TELIX echoes
E-mail to Paul Roub on:
Floridays Deluxe (305-271-4159)
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 3 1/2 years so amazing.


TFE 2.21 was compiled by Zortech C++ v2.06 and Borland TASM v2.01; and
written using Brief, an 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.21 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_221.ARC), with its full name intact. If you downloaded
TFE from Compuserve, please rename TFE221.ARC to TFE_221.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_221.LZH or TFE_221.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

If you're not sure whether you have the latest version of TFE, the
following systems are always kept up to date:

Floridays Deluxe 305-235-4159
Ramblin' Roots (1:135/54) 305-221-1571
Aware Earth BBS 305-558-2170
MACC BBS 305-596-1854
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.21 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.21 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] [-c] [filename[.ext]]

?, -h Displays a brief summary of TFE usage.

-v Sets TFE's screen-write mode to , where 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 configura-
tion file should be sufficient.




TFE Documentation page 5







TFE (TelixFonEd) v2.21 Startup and Configuration

-c Sets the name for the Telix configuration file to
. 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.21. 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.21 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.21 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.15) have
a method of accessing the current FON file's name, or of manipulating
dialing marks.

















TFE Documentation page 8







TFE (TelixFonEd) v2.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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.21 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