CLMAN.C and CLMAN.1

[rconn%brl at sri-unix.UUCP]

From:      Rick Conn <rconn at 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)