nexmon – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 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>