rtf2rtf



RTF2RTF(1)                                                          RTF2RTF(1)




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  map-
       ping 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 pur-
       poses (generating WinHelp .RTF files for my documents),  but  it  could
       definitely  use  a redesign/rewrite. It started as a simple pertubation
       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,  map-
       ping)  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)

Man(1) output converted with man2html