54431fc4d0e65383a19e1e6448b3fa716f64b0d9
[bluesky.git] / libs3-1.4 / INSTALL
1
2 To install libs3 on a POSIX system (except Microsoft Windows):
3 --------------------------------------------------------------
4
5 Note that all POSIX builds have prerequisites, such as development libraries
6 that libs3 requires and that must be installed at the time that libs3 is
7 built.  The easiest way to find out what those are, is to run the build
8 command and then observe the results.
9
10 *** For RPM-based systems (Fedora Core, Mandrake, etc) ***
11
12 * rpmbuild -ta <libs3 archive>
13
14 for example:
15
16 rpmbuild -ta libs3-0.3.tar.gz
17
18
19 *** For dpkg-based systems (Debian, Ubuntu, etc) ***
20
21 * make deb
22
23 This will produce a Debian package in the build/pkg directory.
24
25
26 *** For all other systems ***
27
28 * make [DESTDIR=destination root] install
29
30 DESTDIR defaults to /usr
31
32
33 To install libs3 on a Microsoft Windows system:
34 -----------------------------------------------
35
36 *** Using MingW ***
37
38 * libs3 can be built on Windows using the MingW compiler.  No other tool
39   is needed.  However, the following libraries are needed to build libs3:
40
41   - curl development libraries
42   - libxml2 development libraries, and the libraries that it requires:
43     - iconv
44     - zlib
45
46   These projects are independent of libs3, and their release schedule and
47   means of distribution would make it very difficult to provide links to
48   the files to download and keep them up-to-date in this file, so no attempt
49   is made here.
50
51   Development libraries and other files can be placed in:
52   c:\libs3-libs\bin
53   c:\libs3-libs\include
54
55   If the above locations are used, then the GNUmakefile.mingw will work with
56   no special caveats.  If the above locations are not used, then the following
57   environment variables should be set:
58   CURL_LIBS should be set to the MingW compiler flags needed to locate and
59       link in the curl libraries
60   CURL_CFLAGS should be set to the MingW compiler flags needed to locate and
61       include the curl headers
62   LIBXML2_LIBS should be set to the MingW compiler flags needed to locate and
63       link in the libxml2 libraries
64   LIBXML2_CFLAGS should be set to the MingW compiler flags needed to locate and
65       include the libxml2 headers
66
67 * mingw32-make [DESTDIR=destination] -f GNUmakefile.mingw install
68
69 DESTDIR defaults to libs3-<version>
70
71 * DESTDIR can be zipped up into a .zip file for distribution.  For best
72   results, the dependent libraries (curl, openssl, etc) should be included,
73   along with their licenses.