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).
       Currently maintained by Agustin Martin <agustin6martin AT gmail com>.

                                                   2000-05-14                                         RTF2RTF(1)