| 1 |
.\" Process this file with |
| 2 |
.\" groff -man -Tascii rtf2rtf.1 |
| 3 |
.\" |
| 4 |
.TH RTF2RTF 1 "2000-05-14" |
| 5 |
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection |
| 6 |
.\" other parms are allowed: see man(7), man(1) |
| 7 |
.SH NAME |
| 8 |
rtf2rtf \- programs to postprocess the raw RTF generated by the mapping files |
| 9 |
.SH SYNOPSIS |
| 10 |
.B rtf2rtf |
| 11 |
.I "[options] .." |
| 12 |
.SH "DESCRIPTION" |
| 13 |
This manual page documents briefly the |
| 14 |
.BR rtf2rtf |
| 15 |
commands. |
| 16 |
This manual page was written for the Debian GNU/Linux distribution |
| 17 |
because the original program does not have a manual page for rtf2rtf. |
| 18 |
.PP |
| 19 |
.B rtf2rtf |
| 20 |
is a program to postprocess the raw RTF generated by the mapping files. |
| 21 |
.PP |
| 22 |
It is used by other programs in sgml-tools (v1), and usually |
| 23 |
normal user does not need to use this program directly. |
| 24 |
.PP |
| 25 |
Following is quoted from the README in the source tree. |
| 26 |
.TP |
| 27 |
(Begin Quotes) |
| 28 |
.PP |
| 29 |
I'm not proud of this code. |
| 30 |
It's a hack foisted upon a hack, nested within another hack or two. |
| 31 |
It sort of works well enough for my |
| 32 |
purposes (generating WinHelp .RTF files for my documents), but it |
| 33 |
could definitely use a redesign/rewrite. |
| 34 |
It started as a simple |
| 35 |
perturbation of the html2html filter, but got ugly very quickly... |
| 36 |
.PP |
| 37 |
I shamelessly blame the RTF format for most of the hackery here -- RTF |
| 38 |
is not a _language_ like LaTeX or ROFF -- it's just a file format. So, |
| 39 |
we can't rely on RTF to do even simple things like "insert a paragraph |
| 40 |
break here only if the previous token was not also a paragraph |
| 41 |
break". |
| 42 |
Since the SGML front end has no conditional processing |
| 43 |
capabilities, multiple blank likes in the SGML get translated to |
| 44 |
multiple para breaks in the RTF. |
| 45 |
That's why we use a "lex" filter |
| 46 |
(rtf2rtf) to postprocess the raw RTF generated by the mapping files. |
| 47 |
.PP |
| 48 |
Again: I offer this to the Linuxdoc community with the hopes that it |
| 49 |
will be useful to others and that someone else can help flesh out the |
| 50 |
missing pieces. |
| 51 |
What? |
| 52 |
Missing pieces? |
| 53 |
Yes, recall that I say it works "well enough for my purposes". |
| 54 |
The replacement files (general, |
| 55 |
mapping) started out like as the latex replacement files. |
| 56 |
Much of them still _are_ the latex replacement files. |
| 57 |
I only converted those |
| 58 |
parts that are actually used by my documents. |
| 59 |
Your documents may |
| 60 |
require more of the files to be translated to RTF. |
| 61 |
.PP |
| 62 |
Since I'm using these mappings for actual documentation, I plan on |
| 63 |
maintaining this backend, so please send me any improvements -- I'll |
| 64 |
coordinate with Greg to make sure they get into the the next official |
| 65 |
release. |
| 66 |
.TP |
| 67 |
(End Quotes) |
| 68 |
|
| 69 |
.SH OPTIONS |
| 70 |
The programs does not support normal command line option. |
| 71 |
|
| 72 |
.SH "SEE ALSO" |
| 73 |
For a complete description, see the README file in the source archive. |
| 74 |
.SH AUTHOR |
| 75 |
.B rtf2rtf |
| 76 |
was written by Steve Tynor ([email protected]) December 1995. |
| 77 |
This manual page was written by Taketoshi Sano <[email protected]>, |
| 78 |
for the Debian GNU/Linux system (but may be used by others). |
| 79 |
Currently maintained by Agustin Martin <agustin6martin AT gmail com>. |