| 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 `+'.
|
|---|
