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