rconn%brl@sri-unix.UUCP (09/20/83)
From: Rick Conn <rconn@brl> Sorry about all the inconvenience with the doc I sent out containing backspaces. I looked at the MAN output and wrote a program which filters it, correcting for bold face and underlining. CLMAN (for Clean Man) is in MICRO:<MC.UNIX>CLMAN.C and doc in CLMAN.1 on SIMTEL20. Here is the man on it (filtered!): CLMAN(1) BRL UNIX CLMAN(1) NAME CLMAN -- Clean Up Man Output, Leaving No Backspaces in File CLMAN was written by Richard Conn SYNOPSIS CLMAN accepts its input from STDIN and directs its output to STDOUT. It is intended to be used with the following forms: man entry | clman >result <-- output to file man entry | clman <-- output to console The resulting output contains no backspace characters and is quite readable. DESCRIPTION CLMAN removes some of the formatted output from MAN in order to better display the result on a CRT (or non- backspacing device). It handles two cases: Boldface -- MAN generates <char> <backspace> <char> when it wants to bold face; CLMAN removes the <backspace> <char> part of the output Underline -- MAN generates '_' <backspace> <char> when it wants to underline something; CLMAN removes the '_' <backspace> part of the output FILES clman.c -- source code DIAGNOSTICS CLMAN generates no diagnostic error messages. BUGS CLMAN contains no known bugs. The exact form of all man output is unknown to the author, however, and the cases of underline and boldface are the only two accounted for by CLMAN. It is possible that information may be lost if backspaces are used in a sense other than that noted by the author. CLMAN has run successfully against a number of cases tested so far, including 'man man', and no problems are known at this time. AUTHOR CLMAN was written by Richard Conn. Page 1 (last mod. 9/19/83)