NAME

       filterm - filter terminal input and/or output

SYNOPSIS

       filterm INPUT OUTPUT [COMMAND [ARGS]]

DESCRIPTION

       Execute the specified COMMAND (default is the shell), filtering terminal input and/or output.

       It  can  help  e.g. when our terminal is unable to display non-ASCII characters or to enter them from the
       keyboard. It also makes writing various terminal filters easier.

       INPUT and OUTPUT are names of konwert's filters - they are passed as the first argument to the konwert(1)
       program.  filterm - OUTPUT filters only output, and filterm INPUT - only input.

       The command - executes the shell as a login shell.

       It differs from konwert INPUT | COMMAND | konwert OUTPUT in that the command is  executed  on  a  pseudo-
       terminal, so full-screen programs work correctly.

       The filters have to output the characters as soon as they receive all necessary input, without buffering.
       trs(1) scripts are OK, but sed(1) or awk(1) or tr(1) scripts are not. In C you may use read(), getchar(),
       fread(),  and  write(), but putchar() and fwrite() only together with fflush(stdout).  In C++: cin.get(),
       cout.put(), and cout <<.  In perl: sysread, getc, read, and syswrite, but print only with $| = 1.

       The input filter will have set the environment variable FILTERM=in, and the  output  one  -  FILTERM=out.
       This way some filters can slightly alter their behaviour when working for filterm.

   OPTIONS
       --help    display help and exit

       --version output version information and exit

FILTERS FOR FILTERM

       See konwert(1).  Additionally the following konwert's filters are designed only for filterm:

       tyldy (input)
              Polish ~a~c~e~l~n~o~s~x~z

       lewyap (input)
              Polish `a`c`e`l`n`o`s`x`z

       boldpl (output)
              ASCII with Polish letters shown as bold.

       pinectrlchars (output)
              Replaces the characters 128..159 shown by the Pine (or another program) as ^À..^ß back to the real
              128..159.

       512bold (output)
              Changes  the  mapping  of  colors  in  512-character mode, which restricts the number of colors to
              eight. The palette is dynamically changed to contain the eight most  recently  used  colors.  When
              more colors are used at once, some of them display incorrectly.

       512bold1 (output)
              Changes  the  mapping  of  colors  in  512-character  mode. Instead of ignoring the intensity, the
              following colors are available: black, red, green, white, blue, light magenta, light  cyan,  light
              gray;  others  are substituted with approximations. This gives better effect, allowing to show the
              intensity, with the side-effect of belying the hue of some colors.

       kbdmacros (input)
              Keyboard macros. A sequence of keys can be recorded with Esc Ctrl-A SEQUENCE Esc Ctrl-E SHORTCUT -
              after which, if you press the SHORTCUT,  the  SEQUENCE  will  be  generated  instead.  Later  such
              assignment  can  be  deleted with Esc Ctrl-A Esc Ctrl-E SHORTCUT Esc Ctrl-E.  Instead of Esc Ctrl-
              you often may press Ctrl-Alt-.  The defined shortcuts, together with  the  above  redefinable  key
              combinations  used  to define them, are stored in the ~/.kbdmacros file. Note: when you redefine a
              sequence, all its prefixes will not be passed through  immediately,  but  wait  until  it  can  be
              unambiguously  told which sequence was actually input. This includes escape sequences representing
              some extended keys.

SEE ALSO

       konwert(1)

BUGS

       512bold filter is not perfect. Some escape sequences may be emulated  incorrectly.  Additionally,  colors
       changed in multiple steps or not used unnecessarily allocate some of the eight colors.

COPYRIGHT

       filterm filters terminal input and/or output. It forms part of the konwert package.

       Copyright (c) 1998 Marcin 'Qrczak' Kowalczyk

       This  program  is  free  software;  you  can  redistribute it and/or modify it under the terms of the GNU
       General Public License as published by the Free Software Foundation; either version 2 of the License,  or
       (at your option) any later version.

       This  program  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General  Public
       License for more details.

       You  should have received a copy of the GNU General Public License along with this program; if not, write
       to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

AUTHOR

        __("<   Marcin Kowalczyk * qrczak@knm.org.pl http://qrczak.home.ml.org/
        \__/       GCS/M d- s+:-- a21 C+++>+++$ UL++>++++$ P+++ L++>++++$ E->++
         ^^                W++ N+++ o? K? w(---) O? M- V? PS-- PE++ Y? PGP->+ t

       QRCZAK                  5? X- R tv-- b+>++ DI D- G+ e>++++ h! r--%>++ y-
Konwert                                            30 Jul 1998                                        FILTERM(1)