Return to README.in CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / djgpp

libiconv

    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 (patchlevel 2),
   28:           bshNNNb.zip, gccNNNb.zip, bnuNNNb.zip, makNNNb.zip, filNNNb.zip,
   29:           shlNNNb.zip, txtNNNb.zip, txiNNNb.zip, grepNNNb.zip, sedNNNb.zip,
   30:           and difNNN.zip
   31: 
   32:         NNN represents the latest version number of the binary packages. All
   33:         this packages can be found in the current/v2gnu/ directory of any
   34:         ftp.delorie.com mirror.
   35: 
   36: 3.2.:   Create a temporary directory and copy the source package: licv@packageversion@s.zip
   37:         into the temporary directory. If you download the source distribution
   38:         from one of the DJGPP archives, just unzip it preserving the directory
   39:         structure, runnig ONE of the following commands:
   40:           unzip32 licv@packageversion@s.zip      or
   41:           djtarx licv@packageversion@s.zip       or
   42:           pkunzip -d licv@packageversion@s.zip
   43: 
   44:         Source distributions downloaded from one of the GNU FTP sites need
   45:         some more work to unpack. First, you MUST use the `djtar' program
   46:         to unzip the package. That's because some file names in the official
   47:         distributions need to be changed to avoid problems on the various
   48:         platforms supported by DJGPP. `djtar' can rename files on the fly
   49:         given a file with name mappings. The distribution includes a file
   50:         `djgpp/fnchange.lst' with the necessary mappings. So you need first
   51:         to retrieve that file, and then invoke `djtar' to unpack the
   52:         distribution. Here's how:
   53: 
   54:           djtar -x -p -o @V@/djgpp/fnchange.lst @V@.tar.gz > lst
   55:           djtar -x -n lst @V@.tar.gz
   56: 
   57:         (The name of the distribution archive and the top-level directory will
   58:         be different for versions other than @VER@.)
   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 (iconv.exe iconv.h localcharset.h libconv.a
   77:         libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
   78:         installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
   79:         If you prefer to install into same other directory run the command:
   80:           make install prefix=z:/some/other/dir
   81: 
   82:         Of course, you should replace "z:/some/other/dir" by an appropriate path
   83:         that will meet your requeriments.
   84: 
   85: 3.5.:   If for some reason you want to reconfigure the package cd into the top
   86:         srcdir (libiconv.@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\libiconv.@treeversion@\djgpp\config x:/src/gnu/libiconv.@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\libiconv.@treeversion@\djgpp\config x:/src/gnu/libiconv.@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. Libiconv specific bugs
  117:         must be reported to <bug-gnu-libiconv@gnu.org>.
  118: 
  119: 
  120:           Guerrero, Juan Manuel <juan.guerrero@gmx.de>