diff options
author | Bruno Haible <bruno@clisp.org> | 2002-01-04 11:31:10 +0000 |
---|---|---|
committer | Bruno Haible <bruno@clisp.org> | 2009-06-22 00:33:00 +0200 |
commit | d2aa1f84263f1d373c2f53848ea4149ec1500e06 (patch) | |
tree | 5c46018d3adf5a0519a11cffe514d2d6ab8259ec /djgpp/README | |
parent | cefae3849cc62c677521bf29bbaa88494bf96f05 (diff) | |
download | external_gettext-d2aa1f84263f1d373c2f53848ea4149ec1500e06.zip external_gettext-d2aa1f84263f1d373c2f53848ea4149ec1500e06.tar.gz external_gettext-d2aa1f84263f1d373c2f53848ea4149ec1500e06.tar.bz2 |
Update.
Diffstat (limited to 'djgpp/README')
-rw-r--r-- | djgpp/README | 176 |
1 files changed, 92 insertions, 84 deletions
diff --git a/djgpp/README b/djgpp/README index 807284a..661a8a8 100644 --- a/djgpp/README +++ b/djgpp/README @@ -1,4 +1,4 @@ -This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. +This is a port of GNU Gettext 0.11-pre5 to MSDOS/DJGPP. TO USE THE GNU GETTEXT LIBRARY YOU **MUST** MODIFY YOUR C-LIBRARY. @@ -34,18 +34,20 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. file the gettext keyword makes **ALWAYS** reference to the GNU gettext function and **NEVER** to the BORLAND-compatibility gettext function. - 2) The binary package gtxt037b.zip contains all needed files to get NLS + 2) The binary package gtxt0.11-pre5b.zip contains all needed files to get NLS support for the following DJGPP ports: bison-1.28 (bsn128s.zip) enscript-1.5.0 (ens150s.zip) enscript-1.6.1 (ens161s.zip) + enscript-1.6.2 (ens162s.zip) fileutils-3.16 (fil316s.zip) + fileutils-4.0 (fil40s.zip) grep-2.4 (grep24s.zip) id-utils-3.2 (idu32s.zip) make-3.79.1 (mak3791s.zip) recode-3.5 (rcode35s.zip) recode-3.6 (rcode36s.zip) - sed-3.02.80 (sed-3.02.80.tar.gz from ftp://alpha.gnu.org/pub/gnu/sed) + sed-3.02.80 (sed3028s.zip) sharutils-4.2c (shar42cs.zip) sh-utils-2.0i (shl20is.zip) sh-utils-2.0j (shl20js.zip) @@ -56,27 +58,27 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. See section #4 for further information about this issue. To implement NLS support for one of those packages you will also need to download the following packages: - gtxt037b.zip (binaries of GNU Gettext 0.10.37) - licv16b.zip (binaries of GNU libiconv 1.6) - fil316b.zip (binaries of GNU Fileutils 3.16 Date: 2000-05-30) - shl112b.zip (binaries of GNU Sh-utils 1.12 Date: 2000-08-11) + gtxt0.11-pre5b.zip (binaries of GNU Gettext 0.11-pre5) + licv17b.zip (binaries of GNU libiconv 1.7) + fil40b.zip (binaries of GNU Fileutils 4.0) + shl112b.zip (binaries of GNU Sh-utils 1.12 Date: 2000-08-11) 2.: Installing the binary package. ============================== -2.1.: To use this binary package you **MUST** install licv16b.zip or later - first. licv16b.zip provides the required functionality to recode the - .mo files on-the-fly from the unix charsets used to create them to the +2.1.: To use this binary package you **MUST** install licv17b.zip or later + first. licv17b.zip provides the required functionality to recode the + .mo files at run time from the unix charsets used to create them to the dos codepages used to display them. Copy the binary distribution into the top DJGPP installation directory. If you are installing Gettext on - a dual DOS/WINDOWS 9X systems, you should first turn off the generation + a dual DOS/WINDOWS 9X systems, you *MUST* first turn off the generation of numeric tails for 8.3 aliases Windows creats for long file names. For information about how to do this, please read the DJGPP FAQ List V 2.30, chapter 22.19: "How to Set Up a Dual DOS/Windows Installation". It should be noticed that neither the libintl.a library nor the binaries (xgettext.exe, gettext.exe, etc.) contain any code to handle - nuneric tails in short file names. This implies that if you install + nuneric tails of short file names. This implies that if you install the binary packages in a DOS box of Win9X (LFN) **WITHOUT** turning off the numeric tail generation you will **NOT** be able to use NLS on plain DOS. Once again: if you want NLS support on both Win9X **AND** @@ -89,38 +91,17 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. will **NOT** be able to find their .mo files (translations) when you switch to plain DOS. -2.2.: If you download the source distribution from one of the DJGPP archives, +2.2.: Copy the binary distribution into the top DJGPP installation directory, just unzip it preserving the directory structure running *ONE* of the following commands: - unzip32 gtxt037b.zip or - djtarx gtxt037b.zip or - pkunzip -d gtxt037b.zip - - Source distributions downloaded from one of the GNU FTP sites need - some more work to unpack. First, you *MUST* use the `djtar' program - to unzip the package. That's because some file names in the official - distributions need to be changed to avoid problems on the various - platforms supported by DJGPP. `djtar' can rename files on the fly - given a file with name mappings. The distribution includes a file - `djgpp/fnchange.lst' with the necessary mappings. So you need first - to retrieve that file, and then invoke `djtar' to unpack the - distribution. Here's how: - - djtar -x -p -o gettext-0.10.37/djgpp/fnchange.lst gettext-0.10.37.tar.gz > lst - djtar -x -n lst gettext-0.10.37.tar.gz - - (The name of the distribution archive and the top-level directory will - be different for versions other than 0.10.37.) - - It is always recommended to download the DJGPP packages from some - Simtel.NET mirror and *not* the original GNU distribution because - only the binary distribution of the DJGPP port will contain the - files needed to patch libc.a. This are: conio.h and conio.o. + unzip32 gtxt0.11-pre5b.zip or + djtarx gtxt0.11-pre5b.zip or + pkunzip -d gtxt0.11-pre5b.zip 2.3.: Changing libc.a and conio.h. Apart from the ussual directories, the binary package will create the following directory: - %DJDIR%/gnu/gtxt-010.37/djgpp/djdev-2.03 + %DJDIR%/gnu/gtxt-011-pre5/djgpp/djdev-2.03 where %DJDIR% stands for the root of your DJGPP installation tree. Cd into the djdev-2.03 directory. You will find the following files: conio.diffs @@ -133,29 +114,27 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. conio.o contained in libc.a. For all commands that will follow now I will assume that you have - cd'ed into the %DJDIR%/gnu/gtxt-010.37/djgpp/djdev-2.03 directory. - First, you should backup your old header and library. For this task, - run the commands: - copy %DJDIR%\include\conio.h %DJDIR%\include\conio.bak - copy %DJDIR%\lib\libc.a %DJDIR%\lib\libc.bak - Substitute %DJDIR% by the path to your DJGPP installation. + cd'ed into the %DJDIR%/gnu/gtxt-011-pre5/djgpp/djdev-2.03 directory, + where %DJDIR% represents the path to your DJGPP installation. First, + you should backup your old header and library. For this task, run the + following command sequence (cp is the copy program from fil40b.zip): + cp /dev/env/DJDIR/include/conio.h /dev/env/DJDIR/include/conio.bak + cp /dev/env/DJDIR/lib/libc.a /dev/env/DJDIR/lib/libc.bak Now you can copy the new header into your include directory running the command: - copy conio.h %DJDIR%\include - Substitute %DJDIR% by the path to your DJGPP installation. + cp conio.h /dev/env/DJDIR/include Now you can substitute the old conio.o file in libc.a with the new one. For this task you will need the ar program from binutils. Run the command: - ar -rv %DJDIR%\lib\libc.a conio.o - Substitute %DJDIR% by the path to your DJGPP installation. + ar -rv /dev/env/DJDIR/lib/libc.a conio.o You are done. -2.4.: Edit the djgpp.env file which is located in the top DJGPP - installation directory. Move to the first or global part - of your djgpp.env. The global part of your djgpp.env is - everything *BEFORE* the *FIRST* line that looks like: +2.4.: Edit the djgpp.env file which is located in the top DJGPP installation + directory. Move to the first or global part of your djgpp.env. + The global part of your djgpp.env is everything *BEFORE* the *FIRST* + line that looks like: [xxxx] where xxxx stands for the name of some DJGPP binary (usually this is bison). Add the following line to the first part of your djgpp.env: @@ -196,7 +175,7 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. +LANGUAGE=de:es Please note that if you omit the LANG environment variable, the - LANGUAGE variable will not be honuored at all. The LANG varaiable must + LANGUAGE variable will not be honored at all. The LANG varaiable must always be set to your default catalog. With the aid of LANGUAGE you can select other catalogs apart of the default one. If for some reason you want to disable NLS, then you should comment out the LANG variable or @@ -223,42 +202,69 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. =================================== 3.1.: To build the binaries you will need the following binary packages: - djdev203.zip (NOT a prior version) - bsh203b.zip (NOT a prior version) - gcc2952b.zip, bnu2951b.zip, mak3791b.zip, - fil316b.zip, shl112b.zip, txt20b.zip, + djdev203.zip (or a later but NOT a prior version) + bsh203b.zip (or a later but NOT a prior version) + gcc2953b.zip, bnu2112b.zip, mak3791b.zip, + fil40b.zip, shl112b.zip, txt20b.zip, txi40b.zip, grep24b.zip, sed302b.zip, - licv16b.zip + licv17b.zip If you want to run the check you will need also: dif272b.zip + If you want to recreate the html docs you will also need: + gro116b.zip (or a later but NOT a prior version) + perl561b.zip (or a later but NOT a prior version) + All this packages can be found in the v2gnu directory of any Simtel.NET mirror. - You must have licv16b.zip installed before configuring or compiling the - package or the configuration and build process will fail due to unresolved - references to libiconv.a - You will need bsh203b.zip and *NOT* a prior version or the build will fail. - The same applies to djdev203.zip. You *MUST* use the updated version of - fil316b.zip (date: 2000-05-30) and shl112b.zip (date: 2000-08-11). + You must have licv17b.zip or a later version installed before + configuring or compiling the package or the configuration and build + process will fail due to unresolved references to libiconv.a + You will need bsh203b.zip or later and *NOT* a prior version or the + build will fail. The same applies to djdev203.zip. You *MUST* use the + updated version of shl112b.zip (date: 2000-08-11). This updated versions have been recompiled with djdev203.zip and know about the "/dev/env" functionality introduced with djdev203.zip. All the other packages are the ones I have used to build the binaries from this sources. Previuos versions of this packages may do the job as well but I have not tested this. -3.2.: Create a temporary directory. Copy the source package: gtxt037s.zip - into the directory and unzip it runnig ONE of the following commands: - unzip32 gtxt037s.zip or - djtarx gtxt037s.zip or - pkunzip -d gtxt037s.zip +3.2.: Create a temporary directory and copy the source package into the + directory. If you download the source distribution from one of the + DJGPP archives, just unzip it preserving the directory structure + running *ONE* of the following commands: + unzip32 gtxt0.11-pre5s.zip or + djtarx gtxt0.11-pre5s.zip or + pkunzip -d gtxt0.11-pre5s.zip + + Source distributions downloaded from one of the GNU FTP sites need + some more work to unpack. First, you *MUST* use the `djtar' program + to unzip the package. That is because some file names in the official + distributions need to be changed to avoid problems on the various + platforms supported by DJGPP. `djtar' can rename files on the fly given + a file with name mappings. The distribution includes a file + `djgpp/fnchange.lst' with the necessary mappings. So you need first + to retrieve that file, and then invoke `djtar' to unpack the + distribution. Here is how: + + djtar -x -p -o gettext-0.11-pre5/djgpp/fnchange.lst gettext-0.11-pre5.tar.gz > lst + djtar -x -n lst gettext-0.11-pre5.tar.gz + + (The name of the distribution archive and the top-level directory will + be different for versions other than 0.11-pre5.) + + It is always recommended to download the DJGPP packages from some + Simtel.NET mirror and *NOT* the original GNU distribution because + only the binary distribution of the DJGPP port will contain the + files needed to patch libc.a. This are: conio.h and conio.o. -3.3.: This package is preconfigured for NLS support and for on-the-fly - recoding with the functionality provided by libiconv.a from licv16b.zip. - This implies that licv16b.zip *MUST* be installed *before* you try to +3.3.: This package is preconfigured for NLS support and for run time recoding + due to the functionality provided by libiconv.a from licv17b.zip. + This implies that licv17b.zip *MUST* be installed *before* you try to compile the package or the build process will fail. It should be noticed that when you compile your own binaries with NLS - you must *always* link with libiconv.a + you must also *always* link with libiconv.a If you compile this package with a later version of libc.a or if you prefer no NLS support at all you will have to reconfigure this package. The configuration batch file of this package, located in the djgpp @@ -271,7 +277,7 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. no-NLS If for some reason you want no NLS support you will have to reconfigure - the package. For this purpose cd into the top srcdir (gtxt-010.37) + the package. For this purpose cd into the top srcdir (gtxt-011-pre5) and run the following commands: make distclean djgpp\config no-NLS @@ -285,14 +291,14 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. To build the programs in a directory other than where the sources are, you must add a parameter that specifies the source directory, e.g: - x:\src\gnu\gtxt-010.37\djgpp\config x:/src/gnu/gtxt-010.37 no-NLS + x:\src\gnu\gtxt-011-pre5\djgpp\config x:/src/gnu/gtxt-011-pre5 no-NLS Lets assume you want to build the binaries in a directory placed on a different drive (z:\build in this case) from where the sources are, then you will run the following commands: z: cd \build - x:\src\gnu\gtxt-010.37\djgpp\config x:/src/gnu/gtxt-010.37 no-NLS + x:\src\gnu\gtxt-011-pre5\djgpp\config x:/src/gnu/gtxt-011-pre5 no-NLS If you want NLS support you will omit "no-NLS" or replace it by "NLS" in the above examples. @@ -336,13 +342,15 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. bison-1.28 (bsn128s.zip) enscript-1.5.0 (ens150s.zip) enscript-1.6.1 (ens161s.zip) + enscript-1.6.2 (ens162s.zip) fileutils-3.16 (fil316s.zip) + fileutils-4.0 (fil40s.zip) grep-2.4 (grep24s.zip) id-utils-3.2 (idu32s.zip) make-3.79.1 (mak3791s.zip) recode-3.5 (rcode35s.zip) recode-3.6 (rcode36s.zip) - sed-3.02.80 (sed-3.02.80.tar.gz from ftp://alpha.gnu.org/pub/gnu/sed) + sed-3.02.80 (sed3028s.zip) sharutils-4.2c (shar42cs.zip) sh-utils-2.0i (shl20is.zip) sh-utils-2.0j (shl20js.zip) @@ -361,12 +369,12 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. be replaced. 4.1.: To reconfigure and recompile a source package with NLS support you - *MUST* install the gtxt037b.zip and licv16b.zip packages + *MUST* install the gtxt0.11-pre5b.zip and licv17b.zip packages first. NLS support will **NOT** work with any prior version of the above - mentioned packages. Before installing gtxt037b.zip and licv16b.zip + mentioned packages. Before installing gtxt0.11-pre5b.zip and licv17b.zip you *MUST* deinstall the old packages if you ever have installed them. For this purpose use the provided manifest files from the old packages. - Old packages means previous beta releases of gtxt037b.zip and licv16b.zip + Old packages means previous beta releases of gtxt0.11-pre5b.zip and licv17b.zip *AND* also previous versions of gettext like gettext 0.10.32, etc. 4.2.: We will assume that the required sources will be unzipped into @@ -377,8 +385,8 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. This will create the directory: /src/gnu/bison-1.28 - The binary package gtxt037b.zip will create the directory: - %DJDIR%/gnu/gtxt-010.37/djgpp/NLS_for_djgpp_packages/bison-1.28 + The binary package gtxt0.11-pre5b.zip will create the directory: + %DJDIR%/gnu/gtxt-011-pre5/djgpp/NLS_for_djgpp_packages/bison-1.28 This directory contains all needed files. The files are: bison-1.28/djconfig.bat (new .bat file that replaces the original one.) @@ -388,7 +396,7 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. Now we will xcopy the needed files into the original bison-1.28 directory. First we will cd into the bison-1.28 directory and then we will run the following command: - xcopy %DJDIR%\gnu\gtxt-010.37\djgpp\NLS_for_djgpp_packages\bison-1.28 /v/s/e + xcopy %DJDIR%\gnu\gtxt-011-pre5\djgpp\NLS_for_djgpp_packages\bison-1.28 /v/s/e 4.3.: Before the package can be reconfigured, the old configuration must be cleared. Run the command: @@ -425,7 +433,7 @@ This is a port of GNU Gettext 0.10.37 to MSDOS/DJGPP. Please refer to 2.4. - Send GNU gettext specific bug reports to <bug-gnu-utils@gnu.org>. + Send GNU gettext specific bug reports to <bug-gnu-gettext@gnu.org>. Send suggestions and bug reports concerning the DJGPP port to comp.os.msdos.djgpp or <djgpp@delorie.com>. |