debian man page for filterm

FILTERM(1)							Linux User's Manual							FILTERM(1)

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 var-
       ious 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  fil-
       ters 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 ^A..^B 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  substitutied	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  MER-
       CHANTABILITY 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)