libiconv/libcharset/djgpp/README.in

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