Return to README CVS log | Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / libcharset / djgpp |
1.1 ! misho 1: This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP. ! 2: ! 3: 1.: 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: ! 11: 2.: Installing the binary package. ! 12: ============================== ! 13: ! 14: 2.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 licv111b.zip or ! 18: djtarx licv111b.zip or ! 19: pkunzip -d licv111b.zip ! 20: ! 21: ! 22: ! 23: 3.: Building the binaries from sources. ! 24: =================================== ! 25: ! 26: 3.1.: To build the binaries you will need the following binary packages: ! 27: djdev203.zip, bsh204b.zip, gcc2952b.zip, ! 28: bnu210b.zip, mak3791b.zip, fil316b.zip, ! 29: shl112b.zip, txt20b.zip, txi40b.zip, ! 30: grep24b.zip and sed302b.zip ! 31: ! 32: ! 33: All this packages can be found in the v2gnu directory of any ! 34: Simtel.NET mirror. ! 35: You will need bsh204b.zip and *NOT* a prior version or the build will fail. ! 36: The same applies to djdev203.zip. You *MUST* use the updated versions of ! 37: fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11). This ! 38: updated versions have been recompiled with djdev203.zip and know about ! 39: the "/dev/env" functionality introduced with djdev203.zip. All the other ! 40: packages are the ones I have used to build the binaries from this sources. ! 41: Previuos and/or later versions of this packages may do the job as well but ! 42: I have not tested this. ! 43: ! 44: 3.2.: Create a temporary directory and copy the source package: licv111s.zip ! 45: into the temporary directory. If you download the source distribution ! 46: from one of the DJGPP archives, just unzip it preserving the directory ! 47: structure, runnig ONE of the following commands: ! 48: unzip32 licv111s.zip or ! 49: djtarx licv111s.zip or ! 50: pkunzip -d licv111s.zip ! 51: ! 52: Source distributions downloaded from one of the GNU FTP sites need ! 53: some more work to unpack. First, you MUST use the `djtar' program to ! 54: unzip the package. That's because some file names in the official ! 55: distributions need to be changed to avoid problems on the various ! 56: platforms supported by DJGPP. `djtar' can rename files on the fly ! 57: given a file with name mappings. The distribution includes a file ! 58: `djgpp/fnchange.lst' with the necessary mappings. So you need first ! 59: to retrieve that file, and then invoke `djtar' to unpack the ! 60: distribution. Here's how: ! 61: ! 62: djtar -x -p -o libiconv-1.11/djgpp/fnchange.lst libiconv-1.11.tar.gz > lst ! 63: djtar -x -n lst libiconv-1.11.tar.gz ! 64: ! 65: (The name of the distribution archive and the top-level directory will ! 66: be different for versions other than 1.11.) ! 67: ! 68: ! 69: 3.3.: The package is preconfigured for djdev203. To build the products you ! 70: should run the following command: ! 71: make ! 72: ! 73: After the compilation has finished, you can check the products ! 74: running the command: ! 75: make check ! 76: ! 77: To install the products run the command: ! 78: make install ! 79: ! 80: This will install the products (iconv.exe iconv.h localcharset.h libconv.a ! 81: libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP ! 82: installation tree. As usual, prefix is defined as "/dev/env/DJDIR". ! 83: If you prefer to install into same other directory run the command: ! 84: make install prefix=z:/some/other/dir ! 85: ! 86: Of course, you should replace "z:/some/other/dir" by an appropriate path ! 87: that will meet your requeriments. ! 88: ! 89: 3.4.: If you need/want to reconfigure the package you will have to run the ! 90: following commands: ! 91: make distclean ! 92: djgpp\config ! 93: ! 94: Please note that you *MUST* use the "distclean" option or the config.cache ! 95: file will *NOT* be deleted. In this case you are *NOT* reconfiguring ! 96: because the configuration informations is read from the cache file instead ! 97: of being newly computed. ! 98: To build the programs in a directory other than where the sources are, ! 99: you must add the parameter that specifies the source directory, ! 100: e.g: ! 101: x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16 ! 102: ! 103: Lets assume you want to build the binaries in a directory placed on a ! 104: different drive (z:\build in this case) from where the sources are, ! 105: then you will run the following commands: ! 106: z: ! 107: md \build ! 108: cd \build ! 109: x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16 ! 110: ! 111: You *MUST* use forward slashes to specify the source directory. ! 112: After having configured the package run the folowing commands to create ! 113: the binaries and docs and install them: ! 114: make ! 115: make check ! 116: make install ! 117: ! 118: Send suggestions and bug reports concerning the DJGPP port to ! 119: comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs ! 120: must be reported to Bruno Haible <haible@clisp.cons.org>. ! 121: ! 122: ! 123: Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>