diff options
Diffstat (limited to 'jni/iconv/djgpp/README')
| -rw-r--r-- | jni/iconv/djgpp/README | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/jni/iconv/djgpp/README b/jni/iconv/djgpp/README new file mode 100644 index 0000000..6245667 --- /dev/null +++ b/jni/iconv/djgpp/README @@ -0,0 +1,122 @@ +This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP. + +1.: DJGPP specific changes. + ======================= + There are no DJGPP specific changes. This package should + configure and compile out-of-the-box. + Please read the documentation to become familiar with this + product. + + +2.: Installing the binary package. + ============================== + +2.1.: Copy the binary distribution into the top DJGPP installation + directory and unzip the binary distribution running *ONE* of + the following commands: + unzip32 licv111b.zip or + djtarx licv111b.zip or + pkunzip -d licv111b.zip + + + +3.: Building the binaries from sources. + =================================== + +3.1.: To build the binaries you will need the following binary packages: + djdev203.zip, bsh204b.zip, gcc2952b.zip, + bnu210b.zip, mak3791b.zip, fil316b.zip, + shl112b.zip, txt20b.zip, txi40b.zip, + grep24b.zip and sed302b.zip + + + All this packages can be found in the v2gnu directory of any + Simtel.NET mirror. + You will need bsh204b.zip and *NOT* a prior version or the build will fail. + The same applies to djdev203.zip. You *MUST* use the updated versions of + fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11). This + updated versions have been recompiled with djdev203.zip and know about + the "/dev/env" functionality introduced with djdev203.zip. All the other + packages are the ones I have used to build the binaries from this sources. + Previuos and/or later versions of this packages may do the job as well but + I have not tested this. + +3.2.: Create a temporary directory and copy the source package: licv111s.zip + into the temporary directory. If you download the source distribution + from one of the DJGPP archives, just unzip it preserving the directory + structure, runnig ONE of the following commands: + unzip32 licv111s.zip or + djtarx licv111s.zip or + pkunzip -d licv111s.zip + + Source distributions downloaded from one of the GNU FTP sites need + some more work to unpack. First, you MUST use the `djtar' program to + unzip the package. That's because some file names in the official + distributions need to be changed to avoid problems on the various + platforms supported by DJGPP. `djtar' can rename files on the fly + given a file with name mappings. The distribution includes a file + `djgpp/fnchange.lst' with the necessary mappings. So you need first + to retrieve that file, and then invoke `djtar' to unpack the + distribution. Here's how: + + djtar -x -p -o libiconv-1.7/djgpp/fnchange.lst libiconv-1.7.tar.gz > lst + djtar -x -n lst libiconv-1.7.tar.gz + + (The name of the distribution archive and the top-level directory will + be different for versions other than 1.7.) + +3.3.: The package is preconfigured for djdev203. To build the products you + should run the following command: + make + + After the compilation has finished, you can check the products + running the command: + make check + + To install the products run the command: + make install + + This will install the products (iconv.exe iconv.h localcharset.h libconv.a + libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP + installation tree. As usual, prefix is defined as "/dev/env/DJDIR". + If you prefer to install into same other directory run the command: + make install prefix=z:/some/other/dir + + Of course, you should replace "z:/some/other/dir" by an appropriate path + that will meet your requeriments. + +3.4.: If you need/want to reconfigure the package you will have to run the + following commands: + make distclean + djgpp\config + + Please note that you *MUST* use the "distclean" option or the config.cache + file will *NOT* be deleted. In this case you are *NOT* reconfiguring + because the configuration informations is read from the cache file instead + of being newly computed. + To build the programs in a directory other than where the sources are, + you must add the parameter that specifies the source directory, + e.g: + x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111 + + Lets assume you want to build the binaries in a directory placed on a + different drive (z:\build in this case) from where the sources are, + then you will run the following commands: + z: + md \build + cd \build + x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111 + + You *MUST* use forward slashes to specify the source directory. + After having configured the package run the folowing commands to create + the binaries and docs and install them: + make + make check + make install + + Send suggestions and bug reports concerning the DJGPP port to + comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs + must be reported to Bruno Haible <haible@clisp.cons.org>. + + + Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de> |