summaryrefslogtreecommitdiff
path: root/support/rtflatex/rtflatex.doc
blob: ffbbcdc6336de30ed690b17c3975398e2cd50aa7 (plain)
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
Subject: RTFLATEX -- July 25th, 1995
New release of RTF-to-LaTeX converter (RTFLaTeX), 
version 2.14, by Daniel TAUPIN,
Laboratoire de Physique des Solides, 91405 ORSAY, France.

New features:
  -- C source (from p2c) corrected to avoid data overrunning due to a p2c
     "feature" ignoring string truncation at assignments, but overwriting
     nearby and unpredictable data,
  -- font handling conform either to LaTeX2e or to LaTeX209 (option)
  -- tables (approximately) converted
Does not convert:
  -- pictures
  -- equation editor output (this is... unpredictably coded)
  -- other features whose semantic is not clear in Microsoft's specifications

Available at anonymous ftp: rsovax.lps.u-psud.fr
                            Directory [anonymous.rtf2tex] 

                       ftp: hprib.lps.u-psud.fr
                            Directory pub/rtflatex 

Provided as zipped (executable for MS-DOS, Turbopascal source, standard
C and data files)

Installation
============
To install it quickly on MS-DOS, put all the RTFLATEX.* files in the same
directory. To get help, execute RTFLATEX without arguments.

To recompile on MS-DOS, either:
  - use Borland's TurboPascal with RTFLATEX.PAS,
  - compile "rtflatex.c" with a djgpp/gcc compiler
      gcc rtflatex.c -ortflatex -lm -funsigned-char -v
      coff2exe -s <the_complete_path>/go32.exe rtflatex

To recompile on non MS-DOS systems, perform:
      cc -funsigned-char -v rtflatex.c -ortflatex

For final installation, copy or move the rtflatex executable into a directory
of the usual path, and copy or move rtflatex.skw IN THE SAME directory. Put
rtflatex.sty in the usual TEXINPUT directory.

Bugs and associated features
============================
WARNING: this is a "(tentatively) quick-and-(less)dirty" trial to
convert RTF although I do not have all specifications.  If you find an
\RTFac{xy} in your code just send me a message to say: \'xy should be
converted as \"Z (for example) or as $\something{}$; in this case specify
also whether the coding is \ansi or \mac or something else (look at the
very beginning of the RTF file to find out).

Secondly, note that Word[perfect] allows anything (bold, teletype, etc.) in
formulae but (La)TeX does not, so you have to look carefully at the way formulae
are transcribed... and correct the output.

If you find undefined sequences of the form \RTFsomething, think of defining
  \def\RTFsomething{}   % case of no argument
  \def\RTFsomething#1{} % case of one argument
in RTFLATEX.STY if possible... and send me your proposal. You can also
tell rtflatex to skip that sequence explicitely (even better) by inserting
a line being either
  \RTFsomething
(no argument) or
  \RTFsomethiing{
(with one opening brace, case of one argument) into the file rtflatex.skw .


IMPORTANT: if you just want to convert the text and the equations, but
you do not need to retrieve the initial Word[perfect] layout (paragraph
sizes, line spacings) you have better convert with the "-v" option which
provides a cleaner LaTeX source, easier to correct for your own purposes.

                                       Daniel TAUPIN