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

FreeBSD Manual Pages

  
 
  

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	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 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, 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@de-
       bian.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+14.3.quarterly>

home | help