1. Overview

This is RTF to HTML converter version 0.1.0.

Copyright (C) 2003 Valentin Lavrinenko, vlavrinenko@users.sourceforge.net

Its primary purpose is using by developers to add rtf to html

converting functionality to their projects, although, end users

can also find it useful.

The main effort was made on processing the tables correctly, and it

seems successful - all other programs I've seen do tables processing

much worse. Moreover, at the moment, I haven't seen any file that

displays correctly in MS Word, but crashes this program.

For further information, go to

http://www.sourceforge.net/projects/rtf2html

2. Copying

Distributed under LGPL license - see COPYING.LESSER, it must be

in the archive.

3. Compiling

- Under UNIX:

Just ./configure && make && make install. The program seems

to work much (about 2 times) faster when compiled with STLPort

STL implementation than with the GNU one. So, you may use

--with-stlport configure option if you have it installed.

- Under MS Windows:

Use MSYS/MinGW, use it the same way as in UNIX.

No makefiles for other Win compilers are included yet, so,

write it yourself, if you want - it isn't that hard.

BCC is no longer supported!

4. Installation

No binary distribution for Unix/Linux is provided - just

compile the program from source (see above). You can, however,

download a binary package for MS Windows from the project page,

http://www.sf.net/projects/rtf2html.

5. Usage

5.1 Command-line options

rtf2html -v|--version

prints the current version.

rtf2html -h|--help

prints the help.

rtf2html [ []].

Converts the file. If either of files is not specified,

the corresponding std descriptor (stdin or stdout) is used.

5.2 Supported features

This version supports the following:

- Character formatting: bold, italic, underline, sub- and superscripts.

NOTE: underlining is displayed only as solid.

- Paragraph formatting: horizontal alignment, indentation, margins.

- Table formatting: arbitrary cell spans, cell sizings, borders,

vertical alignment in cells.

NOTE: borders are displayed correctly only under IE 5+ and only

as solid.

- Page formatting: page width, left margin.

- Hexadecimal character codes (Cyrillic letters would come out in

win1251)

- Font faces and sizes.

- Foreground and background colors, highlighting.

5.3 Unsupported features

This version DOES NOT support the following:

- Character sets.

- Hyperlinks.

- Images.

- Different stuff like macros, embedded OLE objects, etc.

6. Compiling notes.

The source was compiled with

- gcc 3.3 under ALT Linux Master 2.4 on i386

- gcc 3.4.2 (MinGW) under Win2k