VDE2RTF ver. 1.3
----------------

Pavel Zampach (zampach@volny.cz), 2004

The program is intended for conversion of texts written in VDE 
editor (mode /D) to RTF. This program is freeware.


History
-------
1.31 small bugs fixed

1.3 ^P[Esc] support
    Enlarged space for user definable switches and toggle (from 31 
    to 63 chars)

1.2 User definable switches and toggle
    Doublestrike and strikeout text
    Bug fixed: improper mark for toggle "underlined"

1.1 Tab handling, work with fonts (alternative and normal pitch)

1.0 First public release


Installation
------------
Copy files VDE2RTF.EXE and VDE2RTFH.TXT into the same directory


Syntax
------
VDE2RTF infile outfile [table]


Converted marks
---------------
  Toggles
Boldface (^PB)
Doublestrike (^PD) (emulated by insertion of non-breaking spaces)
Underline (^PS)
Italics (^PY)
Superscript (^PT)
Subscript (^PV)
User defined toggle (^PU)
Strikeout (^PX)

  Switches
User defined switch 1 (^PQ)
User defined switch 2 (^PW)
User defined switch 3 (^PE)
User defined switch 4 (^PR)
Alternative pitch (^PA)
Normal pitch (^PN)

Formfeed (^PL)
Soft hyphen (^P-)
Hard tabs (^PI)
Esc (^P[Esc]) - insert "\" (backslash) into output RTF file. This 
is intended for "manual" writing RTF control words.

Other printing and formatting marks are omitted.


Font handling
-------------
In the file VDE2RTFH.TXT is defined header for RTF file; in the 
lines 3-7 is font table. On last two lines is set default font for 
document (/f1 is for font#1, Courier New) and it's size (in half 
point, /fs20 is for size 10). You can, of course, modify all these 
values.
The mark "Alternative pitch" (^PA) switches to font#2 (Arial in 
default), "Normal pitch" (^PN) back to font#1.


User definable switches and toggle
----------------------------------
You can define the RTF commands for 4 user switches (^PQ, ^PW, 
^PE, ^PR) and one user toggle (^PU). Definitions are written into 
file VDE2RTFH.TXT and are separated from the header definition by 
one empty line. One definition is on one line, max. 63 characters 
long.
For more information consult the RTF reference 
(http://latex2rtf.sourceforge.net/rtfspec.html)

Line  Switch/toggle
-------------------
1     User defined switch 1 (^PQ)
2     User defined switch 2 (^PW)
3     User defined switch 3 (^PE)
4     User defined switch 4 (^PR)
5     User defined toggle on (^PU)
6     User defined toggle off (^PU)

In the file VDE2RTFH.TX2 are as example next definitions:
^PQ font#2 (Arial), font size 16, bold (f. e. for main titles)
^PW font#2 (Arial), font size 12, bold (f. e. for small titles)
^PE font#3 (Courier), font size 11, normal (f. e. for tables)
^PR font#1 (Times), font size 12, normal (normal text)
^PU toggles on/off red color of text (color#1 and #0 from previous 
defined color table in header)


Character translation
---------------------
In many non-English languages are used different character 
encoding in DOS and Windows. F. e. in Czech is used in DOS Latin2 
(CP852) and in Windows Win-1250 encoding. When you use as third 
parameter the table filename, output character translation is 
enabled.
The table is 256 byte long.

Example:
Desired conversion  chr(160) -> chr(97)
In table is on address 160 value 97.


Content
-------

VDE2RTF.EXE    conversion program
VDE2RTFH.TXT   file with header definition (standard version)
VDE2RTFH.TX1   my header definition (Czech encoding, switches)
VDE2RTFH.TX2   example with user defined switches and toggle
TEST.TXT       VDE file for testing
LAT_1250.2PT   table for conversion CP852->Win1250 (example)
NULL.2PT       table with null conversion as base for modifying
README.TXT     this file
