Annotation of embedaddon/libiconv/libcharset/djgpp/README, revision 1.1
1.1 ! misho 1: This is a port of GNU Libiconv 1.11 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 licv111b.zip or
! 18: djtarx licv111b.zip or
! 19: pkunzip -d licv111b.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, bsh204b.zip, gcc2952b.zip,
! 28: bnu210b.zip, mak3791b.zip, fil316b.zip,
! 29: shl112b.zip, txt20b.zip, txi40b.zip,
! 30: grep24b.zip and sed302b.zip
! 31:
! 32:
! 33: All this packages can be found in the v2gnu directory of any
! 34: Simtel.NET mirror.
! 35: You will need bsh204b.zip and *NOT* a prior version or the build will fail.
! 36: The same applies to djdev203.zip. You *MUST* use the updated versions of
! 37: fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11). This
! 38: updated versions have been recompiled with djdev203.zip and know about
! 39: the "/dev/env" functionality introduced with djdev203.zip. All the other
! 40: packages are the ones I have used to build the binaries from this sources.
! 41: Previuos and/or later versions of this packages may do the job as well but
! 42: I have not tested this.
! 43:
! 44: 3.2.: Create a temporary directory and copy the source package: licv111s.zip
! 45: into the temporary directory. If you download the source distribution
! 46: from one of the DJGPP archives, just unzip it preserving the directory
! 47: structure, runnig ONE of the following commands:
! 48: unzip32 licv111s.zip or
! 49: djtarx licv111s.zip or
! 50: pkunzip -d licv111s.zip
! 51:
! 52: Source distributions downloaded from one of the GNU FTP sites need
! 53: some more work to unpack. First, you MUST use the `djtar' program to
! 54: unzip the package. That's because some file names in the official
! 55: distributions need to be changed to avoid problems on the various
! 56: platforms supported by DJGPP. `djtar' can rename files on the fly
! 57: given a file with name mappings. The distribution includes a file
! 58: `djgpp/fnchange.lst' with the necessary mappings. So you need first
! 59: to retrieve that file, and then invoke `djtar' to unpack the
! 60: distribution. Here's how:
! 61:
! 62: djtar -x -p -o libiconv-1.11/djgpp/fnchange.lst libiconv-1.11.tar.gz > lst
! 63: djtar -x -n lst libiconv-1.11.tar.gz
! 64:
! 65: (The name of the distribution archive and the top-level directory will
! 66: be different for versions other than 1.11.)
! 67:
! 68:
! 69: 3.3.: The package is preconfigured for djdev203. To build the products you
! 70: should run the following command:
! 71: make
! 72:
! 73: After the compilation has finished, you can check the products
! 74: running the command:
! 75: make check
! 76:
! 77: To install the products run the command:
! 78: make install
! 79:
! 80: This will install the products (iconv.exe iconv.h localcharset.h libconv.a
! 81: libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
! 82: installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
! 83: If you prefer to install into same other directory run the command:
! 84: make install prefix=z:/some/other/dir
! 85:
! 86: Of course, you should replace "z:/some/other/dir" by an appropriate path
! 87: that will meet your requeriments.
! 88:
! 89: 3.4.: If you need/want to reconfigure the package you will have to run the
! 90: following commands:
! 91: make distclean
! 92: djgpp\config
! 93:
! 94: Please note that you *MUST* use the "distclean" option or the config.cache
! 95: file will *NOT* be deleted. In this case you are *NOT* reconfiguring
! 96: because the configuration informations is read from the cache file instead
! 97: of being newly computed.
! 98: To build the programs in a directory other than where the sources are,
! 99: you must add the parameter that specifies the source directory,
! 100: e.g:
! 101: x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16
! 102:
! 103: Lets assume you want to build the binaries in a directory placed on a
! 104: different drive (z:\build in this case) from where the sources are,
! 105: then you will run the following commands:
! 106: z:
! 107: md \build
! 108: cd \build
! 109: x:\src\gnu\libiconv.16\djgpp\config x:/src/gnu/libiconv.16
! 110:
! 111: You *MUST* use forward slashes to specify the source directory.
! 112: After having configured the package run the folowing commands to create
! 113: the binaries and docs and install them:
! 114: make
! 115: make check
! 116: make install
! 117:
! 118: Send suggestions and bug reports concerning the DJGPP port to
! 119: comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs
! 120: must be reported to Bruno Haible <haible@clisp.cons.org>.
! 121:
! 122:
! 123: Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>