Brief installation guide for troffcvt distribution

--------------------------------------------------------------------------

1) Reconsider whether you really want to do this.  This is beta software.
If you find bugs, please report them.

2) Get the ETM, TS and MemMgr distributions (anonymous ftp from
ftp.primate.wisc.edu, look in the pub directory), and install them.
The libraries go in /usr/lib, the header files (probably) go in
/usr/include/local.

3) Haven't you decided not to install this stuff yet?

4) Compile these programs:
	troffcvt
	tc2rtf
	tc2text
	tc2null

5) Build these scripts:
	troff2rtf
	unroff
	troff2null

To build these, you either need msub, which is part of the imake
distribution config-WRPRC-1.03.shar.Z on ftp.primate.wisc.edu in
pub/imake-stuff, or you can just create them from the *.sh templates,
add "#!/bin/sh" at the beginning and make them executable.


6) Create a directory /usr/lib/troffcvt and put copies of these
files in it:
	actions
	tcr-fonts
	rtf-fonts
	rtf-spec-{ansi,mac,pc,pca}
	text-specials
	{man,me,mm,ms}-redefs

Alternatively: you can put these files in the same directory from
which you run the programs that use them.

You may want to modify tcr-fonts and rtf-fonts to reflect typefaces
locally available at your site.  You may want to modify text-specials
and rtf-spec-* to reflect special characters available in versions of
troff at your site.

7) Install these programs in /usr/local or some other public directory:
	troffcvt
	tc2rtf
	troff2rtf
	tc2text
	unroff
	tc2null
	troff2null

--------------------------------------------------------------------------

To use troff2rtf:

	troff2rtf [-mxx] file > file.rtf

-mxx is your usual macro argument, e.g., -me, -ms.  You can ignore any
messages about a "redefs" file not being found; there aren't any yet.

Output that should be tbl'ed:

	tbl file | troff2rtf [-mxx] > file.rtf

gtbl WILL NOT WORK with troffcvt.

Output that should be pic'ed or eqn'ed:

	don't even try it

unroff or troff2null may be substituted in the above for troff2rtf.
unroff allows a -joins option that joins output lines (so that each
paragraph is a single long text line.)

Documents available are:
	troff2rtf.man	man page for troff2rtf
	troffcvt.ms	overview
	actions.ms	action reference
	bugs.ms		bug list
	output.ms	output format, postprocessor writing
	tc2rtf.ms	misc stuff about tc2rtf

Questions to: dubois@primate.wisc.edu
