Provided by: linuxdoc-tools_0.9.73-2_amd64 bug

NAME

       rtf2rtf - programs to postprocess the raw RTF generated by the mapping files

SYNOPSIS

       rtf2rtf [options] ..

DESCRIPTION

       This manual page documents briefly the rtf2rtf commands.  This manual page was written for
       the Debian GNU/Linux distribution because the original program does not have a manual page
       for rtf2rtf.

       rtf2rtf is a program to postprocess the raw RTF generated by the mapping files.

       It  is used by other programs in sgml-tools (v1), and usually normal user does not need to
       use this program directly.

       Following is quoted from the README in the source tree.

       (Begin Quotes)

       I'm not proud of this code. It's a hack foisted upon a hack, nested within another hack or
       two.   It  sort of works well enough for my purposes (generating WinHelp .RTF files for my
       documents), but it could definitely  use  a  redesign/rewrite.  It  started  as  a  simple
       perturbation of the html2html filter, but got ugly very quickly...

       I shamelessly blame the RTF format for most of the hackery here -- RTF is not a _language_
       like LaTeX or ROFF -- it's just a file format. So, we can't rely on RTF to do even  simple
       things  like  "insert  a  paragraph  break  here only if the previous token was not also a
       paragraph break. Since the SGML front end  has  no  conditional  processing  capabilities,
       multiple blank likes in the SGML get translated to multiple para breaks in the RTF. That's
       why we use a "lex" filter (rtf2rtf) to postprocess the raw RTF generated  by  the  mapping
       files.

       Again:  I  offer  this  to the Linuxdoc community with the hopes that it will be useful to
       others and that someone else can help flesh out the missing pieces. What? Missing  pieces?
       Yes,  recall  that  I  say  it works "well enough for my purposes".  The replacement files
       (general, mapping) started out like as the latex replacement files.  Much  of  them  still
       _are_ the latex replacement files.  I only converted those parts that are actually used by
       my documents. Your documents may require more of the files to be translated to RTF.

       Since I'm using these mappings for  actual  documentation,  I  plan  on  maintaining  this
       backend, so please send me any improvements -- I'll coordinate with Greg to make sure they
       get into the the next official release.

       (End Quotes)

OPTIONS

       The programs does not support normal command line option.

SEE ALSO

       For a complete description, see the README file in the source archive.

AUTHOR

       rtf2rtf was written by Steve Tynor (tynor@atlanta.twr.com)  December  1995.   This  manual
       page was written by Taketoshi Sano <sano@debian.org>, for the Debian GNU/Linux system (but
       may be used by others).

                                                                                       RTF2RTF(1)