Path: utzoo!attcan!uunet!zaphod.mps.ohio-state.edu!ub!boulder!ccncsu!poa.NREL.ColoState.EDU!daveb
From: daveb@poa.NREL.ColoState.EDU (Dave Bigelow 491-5574)
Newsgroups: comp.text
Subject: Creating `man' pages with tbl eqn
Keywords: catman, nroff
Message-ID: <10541@ccncsu.ColoState.EDU>
Date: 24 Oct 90 14:19:55 GMT
Sender: news@ccncsu.ColoState.EDU
Reply-To: daveb@poa.NREL.ColoState.EDU
Followup-To: comp.text
Organization: Natural Resource Ecology Lab, Colo State Univ
Lines: 29

I have started a small documentation project which initially involves
placing some previously published troff documents (single pages up to
reports) into local `man' pages.  When I attempt to use the `catman'
utility however, equations and tables are not processed.  I can produce
an acceptable man page document by utilizing the tbl|eqn|nroff -ms
sequence of commands and piping the output to the appropriate catl
directory entry.  This works well when equations are on a single line
but does not work when equations span multiple lines.

A second problem I will be having is maintaining new draft troff
documents as man pages.  My intention is (was?) to utilize the a single
file to serve both as the manl directory entry and as a file from which a
final camera-ready report could be produced. If the catman utility however,
will not handle tables and equations properly, every revision of the
document will cause a corrupted man page to be produced.

Is there a patch available for the catman utility that comes with SUNOS4.1?
Has anyone solved this problem before?
Would a commercial version of tbl, eqn, troff help solve this problem?

Dave Bigelow        Internet:  daveb@panicum.nrel.ColoState.edu
303-491-5574        Bitnet:    bigelow@CSUGOLD

Natural Resource Ecology Laboratory
Colorado State University
Ft. Collins, CO 80523

Dave Bigelow        Internet:  daveb@panicum.nrel.ColoState.edu
303-491-5574        Bitnet:    bigelow@CSUGOLD