Annotation of embedaddon/libiconv/djgpp/README.in, revision 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>