File: latex2rtf.1

package info (click to toggle)
latex2rtf 1.8aa-2
  • links: PTS
  • area: main
  • in suites: potato
  • size: 1,300 kB
  • ctags: 535
  • sloc: ansic: 5,434; makefile: 231; sh: 4
file content (286 lines) | stat: -rw-r--r-- 8,954 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
.\" $Id: latex2rtf.1,v 1.11 1998/07/03 06:47:24 glehner Exp $
.\" History:
.\" $Log: latex2rtf.1,v $
.\" Revision 1.11  1998/07/03 06:47:24  glehner
.\" Changed maintainer, added reference to other docs
.\"
.\" Revision 1.10  1997/02/15 20:50:20  ralf
.\" Added Section on bug reports
.\" Corrected some wording
.\" Corrected description of config files to match the implementation :-(
.\" Corrected some incorrect (or non-portable?) troff
.\"
.\" Revision 1.9  1995/03/23 15:58:08  ralf
.\" Reworked version by Friedrich Polzer and Gerhard Trisko
.\"
.\" Revision 1.8  1994/06/29  06:35:28  ralf
.\" Corrected some '\' to '\\'
.\"
.\" Revision 1.7  1994/06/29  06:31:54  ralf
.\" Changed rtf2latex to latex2rtf in several places.
.\"
.\" Revision 1.6  1994/06/21  08:14:11  ralf
.\" Added BUGS section
.\"
.\" Revision 1.5  1994/06/17  15:13:07  ralf
.\" Added description of RTFPATH
.\"
.\" Revision 1.4  1994/06/17  14:42:29  ralf
.\" Added description of -V option
.\"
.\" Revision 1.3  1994/06/17  14:19:41  ralf
.\" Corrected various bugs, for example interactive read of arguments
.\"
.\" Revision 1.2  1994/06/17  12:07:30  ralf
.\" Corrected typos
.\"
.\" Revision 1.1  1994/06/17  11:30:33  ralf
.\" Initial revision
.\"
.TH latex2rtf 1
.SH NAME
latex2rtf \- Converts LaTeX file to RTF text-format
.SH SYNTAX
latex2rtf [-V] [-l] [ -o
.I outputfile
] [ -a
.I auxfile
] [ -b
.I bblfile
] [
.I inputfile
]
.PP
.SH WARNING
This man page is not supported by me (the maintainer of the programm).
For complete, current documentation, refer to the Info file
.B latex2rtf.info,
the PDF file
.B latex2rtf.pdf
or the HTML file
.B l2r.html
which are made from the Texinfo source file
.BR latex2rtf.texi.
.SH DESCRIPTION
The
.I latex2rtf
command converts a LaTeX file into RTF text format. The text and much
of the formatting 
information is translated to RTF making the new file look very similar to the
original. 
.PP
The \-V option prints version information on standard output and exits.
.PP
The -l option enables you to convert ISO 8859-1 (Latin-1) special characters in the LaTeX source. 
.PP
Unless an 
.I outputfile
is specified with the -o option, the resulting RTF is produced on standard output.
.PP
You can specify an 
.I auxfile 
(for citations) with the -a option. If this is omitted, the
.I inputfile
with the suffix .aux will be taken.
.PP
You can specify an 
.I bblfile 
(for citations) with the -b option. If this is omitted, the
.I inputfile
with the suffix .bbl will be taken.
.PP
If 
.I inputfile
is not specified, standard input is read. 
.PP
User defined LaTeX commands are ignored. If you are familiar with the
RTF format and
the commands can be translated by simply inserting a format string
into the RTF
file you can add these commands to the 
.B direct.cfg
configuration file.
See format description below.
.PP
To correctly convert font names you must edit the 
.B fonts.cfg
configuration file.
You have to specify the font names you use and how the LaTeX default font names
should be converted to RTF. See format description below.
.PP
LaTeX variables and user defined commands are not evaluated.
They will be simply ignored. To let
.I latex2rtf
know the names of variables you can add them in the 
.B ignore.cfg
file.
See format description below.
.PP
The environment variable RTFPATH may contain a search path for the
support files (all files ending in .cfg). If no file is found during the
search in the search-path or if the environment variable is not set, the
compiled-in default for the configuration-file directory is used. If the
files are not found at all the program aborts.
.PP
\\label, \\ref, and \\pageref commands from LaTeX are translated to
hidden text in the RTF file. This makes it possible to correctly edit
the resulting file in the target word processor.
.SH CAUTION
Please make sure that the input file is a correct LaTeX file. Use LaTeX
to find and correct errors before using
.I latex2rtf.
The conversion command does not properly handle all
errors because of corrupt input files.
.PP
Make sure that the configuration files 
.B direct.cfg
and
.B fonts.cfg
are in the correct directory.
You may have to change
.B fonts.cfg
or
.B direct.cfg
to suit your needs.
.SH CONFIGURATION FILES
The file
.B direct.cfg
is used for converting LaTeX commands by simple text replacement.
The format consists of lines with a LaTeX command with backslash
followed by comma.
The rest of the line until a '.' character will be written to the RTF file
when the command is recognized in the LaTeX file.
Lines starting with a '#' character are ignored.
After the '.' everything is ignored to end of line.
To select a specific font use 
.I *fontname*.
Make sure that the font name 
.I fontname
is listed in the fonts configuration file at least as dummy.
To write the '*' character use "**".
example:
.PP
\\alpha,{\\f*Symbol* a}. #alpha under Windows Symbol Font
.PP
\\copyright,{\\ansi\\'a9\\pc}.
.PP
The file
.B fonts.cfg
contains the fonts conversion table.
A line consists of a font name in LaTeX followed by comma and a font
name in RTF. The end is marked by a '.'.
No spaces are allowed.
The LaTeX font will be converted to the RTF font if encountered in the
LaTeX file.
If multiple translations for a LateX font are specified,
only the first is used.
All fonts in a LaTeX file that are not in this file will be mapped to the
default font.
All RTF fonts listed in this file will be in every RTF file header whether
used or not.
Lines starting with a '#' character are ignored.
After the '.' everything is ignored to end of line.
To add a RTF font not used as substitute for a LaTeX font \- for example
a Symbol font used in 
.B direct.cfg
\- use a dummy LaTeX name like in the following example:
.PP
Dummy3,MathematicalSymbols.
.PP
Make sure you use the correct font name. Take care of spaces in font names.
The default fonts are named Roman (command \\rm), Slanted (command \\sl),
Sans Serif (command \\sf), Typewriter (command \\tt).
.PP
The file
.B ignore.cfg
is used for defining how to ignore certain commands.
This file is used for recognition of LaTeX-variables, user defined variables,
and some simple commands.
All variables are ignored but the converter must know the names to correctly
ignore assignments to variables.
Lines in this file consist of a variable-name with backslash, followed
by comma and the type of the variable followed by '.'.
Possible Types are:
.PP
.TP
.B NUMBER
simple numeric value
.TP
.B MEASURE
numeric value with following unit of measure
.TP
.B OTHER
ignores anything to the first character after '=' and from there to next
space. eg. \\setbox\\bak=\\hbox
.TP
.B COMMAND
ignores anything to next '\\' and from there to occurence of anything
but a letter. eg. \\newbox\\bak
.TP
.B SINGLE
ignore single command. eg. \\noindent
.PP
The types are in upper case exactly as above.
Do not use spaces.
Lines starting with a '#' character are ignored.
After the '.' everything is ignored to end of line.
Example:
.PP
\\pagelength,MEASURE.
.PP
.SH BUGS
Some environments like figure are currently ignored. It would be nice to scan
the included information and convert things if possible.
.PP
Because the seek-command is used on input there are only file-redirections 
possible when reading from stdin. 
.PP
Some of the generated table can confuse Word, the problem may be corrected 
by editing the offending table within Word.
.PP
.SH REPORTING BUGS
Report bugs to glehner@unanleon.edu.ni (Georg Lehner). Please give the
following information and observe the following guidelines when
reporting a bug in the program:
.PP
Tell me the version of the program. For the executable you get the version by
specifying the \-V option to 
.I latex2rtf.
For the sources the version is
the version number of the file
.B version.h.
.PP
The Operating System and version number where you are running or
trying to install
.I latex2rtf.
Be sure to check the file 
.B Makefile
for settings that may be specific to your machine, especially for some
versions of
.B SunOS
there may be settings which are needed to compile
successfully. Do this
.I before
writing to me.
.PP 
For problems with the DOS version, report installation problems to the
mainainer of the DOS port, Vladimir Menkov, vmenkov@cs.indiana.edu
.PP
If the program produces wrong output or does not work for you, include
a 
.I short
latex file along with a description of the problem.
.I Do not
send me large latex or rtf files, I simply do not have the time to
wade through large files to search for a bug! If necessary (i.e., the
program produces wrong or invalid rtf), send the rtf file that is
produced along with the latex input file.
.PP
Be patient with me. I am maintaining the program in my free time. I
did not write most of the code. Often I do not have the time to answer
to your question. I will, however, try to fix reported bugs in
upcoming releases.
.SH SEE ALSO
rtf2LaTeX(1), LaTeX User's Guide & Reference Manual by Leslie Lamport