summaryrefslogtreecommitdiff
path: root/win32/sablot/INSTALL_WIN
blob: b192bc74db40ea63b9a029123907aee7f2d84ae9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
This file describes Sablotron installation procedure on Windows. 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

  2.1. Binaries and dependencies

3. Building Sablotron from sources

  3.1. Notes on dependencies

4. More information





1. Intro

========================================



Sablotron is based on Expat XML parser. 



There is a significant change of how Expat is used since version

0.50. Sablotron _never_ looks for Expat under its own source tree, but

it supposes, that you have installed Expat library (1.95.1 or later) 

in your system.



To get Expat, visit



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



and download/install 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/.

If you download a Windows binary of expat you have to rename it to expat.dll

(without a version number). Ensure expat.dll is on your PATH.



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



2.1. Binaries and dependencies

------------------------------



To support other than built-in charsets you must use the iconv library.

To support JavaScript extensions you must use JS library by Mozilla.

For your convenience, There is a Sablotron binary package available 

supporting both iconv and JavaScript. This package 

(Sablot-Win-x.xx-FullPack.zip) actualy contains three independent products:



- Sablotron binary (linking iconv)

- iconv binary (look at ftp://ftp.ilog.fr/pub/Users/haible/gnu/ for sources)

- JavaScript binary (look at http://www.mozilla.org/js/ for sources)



Copy iconv.dll, js32.exe, 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).



Sablotron can be built with many different options. These options are defined

in sablot_config.msvc file. You can either edit this file or preferably create

its local copy named sablot_config.local. The config file itself is rather

self-decriptive. 



The recommended procedure is the following:



1. copy sablot_config.msvc to sablot_config.local

2. edit sablot_config.local

3. type 'nmake -f makefile.msvc' 



Then install the Sablotron DLL and executable as described in section 2. 

Make sure expat.dll (iconv.dll, js32.dll) are on your PATH (if you link them).





3.1. Notes on dependencies

--------------------------



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.



JavaScript is the popular Netscape-developed object scripting language. 

Sablotron has to link the JS engine to enable extension functions. 

See http://www.mozilla.org/js/ for more details or to get sources.





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