This file describes the installation procedure of Sablotron. To find out
more on Sablotron, please read the README file in the same directory 
as this file. To get more info on installing on Linux or Unix, please 
read the file INSTALL.


1. Intro
2. Sablotron binaries
3. Building Sablotron from sources
  3.1. Notes on iconv
4. More information


1. Intro
========================================

Sablotron is based on an excellent XML parser - Expat. 

There is a significant change of how expat is used since version
0.50. Sablotron _never_ builds the expat in the source tree and assumes
expat to be already installed on your system.
                                   
To get Expat, visit

http://sourceforge.net/projects/expat/

and download/install the source/binary package.


2. Sablotron binaries
========================================

Download and extract the binary package. The only requirement is that 
expat.dll must be installed in your system. You can download
the Sablot dll as binary from http://sourceforge.net/projects/expat/.

Copy sablot.dll and sabcmd.exe somewhere to your PATH.


3. Building Sablotron from sources
========================================

If you have downloaded the binary distribution, you can skip reading this
section.

To build Sablotron from sources you have to build expat first. Download
expat sources from http://sourceforge.net/projects/expat/ and build it
(project file for MS DevStudio 6.0 is included).

Then you need two files from the expat distribution: expat.h and expat.lib.
Copy both of them to a directory of your choice (c:\temp\lib, for example).

Extract Sablot sources, go to Sablot-x.xx directory and type

  nmake -f Makefile.nt EXPAT=<ex-path> EXPAT_LIB=<ex-lib-path>

or

  nmake -f Makefile.nt EXPAT=<ex-path> EXPAT_LIB=<ex-lib-path> ICONV=<ic-path>

where
  <ex-path>     is the path to the directory where you installed expat, and
  <ex-lib-path> is the full name of expat.lib  ***relative to <ex-path>***.
  <ic-path>     is the path where iconv is installed [OPTIONAL].

For example,
  nmake -f Makefile.nt EXPAT=c:\temp\expat EXPAT_LIB=lib\Debug\expat.lib
or
  nmake -f Makefile.nt EXPAT=c:\expat-1.95.1 EXPAT_LIB=expat_1_95_1.lib ICONV=\libiconv-1.3

Then install the Sablotron DLL and executable as described in section 2. Make sure expat.dll
and possibly iconv.dll are on your PATH.


3.1. Notes on iconv
-------------------

Iconv is a library for encoding conversions. You don't need to have it installed, but
in that case, you will only be able to use a few encodings. Sablot has been tested on
NT with Bruno Haible's implementation of iconv, available from
  ftp://ftp.ilog.fr/pub/Users/haible/gnu/libiconv-1.3.tar.gz

If you change the way Sablot or iconv are being built, make sure they both use the DLL version
of the C runtime library (msvcrt.dll), i.e. compile with /MD. This is because they need to share
the global variable errno.


4. More information
========================================

If you are in trouble and haven't read the README file, you may find some
useful information there. You can check our website as well: 

http://www.gingerall.com


Enjoy Sablotron!!

GA
