                           - 1 -
Thu 30-January-1992

About TSFLTB in General                         All rights reserved
=======================

TSFLTB first release (1.0) was distributed under the name of TS2FLT.

This package may be used and distributed freely for NON-COMMERCIAL,
NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in
any way. (Repacking with another method is ok, though.) For ANY
other usage, such as use in a business enterprise or a university,
contact the author for registration. Uploading to bulletin boards is
encouraged. Please do not distribute any part of this package
separately.

The programs are under development. Comments and contacts are
solicited. If you have any questions, please do not hesitate to use
electronic mail for communication.
InterNet address: ts@chyde.uwasa.fi         (preferred)
Bitnet address:   SALMI@FINFUN.BITNET
Funet address:    GADO::SALMI

The author shall not be liable to the user for any direct, indirect
or consequential loss arising from the use of, or inability to use,
any program or file howsoever caused. No warranty is given that the
programs will work under all circumstances.

Timo Salmi
Professor of Accounting and Business Finance
School of Business Studies, University of Vaasa
P.O. BOX 297, SF-65101 Vaasa, Finland


Timo Salmi FiLTers set B, release 1.5 includes the following
*    *     * **        *          * *
utility-type programs and files:

TSFLTB15        Build your own filters, T.Salmi
Filename        Comment
--------        --------------------------------
DEMOTXT.XLT     How to build a translation table
FILBIN.EXE      General filter for binary files
FILGEN.EXE      Generalized filter for any file
FILTXT.EXE      General filter for text files
LOWER.XLT       To lowercase, also foreign chars
NOEOF.XLT       Enables reading text past eof
PC2UNIX.XLT     PC newlines to Unix newlines
SIMUL8.XLT      8-bit to look-alike 7-bit chars
STRIP.XLT       Strip the high bit of 8bit chars
TOASC.XLT       Scandinavian IBM to ASCII
TOIBM.XLT       Scandinavian ASCII to IBM
TSFLTB.INF      Document
TSFLTB.NWS      News announcements about tsfltb
TSPROG.INF      List of programs from T.Salmi
UNIX2PC.XLT     Unix newlines to PC newlines
UPPER.XLT       To uppercase, also foreign chars
VAASA.INF       Info: Finland, Vaasa, U of Vaasa
----            ------             ------  -----
0017


                           - 2 -

DETAB (Expand tabs properly into blanks) that was in TSFLTB in the
versions before tsfltb13.arc has been transferred to the TSFLTC
package because it is not a customizable filter as the current
filters of this package.


FILBIN (Ver. 1.3)  General user-configurable filter for binary files
=================

Usage: FILBIN SourceFile DestinationFile [translation table]
 [/k(eep date)] [/m(ore)] [/p(ause)] [/s(how translation table)]

FILBIN is a configurable string translation facility for binary
files. The translations are given in a separate translation table
file, which you can customize. See demotxt.xlt for the format of the
translation table. If you omit the name of the translation table, it
defaults to filbin.xlt

E.g. translation
  13
  10
means converting the carriage return of the source binary-file into
line feeds. The maximum number of different translations is 256.

The /m /p and /s parameters in the brackets [] are optional. If you
are working with a single disk drive, /p allows to change the disk
by pausing after your have loaded FILBIN and the translation table.
If you direct the output to the screen (that is to CON), the /m
option causes pause at the end of each screen. Parameter /s shows
you the translation table. If you select /s, the translation is not
made, only the table is shown.

Release notes: Version 1.2:
1) Translations such as
  10
  13 10
are now allowed. That is, a character can be converted into a string
even if the source file is a binary file.
2) Deleting characters is also possible in the updated version. In
other words you can have, for example,
  26
  -1
to delete the eof characters.
3) The translation table separators (blank, comma, nul) now also
include tab.  4) Introduced two translation tables (.xlt files) for
PC <--> Unix conversions.


FILTXT (Ver. 1.4)  General user-configurable filter for text files
=================

Usage: FILTXT SourceFile DestinationFile [translation table]
 [/k(eep date)] [/m(ore)] [/n(o crt)] [/p(ause)]
 [/s(how translation table)]

FILTXT is a configurable string translation facility for text files.
The translations are given in a separate translation table file,
which you can customize. See demotxt.xlt for the format of the
translation table. If you omit the name of the translation table, it
defaults to filtxt.xlt

The maximum number of different translations is 512. The maximum
number of characters in a translation string is 25. E.g. the
translation
   9
  32 32 32 32 32 32 32 32
means converting the tabs of the source text-file into eight blanks.

The /m /n /p and /s parameters in the brackets [] are optional. If
you are working with a single disk drive, /p allows to change the
disk by pausing after your have loaded FILTXT and the translation
table. If you direct the output to the screen (that is to CON), the
/m option causes pause at the end of each screen. Parameter /s shows
you the translation table. If you select /s, the translation is not
made, only the table is shown. For the /n switch see the description
of DETAB is the TSFLTC package.

Release notes: Version 1.2: The essential upgrade in tsfltb12 occurs
in filbin.exe. The other program has been recompiled with smaller
maximum heap size and some minor changes.

Release 1.3: DETAB.EXE has been transferred to the TSFLTC package.


FILGEN (Ver. 1.0)  General user-configurable filter
=================

Was added in the version TSFLTB14.ARC of this package.

Usage: FILGEN [TranslationTableFile] [/s] < InputFileName > OutputFileName
               ³                       ³
               ³                       ÀÄ show translations
               ÀÄ default FILGEN.XLT, see DEMOTXT.XLT for the format

or TYPE InputFileName | FILGEN [TranslationTableFile] > OutputFileName

FILGEN is a general, configurable string substitution facility for
both text and binary files.

E.g. the following translation in the translation table file
  10
  13 10
means converting the new line characters of a Unix file into line PC
eolns

The maximum number of translations in the translation table file is
1. If there are more, the rest are ignored. Each translation can
have up to 127 characters, and line in translation table must not
exceed 250 columns.

Use pipes for multiple translations. Example:
TYPE InputFileName | FILGEN Table1 | FILGEN Table2 > OutputFileName
