summaryrefslogtreecommitdiff
path: root/README_d
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2022-08-02 17:08:41 +0300
committerEli Zaretskii <eliz@gnu.org>2022-08-02 17:08:41 +0300
commit381d737cbf4e68586111a9ded7854602b5603c44 (patch)
treee2affc2ed6504784f3b56fd9e4d203d78b56160f /README_d
parentc50d978b64f385979f308b42ca899bd2b8e06153 (diff)
downloadgawk-381d737cbf4e68586111a9ded7854602b5603c44.tar.gz
Update PC-related docs.
Diffstat (limited to 'README_d')
-rw-r--r--README_d/ChangeLog4
-rw-r--r--README_d/README.pc103
2 files changed, 27 insertions, 80 deletions
diff --git a/README_d/ChangeLog b/README_d/ChangeLog
index 4d6c933b..769da6d4 100644
--- a/README_d/ChangeLog
+++ b/README_d/ChangeLog
@@ -1,3 +1,7 @@
+2022-08-02 Eli Zaretskii <eliz@gnu.org>
+
+ * README.pc: Remove references to DOS, DJGPP and OS/2.
+
2022-07-03 Arnold D. Robbins <arnold@skeeve.com>
* README.gcc-3: Deleted.
diff --git a/README_d/README.pc b/README_d/README.pc
index a366c661..45aaaa3c 100644
--- a/README_d/README.pc
+++ b/README_d/README.pc
@@ -1,9 +1,7 @@
This is the README for GNU awk 4 under Windows32, OS/2, and DOS.
- Gawk has been compiled and tested under OS/2, DOS, and Windows32 using
-the GNU development tools from DJ Delorie (DJGPP; DOS with special
-support for long filenames on Windows), and Jan-Jaap van der Heijden and Mumit Khan
-(Mingw32; Windows32).
+ Gawk has been compiled and tested on MS-Windows using
+the MinGW ports of the GNU development tools.
The Cygwin environment (http://cygwin.com) may also be used
to compile and run gawk under Windows. For Cygwin, building and
@@ -15,12 +13,6 @@ installation is the same as under Unix:
The `configure' step takes a long time, but works otherwise.
-******************************** N O T E *******************************
-* The `|&' operator only works when gawk is compiled for Cygwin or for *
-* MinGW. Neither socket support nor two-way pipes work in any other *
-* Windows environment! *
-************************************************************************
-
Building gawk
-------------
@@ -28,23 +20,22 @@ Copy the files in the `pc' directory (EXCEPT for `ChangeLog') to the
directory with the rest of the gawk sources. (The subdirectories of
`pc' need not be copied.) The Makefile contains a configuration
section with comments, and may need to be edited in order to work
-with your make utility. If you are building with MinGW, copy the
-file Makefile.ext to extension/Makefile.
+with your make utility. Also, copy the file Makefile.ext to
+extension/Makefile.
The "prefix" line in the Makefile is used during the install of gawk
-(and in building igawk.bat and igawk.cmd). Since the libraries for
+(and in building igawk.bat and igawk.cmd). Since the libraries for
gawk will be installed under $(prefix)/lib/awk (e.g., /gnu/lib/awk),
it is convenient to have this directory in DEFPATH of config.h.
-The makefile contains a number of targets for building various DOS and
-Windows versions. A list of targets will be printed if the make command is
-given without a target. As an example, to build gawk using the djgpp
-tools, enter "make djgpp".
+The makefile contains a number of targets for building the MS-Windows
+version. A list of targets will be printed if the make command is
+given without a target. As an example, to build gawk using the MinGW
+tools, enter "make mingw32".
-For the MinGW build, after you build in the top-level directory, chdir
-to the extension subdirectory and say "make" there to build the
-extensions. If you built gawk without libmpfr, say this instead to
-build the extensions:
+After you build in the top-level directory, chdir to the extension
+subdirectory and say "make" there to build the extensions. If you
+built gawk without libmpfr, say this instead to build the extensions:
make MPFR= MPFR_LIBS=
@@ -54,33 +45,26 @@ Testing and installing gawk
The command "make test" (and possibly "make install") requires several
Unix-like tools, including an sh-like shell, sed, cp, and cmp. Only
-dmake and GNU make are known to work on "make test".
+GNU make is known to work on "make test".
There are two methods for the install: Method 1 uses a typical Unix-like
approach and requires cat, cp, mkdir, sed, and sh; method 2 uses gawk
and batch files. See the configuration section of the makefile.
-The file test/Makefile may need some editing (especially for DOS). A
-sample makefile with comments appears in pc/Makefile.tst, and can be
-used to modify test/Makefile for your platform. For starters, just
-copy pc/Makefile.tst to test/Makefile, then walk through the variables
+The file test/Makefile may need some editing. A sample makefile with
+comments appears in pc/Makefile.tst, and can be used to modify
+test/Makefile for your platform. For starters, just copy
+pc/Makefile.tst to test/Makefile, then walk through the variables
defined at the beginning and change them as appropriate for your
setup. In addition, some files in the test directory may need to have
their end-of-line markers converted, as described in Makefile.tst.
One change you will have to make for testing the MinGW port using the
MSYS Bash is to set SLASH to //.
-On MinGW, testing Gawk built with MPFR support should report 26 tests
-failed, and if your ls.exe doesn't produce inode numbers consistent
-with the readdir extension, you should see 29 failures. If you see
-more failures, you should investigate the reasons.
-
-As with building gawk, the OS, shell, and long filename issues come into
-play when testing, too. If you are testing gawk on a LFN aware system with
-some LFN aware tools, you may have problems if the shell that you specify in
-test/Makefile is not LFN aware. This problem will apply whether or not
-you are building a LFN aware gawk. See the comments in pc/Makefile.tst
-for more information on this.
+Testing Gawk built with MPFR support should report 28 tests failed, and
+if your ls.exe doesn't produce inode numbers consistent with the readdir
+extension, you should see 31 failures. If you see more failures, you
+should investigate the reasons.
It is routine to install by hand, but note that the install target also
builds igawk.bat and igawk.cmd, which are used to add an include
@@ -90,48 +74,7 @@ facility to gawk (and which require sh).
Gawk thanks
-----------
-The DOS maintainers wish to express their thanks to Eli Zaretskii
-<eliz@gnu.org> for his work and for the many conversations concerning
-gawk, make, and djgpp. His FAQ for djgpp is essential reading, and he
-was always willing to answer our questions (even when we didn't read
-the relevant portions of the FAQ :).
-
We are indebted to Juan Grigera <juan@biophnet.unlp.edu.ar> for
-additional help on changes for Windows32.
-
-
-----
-If you have any problems with the DOS versions of Gawk,
-please send bug reports (along with the version and compiler used) to
-
- Juan Manuel Guerrero, juan.guerrero@gmx.de (DJGPP)
-
-
-Support for Windows32 started in gawk-3.0.3.
-
-----
-From: Eric Pement <eric.pement@gmail.com>
-Newsgroups: comp.lang.awk
-Subject: djgpp Gawk ver. 4.0 available
-Date: Tue, 26 Jul 2011 06:42:00 -0700 (PDT)
-MS Windows users:
-
-The DJGPP compilation of GNU awk v4.0.0 is now available here:
-
- ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/gwk400b.zip
-
-For those who don't know the difference between the DGJPP compile and
-other versions compiled for Windows, the most noticeable to me is that
-it supports Unix-style use of 'single' and "double" quoting. Example:
-
- [c:\tmp]> :: normal Windows awk requires complex quoting
- [c:\tmp]> gawk "BEGIN{ print \"hello, world\" }"
- hello, world
- [c:\tmp]> :: DJGPP compile of awk permits Unix quoting in CMD
- [c:\tmp]> djgawk 'BEGIN{ print "hello, world" }'
- hello, world
-
-Syntactic sugar? Sure. But it makes life easier in a Windows
-environment, and without installing Cygwin ...
+additional help on changes for MS-Windows.
-Eric P.
+Support for MS-Windows started in gawk-3.0.3.