troff2rtf(1) [debian man page]
TROFF2RTF(1) General Commands Manual TROFF2RTF(1) 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., Micro- soft 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 doc- ument 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)
Check Out this Related Man Page
TROFFCVT(1) General Commands Manual TROFFCVT(1) NAME
troffcvt - troff-to-XXX converter SYNTAX
troffcvt [ options ] file ... DESCRIPTION
troffcvt converts troff input into an intermediate form that is easier to interpret than raw troff language. This intermediate form can then be used by postprocessors like tc2html or tc2rtf to produce final output in a target format such as HTML or RTF. troffcvt understands the options listed below. Except as noted, options must be specified before the first input file named on the command line. -A Normally, troffcvt reads the default action file before reading any action or macro files named on the command line using the -a or -m options. If -A is specified, troffcvt doesn't read the default action file. This option is rarely used, but it can be helpful when you want to try out a modified default file. -afile, -a file Read the given action file. -a may also be specified in the input file part of the argument list. -C Turn on groff-style compatibility mode. Specifically, this option disables recognition of long (> 2 character) request and macro names, and special character, register, string, font, and macro argument references of the forms [xxx], [xxx], *[xxx], f[xxx], and $[nnn]. If -C is specified, compatibility mode is turned on when the first input file is about to be read. (Macro packages specified with -m may turn on compatibility mode themselves, of course. However, compatibility mode is always turned off while action files are read.) -dN, -d N Turn on debugging flag N. The flags are listed in troffcvt.h. If -d is not followed by a number, all flags are turned on. -l Generate line controls in the output to indicate the point at which each input line was read. These controls have the following form: line filename linenumber where filename is the current input filename and linenumber is the current input line in that file. -mxx Read the given macro package (e.g., -man, -ms) before the input files are read. -rN, -r N Specify a resolution of N units per inch. The default is 432 units/inch. -tformatter-type, -t formatter-type Specify a formatter type that troffcvt should try to act like. Valid formatter-type values are: nroff Act like nroff troff Act like troff This option has little effect on troffcvt's behavior other than to determine the result of the .if t and .if n conditionals. troffcvt finds action files by looking in the following locations: o The current directory. o The troffcvt library directory, /usr/share/troffcvt. troffcvt finds macro packages by looking in the following locations: o The directories named by the TROFFCVT_TMAC_PATH environment variable, if that variable is set. TROFFCVT_TMAC_PATH consists of one or more directories, separated by colons. o The directory named by the TROFFCVT_LIB_DIR environment variable, if that variable is set. o The current directory. o The compiled-in troffcvt library directory /usr/share/troffcvt. This allows you to override a system macro package by placing a different version in the troffcvt library. o The system macro directory (e.g., /usr/lib/tmac or /usr/share/groff/tmac). Macro and action files specified with -m and -a prior to the first input file are processed in order before the first input file is read. Once the initial options have been read and processed, troffcvt reads the input files, or the standard input if no files are read. The name - may be used to refer explicitly to the standard input. -a may be used to intersperse action files with input files in this part of the argument list. For example: % troffcvt -ms mymacros -a tc.mymacros mydoc DIAGNOSTICS
If troffcvt cannot open a macro file, you will see this message: cannot open macro file -mxx This message is fatal. If troffcvt cannot open an action file, you will see this message: cannot open action file <xx> This message usually indicates a problem, but is not fatal (except for the default action file actions, which must be available for trof- fcvt to do anything at all). If you still get reasonable output, you can ignore it. To make the message go away, create an empty file named xx in any of the directories in which troffcvt looks for action files. If you don't get reasonable output, then a non-empty file needs to be created that redefines the macros that confuse troffcvt. FILES
/usr/share/troffcvt troffcvt library directory WHO-TO-BLAME Paul DuBois, dubois@primate.wisc.edu. SEE ALSO
tc2html(1), tc2rtf(1), tc2text(1), troff2html(1), troff2rtf(1), unroff(1). troffcvt - Notes, Bugs, Deficiencies. BUGS
There are many. See the document troffcvt - Notes, Bugs, Deficiencies. TROFFCVT(1)