Return to README.in CVS log | Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / libcharset / djgpp |
1.1 ! misho 1: This is a port of GNU Libcharset @VER@ 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 lcset@packageversion@b.zip or ! 18: djtarx lcset@packageversion@b.zip or ! 19: pkunzip -d lcset@packageversion@b.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 (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: ! 35: 3.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: ! 60: 3.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: ! 64: 3.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: ! 85: 3.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>