RTF2VDE ver. 1.01
-----------------

Pavel Zampach (zampach@volny.cz), 2004

The program is intended for conversion of RTF document to text 
for VDE editor (mode /D). This program is freeware.


History
-------

1.01   faster RTF parsing
1.0    first public release


Syntax
------
RTF2VDE infile outfile [-x] [-l#] [-tFilename] [-uFilename]

infile - input RTF file

outfile - output text file

-x - suppress output of all special characters and print marks. 
The output file is a pure ASCII file without any control 
characters except CR+LF

-l# - line length (default is 64)

-tFilename - loads ANSI->DOS translation table

-uFilename - loads Unicode->ANSI translation table


Character translation
---------------------
In many non-English languages are used different character 
encoding for DOS and ANSI (RTF). F. e. in Czech is used for DOS 
Latin2 (CP852) and for ANSI Win-1250 encoding. When is "-t" 
parameter with the table filename used, output character 
translation is enabled. The character translation is provided 
BEFORE final processing of the character, so you can create the 
translate table for special purposes (suppress some print marks 
etc.). NULL characters (code 0) are not processed.

The table is 256 byte long.

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


Unicode processing
------------------
The program has limited support for Unicode (control words 
"\uN" and "\ucN"). All Unicode characters < 128 are never 
changed. If Unicode table is loaded, translation Unicode->ANSI 
is enabled. Unicode characters in range 128-255 are unchanged 
if they are not find in Unicode table.
The table is a simple text file, where the first is the  
Unicode value (as 4 hex digits), character 5 is space followed 
by ANSI value (as 2 hex digits). If character 7 is "'" 
(apostrophe), character 6 is direct form of ANSI character. See 
example file. The table file MUST be sorted by Unicode value 
(program SORT or similar)!!! Max. file size is 256 lines.


Processed control words
-----------------------
\fonttbl, \colortbl, \stylesheet, \footerr, \footerl, \footerf, 
\footer, \header, \headerr, \headerl, \headerf, \pict, \info' - 
no action, group is skipped

\uc, \u, \par, \sect, \tab, \cell, \bullet, \endash, \emdash, 
\lquote, \rquote, \row, \line, \ldblquote, \rdblquote, \page, 
\ul, \b, \i, \strike, \super, \up, \sub, \dn, \nosupersub, 
\ulnone, \plain


Content
-------
RTF2VDE.EXE    conversion program
1250_LAT.2PT   table for conversion ANSI (Win)1250->CP852
               (example)
UNI1250.TXT    table for conversion Unicode->ANSI (example)
README.TXT     this file


Feedback
--------

Though the program was tested with RTF files (created by Word 
97, WordPad/W95, WordPad/W2k, OpenOffice and AbiWord) success- 
fully, it probably contains bugs.
Please, send your bug reports (together with "troublemaking" 
RTF file), comments and suggestions to zampach@volny.cz
