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>