libiconv/djgpp/README.in

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