1RTF2RTF(1) General Commands Manual RTF2RTF(1)
2
6 rtf2rtf - programs to postprocess the raw RTF generated by the mapping
7 files
8
10 rtf2rtf [options] ..
11
13 This manual page documents briefly the rtf2rtf commands. This manual
14 page was written for the Debian GNU/Linux distribution because the
15 original program does not have a manual page for rtf2rtf.
16 rtf2rtf is a program to postprocess the raw RTF generated by the map‐
18 ping files.
19 It is used by other programs in sgml-tools (v1), and usually normal
21 user does not need to use this program directly.
22 Following is quoted from the README in the source tree.
24 (Begin Quotes)
26 I'm not proud of this code. It's a hack foisted upon a hack, nested
28 within another hack or two. It sort of works well enough for my pur‐
29 poses (generating WinHelp .RTF files for my documents), but it could
30 definitely use a redesign/rewrite. It started as a simple pertubation
31 of the html2html filter, but got ugly very quickly...
32 I shamelessly blame the RTF format for most of the hackery here -- RTF
34 is not a _language_ like LaTeX or ROFF -- it's just a file format. So,
35 we can't rely on RTF to do even simple things like "insert a paragraph
36 break here only if the previous token was not also a paragraph break.
37 Since the SGML front end has no conditional processing capabilities,
38 multiple blank likes in the SGML get translated to multiple para breaks
39 in the RTF. That's why we use a "lex" filter (rtf2rtf) to postprocess
40 the raw RTF generated by the mapping files.
41 Again: I offer this to the Linuxdoc community with the hopes that it
43 will be useful to others and that someone else can help flesh out the
44 missing pieces. What? Missing pieces? Yes, recall that I say it works
45 "well enough for my purposes". The replacement files (general, map‐
46 ping) started out like as the latex replacement files. Much of them
47 still _are_ the latex replacement files. I only converted those parts
48 that are actually used by my documents. Your documents may require more
49 of the files to be translated to RTF.
50 Since I'm using these mappings for actual documentation, I plan on
52 maintaining this backend, so please send me any improvements -- I'll
53 coordinate with Greg to make sure they get into the the next official
54 release.
55 (End Quotes)
57
60 The programs does not support normal command line option.
61
64 For a complete description, see the README file in the source archive.
65
67 rtf2rtf was written by Steve Tynor (tynor@atlanta.twr.com) December
68 1995. This manual page was written by Taketoshi Sano
69 <sano@debian.org>, for the Debian GNU/Linux system (but may be used by
70 others).
71 RTF2RTF(1)