Annotation of embedaddon/libiconv/djgpp/README.in, revision 1.1.1.1

1.1       misho       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>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>