1This is a port of GNU Libcharset @VER@ to MSDOS/DJGPP.
2
31.:     DJGPP specific changes.
4        =======================
5        There are no DJGPP specific changes. This package should
6        configure and compile out-of-the-box.
7        Please read the documentation to become familiar with this
8        product.
9
10
112.:     Installing the binary package.
12        ==============================
13
142.1.:   Copy the binary distribution into the top DJGPP installation
15        directory and unzip the binary distribution running *ONE* of
16        the following commands:
17          unzip32 lcset@packageversion@b.zip      or
18          djtarx lcset@packageversion@b.zip       or
19          pkunzip -d lcset@packageversion@b.zip
20
21
22
233.:     Building the binaries from sources.
24        ===================================
25
263.1.:   To build the binaries you will need the following binary packages:
27          djdev203.zip (patchlevel 2),
28          bshNNNb.zip, gccNNNb.zip, bnuNNNb.zip, makNNNb.zip, filNNNb.zip,
29          shlNNNb.zip, txtNNNb.zip, txiNNNb.zip, grepNNNb.zip and sedNNNb.zip
30
31        NNN represents the latest version number of the binary packages. All
32        this packages can be found in the current/v2gnu/ directory of any
33        ftp.delorie.com mirror.
34
353.2.:   Create a temporary directory and copy the source package: lcset@packageversion@s.zip
36        into the temporary directory. If you download the source distribution
37        from one of the DJGPP archives, just unzip it preserving the directory
38        structure, runnig ONE of the following commands:
39          unzip32 lcset@packageversion@s.zip      or
40          djtarx lcset@packageversion@s.zip       or
41          pkunzip -d lcset@packageversion@s.zip
42
43        Source distributions downloaded from one of the GNU FTP sites need
44        some more work to unpack. First, you MUST use the `djtar' program
45        to unzip the package. That's because some file names in the official
46        distributions need to be changed to avoid problems on the various
47        platforms supported by DJGPP. `djtar' can rename files on the fly
48        given a file with name mappings. The distribution includes a file
49        `djgpp/fnchange.lst' with the necessary mappings. So you need first
50        to retrieve that file, and then invoke `djtar' to unpack the
51        distribution. Here's how:
52
53          djtar -x -p -o @V@/djgpp/fnchange.lst @V@.tar.gz > lst
54          djtar -x -n lst @V@.tar.gz
55
56        (The name of the distribution archive and the top-level directory will
57        be different for versions other than @VER@.)
58
59
603.3.:   If you have downloaded the source package from one of the GNU FTP sites
61        you will have to configure the package running the command:
62          djgpp\config.bat
63
643.4.:   If you have downloaded the source package from one of the delorie FTP
65        sites the package is already preconfigured for djdev203 or later. In
66        any case, to build the products you must run the following command:
67          make
68
69        After the compilation has finished, you can check the products
70        running the command:
71          make check
72
73        To install the products run the command:
74          make install
75
76        This will install the products (localcharset.h, libcharset.a) into your
77        DJGPP installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
78        If you prefer to install into same other directory, run the command:
79          make install prefix=z:/some/other/dir
80
81        Of course, you should replace "z:/some/other/dir" by an appropriate path
82        that will meet your requeriments.
83
84
853.5.:   If for some reason you want to reconfigure the package cd into the top
86        srcdir (libchset.@treeversion@) and run the following commands:
87          del djgpp\config.cache
88          make distclean
89          djgpp\config
90
91        Please note that you *MUST* delete the config.cache file in the djgpp
92        subdir or you will not really reconfigure the sources because the
93        configuration informations will be read from the cache file instead
94        of being newly computed.
95        To build the programs in a directory other than where the sources are,
96        you must add the parameter that specifies the source directory,
97        e.g:
98          x:\src\gnu\libchset.@treeversion@\djgpp\config x:/src/gnu/libchset.@treeversion@
99
100        Lets assume you want to build the binaries in a directory placed on a 
101        different drive (z:\build in this case) from where the sources are,
102        then you will run the following commands:
103          z:
104          md \build
105          cd \build
106          x:\src\gnu\libchset.@treeversion@\djgpp\config x:/src/gnu/libchset.@treeversion@
107
108        You *MUST* use forward slashes to specify the source directory.
109        After having configured the package run the folowing commands to create
110        the binaries and docs and install them:
111          make
112          make check
113          make install
114
115        Send suggestions and bug reports concerning the DJGPP port to
116        comp.os.msdos.djgpp or djgpp@delorie.com. Libcharset specific
117        bugs must be reported to <bug-gnu-libiconv@gnu.org>.
118
119
120          Guerrero, Juan Manuel <juan.guerrero@gmx.de>
121