1This is a port of GNU Libiconv 1.11 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 licv111b.zip or 18 djtarx licv111b.zip or 19 pkunzip -d licv111b.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, 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 443.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 693.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 893.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> 124