README
1This is a port of GNU Libiconv 1.11 to MSDOS/DJGPP.
2
31.: 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
112.: Installing the binary package.
12 ==============================
13
142.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
233.: Building the binaries from sources.
24 ===================================
25
263.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
443.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
693.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
893.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>
124
README.in
1This is a port of GNU Libcharset @VER@ to MSDOS/DJGPP.
2
31.: 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
112.: Installing the binary package.
12 ==============================
13
142.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
233.: Building the binaries from sources.
24 ===================================
25
263.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
353.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
603.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
643.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
853.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>
121