NAME

       troff2rtf - convert troff documents to Rich Text Format

SYNTAX

       troff2rtf [ -mxx ] [ -S charset ] [ file ...  ]

DESCRIPTION

       troff2rtf  processes documents written to be formatted with troff (or nroff, or any of the
       other *roff variants) and converts them to Rich Text Format.  RTF is a reasonably portable
       interchange  standard; files in RTF format can be read by a variety of applications, e.g.,
       Microsoft Word, WordPerfect (Macintosh version 2.0 and up), WriteNow.

       The main use for troff2rtf is to make it easier to transport troff documents for use  with
       microcomputers.  First, convert your document to RTF:
              % troff2rtf [options] file > file.rtf
       The  available  options  are  described  below.  The one you'll most likely use is -mxx to
       specify a macro package like -me or -ms.  If the document contains tables, the  conversion
       can be done like this instead:
              % tblcvt file | troff2rtf [options] > file.rtf
       Then move the RTF file to your target machine and read it into your document processor.

       Optional flags may be given to modify the operation of troff2rtf, as follows:

       -mxx   Specify macro package, usually -man, -me, -mm, or -ms.

       -S charset
              Specify  the  RTF  character set.  charset can be one of the following: ansi mac pc
              pca.  The default is the Macintosh character set.  For documents that you intend to
              use under Windows, -S ansi is a better choice.

SEE ALSO

       tblcvt(1), troffcvt(1)

WHO-TO-BLAME

       Paul DuBois, dubois@primate.wisc.edu.

BUGS

       Table  output  generated  when  troff2rtf is used in concert with tblcvt has been known to
       crash Word outright; caution may be in order.  In addition,  you  may  need  to  read  the
       resulting RTF document into a word processor and tweak column widths manually.

       Word97  adds  support  for  vertically  merging table cells (using the \clvmgf and \clvmrg
       control words).  troff2rtf supports vertical  spans  using  these  controls,  but  earlier
       versions  of  Word  don't  yet  understand them.  Consequently, what you'll see for n-cell
       vertical spans is n individual cells, with all the text in the  top  cell  and  n-1  empty
       cells below it.

                                                                                     TROFF2RTF(1)