How to install rtfdtohtml
=========================


STEP 1:	Make sure that you have a recent version of perl (version 4 or 5) and
	rtftohtml installed on your system, rtfdtohtml will *not* run without
	it. Version 2.7.5 of rtftohtml works fine (but see the note below),
	newer versions have not yet been tested (all newer versions of
	rtftohtml are distributed as shareware). If you run into problems
	using a different version, get 2.7.5 from an FTP server near you.

	It is not necessary to apply the rtftoweb-patches to rtftohtml,
	they just happen to be in the same directory on the server.

	Note: The standard version (2.7.5) should no longer be used due to
	some serious program bugs. I have made available a specially patched
	version (currently 2.7.5pl1) at the URL mentioned below.

	rtftohtml-2.7.5:
	    ftp://ftp.cso.uiuc.edu/pub/www/tools/translators/rtftoweb/
	    (original version, requires patch file)
	or
	    http://www.inf.uos.de/elmar/projects/rtfdtohtml/
	    (this one already has the patch applied)

	rtftohtml-2.7.5.patch:
	    http://www.inf.uos.de/elmar/projects/rtfdtohtml/


STEP 2:	If you only want to convert RTF files, you can skip this step.

	Processing RTFD files requires some image conversion tools.
	The program will convert EPS and TIFF images for you:

	1. If you are running NeXTSTEP or OPENSTEP, installing eps2tiff is
	   recommended, otherwise ghostscript will do the work.
	   Please use ghostscript version 3 or newer.

	   eps2tiff:
	       ftp://ftp.leo.org/pub/comp/os/NEXTSTEP/graphics/convertors/

	2. TIFF files will be converted with ImageMagick or the netpbm-tools.
	   Installing ImageMagick is strongly recommended, as this is currently
	   the only program that can handle transparent TIFFs correctly.
	   Moreover, the `-png' and `-jpeg' command line options require
	   ImageMagick.

	   You will need:
	   - ImageMagick 3.7.3 or newer, compiled with TIFF, JPEG and PNG
	   - Sam Leffler's TIFF utils that are distributed with libtiff
	     (tiffinfo, tiffcp, tiffsplit)
	   - Willem van Schaik's tiff2png program for TIFF files containing
	     transparency

	   If you cannot use ImageMagick, the latest version of netpbm is
	   required (1-march-1994). NeXTSTEP users may get better quality
	   by using the OmniImageFilter, but netpbm will still be required.
	   If you want to take advantage of OmniImageFilter's capabilities,
	   you should compile the programs `put' and `trafo' from the source
	   code provided in ./pbtools. Simply type:

	       cd pbtools && make put trafo
	   
	   and install the programs anywhere in your path.
	   (Note: The code in ./pbtools is for NeXTSTEP 3.x, not OPENSTEP!)

	   ImageMagick:
	       ftp://ftp.wizards.dupont.com/pub/ImageMagick/

	   libtiff:
	       ftp://ftp.sgi.com/graphics/tiff/

	   tiff2png:
	       ftp://ftp.nde.swri.edu/pub/png/applications/

	       The current version (0.6) cannot correctly handle all black
	       and white images, you have to apply a short patch to make it
	       work. You can find it at the same location as the rtftohtml
	       patch (see the URL mentioned above).

	   netpbm:
	       ftp://ftp.cso.uiuc.edu/pub/X11/contrib/utilities/

	   OmniImageFilter:
	       ftp://ftp.leo.org/pub/comp/os/NEXTSTEP/graphics/filter/


STEP 3: If you are running OPENSTEP and want to use the TextEdit program
	instead of Edit, you may want to install the TextLinker application.
	It will enable you to easily create hypertext links in TextEdit.

	Open the file TextLinker/PB.project in the ProjectBuilder and
	install the application in /LocalApps or ~/Apps. Then run:

	    make_services

	to update the list of available services (or log out and back in).
	This apparently fails sometimes on certain versions of OPENSTEP,
	but I have no idea what to do about that. You can find more info
	on how to use the program in the file doc/TextLinker.


STEP 4:	Run "./configure", then adjust the settings in the Makefile. Read the
	comments there for details. Finally type "make install".

	To test if everything works fine, try to convert "./Example.rtfd"
	using the command:

	    rtfdtohtml -href -blue ./Example.rtfd

	Note: You will get errors if you did not install the image tools.