Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
RTF2RTF(1)		     General Commands Manual		      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 pro-
     gram 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  (gener-
     ating  WinHelp  .RTF files for my documents), but it could definitely use a
     redesign/rewrite. It started as a simple perturbation of the html2html fil-
     ter, 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  main-
     taining 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rtf2rtf&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help