Annotation of embedaddon/libiconv/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.7/djgpp/fnchange.lst libiconv-1.7.tar.gz > lst
! 63: djtar -x -n lst libiconv-1.7.tar.gz
! 64:
! 65: (The name of the distribution archive and the top-level directory will
! 66: be different for versions other than 1.7.)
! 67:
! 68: 3.3.: The package is preconfigured for djdev203. To build the products you
! 69: should run the following command:
! 70: make
! 71:
! 72: After the compilation has finished, you can check the products
! 73: running the command:
! 74: make check
! 75:
! 76: To install the products run the command:
! 77: make install
! 78:
! 79: This will install the products (iconv.exe iconv.h localcharset.h libconv.a
! 80: libcharset.a iconv.1 iconv.3 iconv_open.3 iconv_close.3) into your DJGPP
! 81: installation tree. As usual, prefix is defined as "/dev/env/DJDIR".
! 82: If you prefer to install into same other directory run the command:
! 83: make install prefix=z:/some/other/dir
! 84:
! 85: Of course, you should replace "z:/some/other/dir" by an appropriate path
! 86: that will meet your requeriments.
! 87:
! 88: 3.4.: If you need/want to reconfigure the package you will have to run the
! 89: following commands:
! 90: make distclean
! 91: djgpp\config
! 92:
! 93: Please note that you *MUST* use the "distclean" option or the config.cache
! 94: file will *NOT* be deleted. In this case you are *NOT* reconfiguring
! 95: because the configuration informations is read from the cache file instead
! 96: of being newly computed.
! 97: To build the programs in a directory other than where the sources are,
! 98: you must add the parameter that specifies the source directory,
! 99: e.g:
! 100: x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
! 101:
! 102: Lets assume you want to build the binaries in a directory placed on a
! 103: different drive (z:\build in this case) from where the sources are,
! 104: then you will run the following commands:
! 105: z:
! 106: md \build
! 107: cd \build
! 108: x:\src\gnu\libiconv.111\djgpp\config x:/src/gnu/libiconv.111
! 109:
! 110: You *MUST* use forward slashes to specify the source directory.
! 111: After having configured the package run the folowing commands to create
! 112: the binaries and docs and install them:
! 113: make
! 114: make check
! 115: make install
! 116:
! 117: Send suggestions and bug reports concerning the DJGPP port to
! 118: comp.os.msdos.djgpp or djgpp@delorie.com. Libiconv specific bugs
! 119: must be reported to Bruno Haible <haible@clisp.cons.org>.
! 120:
! 121:
! 122: Guerrero, Juan Manuel <st001906@hrz1.hrz.tu-darmstadt.de>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>