man/man1/bsfilt.1

   1 .\"     manual page for bsfilt(1)
   2 .\"
   3 .\"
   4 .\"     Copyright (c) 1991 Purdue University Research Foundation,
   5 .\"     West Lafayette, Indiana 47907.  All rights reserved.
   6 .\"
   7 .\"     Written by Victor A. Abell <abe@mace.cc.purdue.edu>,  Purdue
   8 .\"     University Computing Center.  Not derived from licensed software;
   9 .\"     derived from awf(1) by Henry Spencer of the University of Toronto.
  10 .\"
  11 .\"     Permission is granted to anyone to use this software for any
  12 .\"     purpose on any computer system, and to alter it and redistribute
  13 .\"     it freely, subject to the following restrictions:
  14 .\"
  15 .\"     1. The author is not responsible for any consequences of use of
  16 .\"        this software, even if they arise from flaws in it.
  17 .\"
  18 .\"     2. The origin of this software must not be misrepresented, either
  19 .\"        by explicit claim or by omission.  Credits must appear in the
  20 .\"        documentation.
  21 .\"
  22 .\"     3. Altered versions must be plainly marked as such, and must not
  23 .\"        be misrepresented as being the original software.  Credits must
  24 .\"        appear in the documentation.
  25 .\"
  26 .\"     4. This notice may not be removed or altered.
  27 .\"
  28 .TH BSFILT 1 "February, 1991"
  29 .BY "Purdue University"
  30 .SH NAME
  31 bsfilt, colcrt \- a colcrt-like backspace filter
  32 .SH SYNOPSIS
  33 .B bsfilt
  34 [
  35 .B -
  36 ] [
  37 .B -U
  38 ] [ file ... ]
  39 .SH DESCRIPTION
  40 .I Bsfilt
  41 filters backspace sequences from the input \fIfile\fR(s)
  42 (standard input if none)
  43 in an approximation of
  44 .IR colcrt (1).
  45 Both the backspace and the character it returns to are removed,
  46 unless they form an underline sequence.
  47 Underline sequences are treated according to the settings of
  48 the
  49 .B \-
  50 and
  51 .B \-U
  52 options.
  53 .SH OPTIONS
  54 .TP
  55 .B \-
  56 specifies that no underlining of any kind is to be propagated.
  57 Without this option or the
  58 .B \-U
  59 option,
  60 .I bsfilt
  61 approximates underlining with minus signs (`-') in following lines.
  62 .TP
  63 .B \-U
  64 specifies that underlining with underscore (`_') and backspace (`\b')
  65 character sequences is permitted.
  66 .SH SEE ALSO
  67 cawf(1), colcrt(1) and nroff(1).
  68 .SH DIAGNOSTICS
  69 Diagnostic messages are delivered to the standard error file.
  70 .SH HISTORY
  71 Vic Abell of Purdue University wrote
  72 .I bsfilt
  73 to have a backspace filter for
  74 .IR cawf (1)
  75 that is independent of licensed source code.
  76 .SH BUGS
  77 The maximum length of a line that can be underlined with minus signs is
  78 fixed.
  79 .LP
  80 .I Bsfilt
  81 does not examine the characters that are being overprinted via backspace
  82 operations.
  83 Thus, overprinting that is intended to form a new character from several
  84 different ones is ineffective and only the last character of the
  85 sequence is propagated \- e. g., ``o^H+'', intended to look like
  86 a bullet, is reduced to `+'.