summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-40/man1/rtf2rtf.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-40/man1/rtf2rtf.1')
-rw-r--r--upstream/fedora-40/man1/rtf2rtf.170
1 files changed, 70 insertions, 0 deletions
diff --git a/upstream/fedora-40/man1/rtf2rtf.1 b/upstream/fedora-40/man1/rtf2rtf.1
new file mode 100644
index 00000000..06098256
--- /dev/null
+++ b/upstream/fedora-40/man1/rtf2rtf.1
@@ -0,0 +1,70 @@
+.\" Process this file with
+.\" groff -man -Tascii rtf2rtf.1
+.\"
+.TH RTF2RTF 1
+.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
+.\" other parms are allowed: see man(7), man(1)
+.SH NAME
+rtf2rtf \- programs to postprocess the raw RTF generated by the mapping files
+.SH SYNOPSIS
+.B rtf2rtf
+.I "[options] .."
+.br
+.SH "DESCRIPTION"
+This manual page documents briefly the
+.BR 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.
+.PP
+.B rtf2rtf
+is a program to postprocess the raw RTF generated by the mapping files.
+.PP
+It is used by other programs in sgml-tools (v1), and usually
+normal user does not need to use this program directly.
+.PP
+Following is quoted from the README in the source tree.
+.TP
+(Begin Quotes)
+.PP
+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 (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...
+.PP
+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.
+.PP
+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.
+.PP
+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.
+.TP
+(End Quotes)
+
+.SH OPTIONS
+The programs does not support normal command line option.
+
+.SH "SEE ALSO"
+For a complete description, see the README file in the source archive.
+.SH AUTHOR
+.B 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).