Return to README.in CVS log

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

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

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