Move to gawk-3.0.1.

7 files changed, 237 insertions, 99 deletions

diff --git a/README_d/README.VMS b/README_d/README.VMS
index 057a359f..40442b14 100644
--- a/README_d/README.VMS
+++ b/README_d/README.VMS
@@ -8,21 +8,20 @@ utility.  From the source directory, use either
 or
  |$ MMS/DECRIPTION=[.VMS]DECSRIP.MMS GAWK
 
-VAX C V3.x  -- use either vmsbuild.com or descrip.mms as is.  These use
-        CC/OPTIMIZE=NOLINE, which is essential for version 3.0.
-VAX C V2.x  -- (version 2.3 or 2.4; older ones won't work); edit either
-        vmsbuild.com or descrip.mms according to the comments in them.
-        For vmsbuild.com, this just entails removing two '!' delimiters.
-        Also edit config.h (which is a copy of file [.config]vms-conf.h)
-        and comment out or delete the two lines ``#define __STDC__ 0''
-        and ``#define VAXC_BUILTINS'' near the end.
-GNU C  -- edit vmsbuild.com or descrip.mms; the changes are different
-        from those for VAX C V2.x, but equally straightforward.  No
-        changes to config.h should be needed.
-DEC C  -- edit vmsbuild.com or descrip.mms according to their comments.
-
-     Tested under VAX/VMS V5.5-2 using VAX C V3.2, GNU C 1.42 and 2.5.0.
-Should work without modifications for VMS V4.6 and up.
+DEC C  -- use either vmsbuild.com or descrip.mms as is.
+VAX C  -- use `@vmsbuild VAXC' or `MMS/MACRO=("VAXC")'.  On a system
+        with both VAX C and DEC C installed where DEC C is the default,
+        use `MMS/MACRO=("VAXC","CC=CC/VAXC")' for the MMS variant; for
+        the vmsbuild.com variant, any need for `/VAXC' will be detected
+        automatically.
+GNU C  -- use `@vmsbuild GNUC' or `MMS/MACRO=("GNUC")'.  On a system
+        where the GCC command is not already defined, use either
+        `@vmsbuild GNUC DO_GNUC_SETUP' or
+        `MMS/MACRO=("GNUC","DO_GNUC_SETUP")'.
+
+     Tested under Alpha/VMS V6.2 using DEC C V5.2 and under VAX/VMS V6.2
+using DEC C V5.2, VAX C 3.2, and GNU C 2.7.1.  GAWK should work without
+modifications for VMS V4.6 and up.
 
 
 Installing GAWK on VMS:
@@ -85,24 +84,20 @@ multi-translation RMS searchlist.
 Building and using GAWK under VMS POSIX:
 
      Ignore the instructions above, although vms/gawk.hlp should still
-be made available in a help library.  Make sure that the two scripts,
-'configure' and 'mungeconf', are executable; use `chmod +x' on them if
-necessary.  Then execute the following two commands:
- |psx> configure vms-posix
- |psx> make PARSER=yacc awktab.c gawk
-The first command will construct files "config.h" and "Makefile" out of
-templates.  The second command will compile and link 'gawk'.  Due to
-a 'make' bug in VMS POSIX 1.0 and V1.1, the file "awktab.c" must be
-given as an explicit target or it will not be built and the final link
-step will fail.  Ignore the warning "Could not find lib m in lib list";
-it is harmless, caused by the Makefile's explicit use of -lm as a linker
-option which is not needed under VMS POSIX.  Under V1.1 (but not V1.0)
-a problem with the yacc skeleton /etc/yyparse.c will cause a compiler
-warning for awktab.c, followed by a linker warning about compilation
-warnings in the resulting object module.  These warnings can be ignored.
-
-     Another 'make' bug interferes with exercising various components
-of the test suite, but all the actual tests should execute correctly.
-(The main exception being book/wordfreq, which gives different results
-due to VMS POSIX 'sort' rather than to 'gawk'.)
+be made available in a help library.  The source tree should be unpacked
+into a container file subsystem rather than into the ordinary VMS file
+system.  Make sure that the two scripts, 'configure' and 'vms/posix-cc.sh',
+are executable; use `chmod +x' on them if necessary.  Then execute the
+following two commands:
+ |psx> CC=vms/posix-cc.sh configure
+ |psx> make CC=c89 gawk
+The first command will construct files "config.h" and "Makefile" out
+of templates, using a script to make the C compiler fit 'configure's
+expectations.  The second command will compile and link 'gawk' using
+the C compiler directly; ignore any warnings from `make' about being
+unable to redefine "CC".  The configure script will take a very long
+time to execute, but at least it provides incremental feedback as it
+runs.
+
+     Tested with VAX/VMS V6.2 + VMS POSIX V2.0 + DEC C V5.2.
 
diff --git a/README_d/README.irix b/README_d/README.irix
new file mode 100644
index 00000000..f69bf347
--- /dev/null
+++ b/README_d/README.irix
@@ -0,0 +1,55 @@
+From: "Kaveh R."  <ghazi@caip.rutgers.edu!>
+Date: Fri, 6 Dec 1996 11:51:27 -0500 (EST)
+To: arnold@skeeve.atl.ga.us
+Subject: Re:  new (and I sure hope final) test release of 3.0.1
+
+	Gawk built everywhere except on irix-4.0.5:
+
+cc -c  -DGAWK -I. -I.. -DHAVE_CONFIG_H ../array.c
+accom: Error: ../protos.h, line 73: One declaration for is non-prototype style,)
+       extern int fprintf () ; 
+       ----------------------^
+accom: Error: ../protos.h, line 73: One declaration for fprintf is non-prototyp)
+       extern int fprintf () ; 
+       ----------------------^
+accom: Error: ../protos.h, line 78: redeclaration of fwrite
+       extern int fwrite();
+       -------------------^
+accom: Error: ../protos.h, line 91: One declaration for is non-prototype style,)
+       extern int sscanf () ;
+       ---------------------^
+accom: Error: ../protos.h, line 91: One declaration for sscanf is non-prototype)
+       extern int sscanf () ;
+       ---------------------^
+accom: Error: ../protos.h, line 126: One declaration for is non-prototype style)
+       extern int        sprintf () ;
+       -----------------------------^
+accom: Error: ../protos.h, line 126: One declaration for sprintf is non-prototy)
+       extern int        sprintf () ;
+       -----------------------------^
+accom: Error: /usr/include/unistd.h, line 96: One declaration for is non-protot)
+       extern int       execl(  char *,   char *, ...);
+       -----------------------------------------------^
+accom: Error: /usr/include/unistd.h, line 96: One declaration for execl is non-)
+       extern int       execl(  char *,   char *, ...);
+       -----------------------------------------------^
+make: *** [array.o] Error 1
+
+
+	The compiler on irix-4.0.5 understands and uses prototypes in
+its headers, but does not define __STDC__.  Since gawk's source code
+prototypes various systems calls and libc functions, without function
+arguments since __STDC__ is not defined, you get these problems.
+
+	I was able to get around it by setting CFLAGS to "-D__STDC__=1".
+Then gawk's source code prototyped functions with arguments, and the above
+errors did not occur.  I wonder why gawk is prototyping system functions.
+
+	Anyway, after using the CFLAGS hack (only necessary on irix-4.0.5)
+all systems built and passed "make check".
+
+		--Kaveh
+--
+Kaveh R. Ghazi				Systems Engineer / Project Leader
+ghazi@caip.rutgers.edu			ICon CMT Corp.
+
diff --git a/README_d/README.pc b/README_d/README.pc
index 875cd53c..07ea334f 100644
--- a/README_d/README.pc
+++ b/README_d/README.pc
@@ -2,17 +2,18 @@ This is the README for GNU awk 3.0 under OS/2 and DOS.
 
     Gawk has been compiled and tested under OS/2 and DOS using the GNU
 development tools from DJ Delorie (DJGPP, DOS-only) and Eberhard Mattes
-(EMX, DOS and OS/2). Microsoft C can be used to build 16-bit versions
+(EMX, DOS and OS/2).  Microsoft C can be used to build 16-bit versions
 for DOS and OS/2.
 
 
 Building gawk
 -------------
 
-Copy the files in the `pc' directory to the directory with the rest of
-the gawk sources. The makefile contains a configuration section with
-comments, and may need to be edited in order to work with your make
-utility.
+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.
 
 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
@@ -20,8 +21,8 @@ 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
-OS/2 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
+OS/2 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".
 
 
@@ -29,9 +30,8 @@ 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 OS/2 GNU make are known to work on "make test"; in particular, the 
-make delivered as part of the DJGPP tools and Ndmake will not work.
+Unix-like tools, including an sh-like shell, sed, cp, and cmp.  Only 
+dmake and GNU make are 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 
@@ -39,9 +39,9 @@ and batch files. See the configuration section of the makefile.
 
 The file test/Makefile will 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. In addition, the files
-in the test directory ending with ".ok" may need to have their
-end-of-line markers converted, as described in Makefile.tst.
+used to modify test/Makefile for your platform.  In addition, some
+files in the test directory may need to have their end-of-line markers
+converted, as described in Makefile.tst.
 
 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
@@ -51,12 +51,44 @@ facility to gawk (and which require sh).
 Notes
 -----
 
-1. An sh-like shell may be useful for awk programming (and is essential
-for running "make test"). Stewartson's sh (OS/2 and DOS) is a good choice:
+1. Collections containing gawk and various utilities for OS/2 or DOS
+include the GNUish Project, Rommel's OS/2 collection at LEO, and the 
+djgpp collection.	
 
-  oak.oakland.edu:SimTel/msdos/sysutil/ms_sh23[bs].zip
-  ftp-os2.cdrom.com:pub/os2/unix/ms_sh23[bs].zip
-  ftp.leo.org:pub/comp/os/os2/shells/ms_sh23b.zip
+The GNUish Project was designed to bring GNU-like programs to small
+systems running OS/2 and DOS.  Binary distributions of gawk are
+maintained in GNUish, and include 16bit OS/2 and DOS versions and a
+djgpp-compiled version.  Information on GNUish is available via
+
+  http://www.simtel.net/simtel.net/
+  http://www.leo.org/pub/comp/platforms/pc/gnuish
+  http://wuarchive.wustl.edu/systems/msdos/gnuish/
+or
+  ftp://ftp.simtel.net/simtelnet/gnu/gnuish
+  ftp://oak.oakland.edu/pub/simtelnet/gnu/gnuish
+  ftp://wuarchive.wustl.edu/systems/msdos/gnuish/
+
+Documentation appears in gnuish.htm (html) or gnuish.inf (info).
+
+Kai Uwe Rommel <rommel@leo.org> maintains a (mostly OS/2) collection at 
+  
+   http://www.leo.org/archiv/os2  or  ftp://ftp.leo.org
+
+It contains emx-compiled (32bit) versions of gawk for OS/2 and DOS,
+along with many OS/2 utilities.
+
+The djgpp collection at 
+
+   http://www.simtel.net/simtelnet/gnu/djgpp
+   ftp://ftp.simtel.net/simtelnet/pub/gnu/djgpp
+
+contains a djgpp-compiled (32bit) version of gawk, along with many
+djgpp-compiled utilities.
+
+
+2.  An sh-like shell may be useful for awk programming (and is essential
+for running "make test").  Stewartson's sh (OS/2 and DOS) is a good 
+choice, and may be found in GNUish.
 
 Stewartson's shell uses a configuration file (see "Command Line Building"
 in the sh manual page), and it may be necessary to edit the entry for 
@@ -70,64 +102,67 @@ gawk. The following entries are suggested:
                            # --but without the use of @-include files.
 
 However, users of djgpp versions of gawk may prefer "dos" over "unix"
-in the above, due to the broken way djgpp handles @-include files.
-Entries for other other utilities (such as sed and wc) may need to be
-edited in order to match your specific collection of programs.
+in the above, due to the way djgpp handles @-include files.  Entries 
+for other other utilities (such as sed and wc) may need to be edited 
+in order to match your specific collection of programs.
 
-The Korn shell (ksh) may be another possibility:
-  
-  ftp-os2.cdrom.com:pub/os2/unix/ksh522rt.zip
-  ftp.leo.org:pub/comp/os/os2/shells/ksh513rt.zip
+As of Fall 1996, Daisuke Aoyama <jack@st.rim.or.jp> has a test version
+of bash (compiled with djgpp).  This version worked flawlessly in
+tests with djgpp gawk and make.  It was added to the djgpp collection
+in Nov-96, and may also be obtained via
 
-Bash (OS/2) should be a good choice; however, there has been some 
-trouble getting a solid version for OS/2. As of Feb-95, there are 
-two bash ports, available in:
+   http://www.st.rim.or.jp/~jack/alpha/
+   http://www.neongenesis.com/~jack/djgpp-work/alpha/
 
-  ftp.leo.org:pub/comp/os/os2/shells/gnu/gnubash.zip
-  ftp.leo.org:pub/comp/os/os2/shells/gnu/bash-112.zip
-  ftp-os2.cdrom.com:pub/os2/unix/bash_112.zip
+Under OS/2, bash should be a good choice; however, there has been some
+trouble getting a solid version.  As of Feb-95, there are two bash ports,
+available at LEO under shells/gnu/.
 
-Hamilton's C Shell is another possibility, available for a number of
-platforms. A demo is available at ftp.leo.org.
+LEO also contains a Korn shell (ksh), tcsh, zsh, and a demo of 
+Hamilton's C shell, but these have not been tested with gawk by the 
+maintainers.  Reports are welcomed.
 
 Users of the emx versions of gawk may wish to set EMXSHELL, which 
-overrides COMSPEC when running shells from emx programs.
+overrides COMSPEC when running shells from emx programs.  Similarly,
+the djgpp version of gawk respects SHELL.
 
-The site ftp.leo.org (ftp.informatik.tu-muenchen.de) is maintained 
-by Kai Uwe Rommel (rommel@ars.de), and is also accessible at 
-http://www.leo.org/archiv/os2/ via WWW.
+Compatibility among shells and various utilities (including gawk)
+continues to be a problem.  Stewartson's shell may be the best choice 
+for emx-compiled programs (although djgpp-bash almost works with 
+emx on DOS).  GNU make is recommended if using djgpp-bash.
 
 
-2. Stewartson's shell contains sources for a setargv-replacement
-for MSC, which can add enhanced command-line processing capabilities
-to gawk. Strongly recommended. See the makefile.
-
-
-3. dmake is by Dennis Vadura (dvadura@watdragon.uwaterloo.ca), CS Dept.,
-University of Waterloo. OS/2 and DOS versions can be found at
+3. GNU make is available at LEO for OS/2 and in the djgpp collection
+for DOS.
 
-  ftp.leo.org:pub/comp/os/os2/devtools/utils/dmake38.zip
-  ftp.leo.org:pub/comp/os/os2/devtools/utils/dmake40os2.zip
-  ftp-os2.cdrom.com:pub/os2/dev16/dmake38x.zip
+dmake is by Dennis Vadura (dvadura@watdragon.uwaterloo.ca), CS
+Dept., University of Waterloo.  OS/2 and DOS versions can be found as
+part of the GNUish project.  Note that DOS users will need the DOS-only
+version (due to the swap requirement).
 
-DOS users will need the DOS-only version (due to the swap requirement):
-
-  oak.oakland.edu:SimTel/msdos/c/dmake38[es].zip
-
-Ndmake is by D.G. Kneller. This ShareWare program was later released
-as Opus Make (which is available for OS/2 and DOS). Ndmake 4.5 is
+Ndmake is by D.G. Kneller.  This ShareWare program was later released
+as Opus Make (which is available for OS/2 and DOS).  Ndmake 4.5 is
 available at
 
-  oak.oakland.edu:SimTel/msdos/c/ndmake45.zip
-
-GNU make is from the FSF. An OS/2 version can be found at
+  ftp://ftp.simtel.net/simtelnet/msdos/c/ndmake45.zip
 
-  ftp.leo.org:pub/comp/os/os2/devtools/gnu/gnumake.zip
 
-For DOS, dmake-3.8 is recommended. The make delivered with djgpp can
-be used on the djgpp target, but will fail on targets with more
-complicated quoting. Makefile compatibility among all the versions
-of OS/2 and DOS gawk has been an ugly problem.
+4. Stewartson's shell contains sources for a setargv-replacement
+for MSC, which can add enhanced command-line processing capabilities
+to gawk.  See the makefile.  Note that there is a fatal bug in 
+stdargv.c, triggered in the case of no closing quote.  The following
+patch treats this case as if a quote was inserted as the last
+character on the command-line.
+
+478,479c478,482
+<               else
+<                   spos = &spos[strlen (cpos)];
+---
+>               else {
+>                   /* No matching quote. Fake it. */
+>                   spos = cpos + strlen (cpos) + 1;
+>                   break;
+>               }
 
 
 Known bugs
@@ -163,9 +198,35 @@ according to Mattes' recommendation:
    tm, just set its tm_isdst to a positive value or to zero, respectively.
    Then, strftime() will replace %Z with the name of the time zone.
 
+However, this probably won't yield a generic solution given that the rules
+for when DST starts and stops vary depending upon your location and the 
+rules have changed over time.  Most versions of UNIX maintain this 
+information in a database (of sorts).  In Solaris, for instance, it can be
+found in /usr/share/zoneinfo/*.  The setting of the TZ environment variable
+(eg. TZ=US/Pacific) is then used to lookup the specifics for that locale.
+
 5. The 16-bit DOS version can exhaust memory on scripts such as Henry
 Spencer's "awf". Use GNU C versions if possible. 
 
+6. builtin.c of gawk-3.0.1 triggers a bug in MSC 6.00A.  The makefile
+works around the bug by compiling builtin.c without optimizations (-Od).
+In limited testing, it appears that inserting some dummy code in 
+builtin.c can provide a better solution than disabling optimizations.
+
+7. The support in djgpp for sh-like shells (as is needed in 
+test/getlnhd.awk) was in development as of Oct-96.  Pre-release 
+versions of the library worked in our tests.  Similarly, the makefiles
+depend on features of djgpp-make which were available only in
+pre-release versions.
+
+The DOS maintainers wish to express their thanks to Eli Zaretskii 
+<eliz@is.elta.co.il> for his work and for the many conversations
+concerning gawk-3.0.1, make, and djgpp.
+
+8. There are problems with system() when using the rsx package with emx
+programs (rsx is used in DPMI environments such as MS-Win).  The djgpp
+versions are preferred in this case.
+
 
 ----
 
diff --git a/README_d/README.sgi b/README_d/README.sgi
index 0d89ad3e..49a5679c 100644
--- a/README_d/README.sgi
+++ b/README_d/README.sgi
@@ -1,10 +1,11 @@
-Sun Dec 31 15:07:11 EST 1995
+Tue Sep 10 08:53:46 EDT 1996
 
-Gawk 3.0 is known to be broken on 64-bit SGI machines running IRIX 6.x.
+Gawk 3.0.x is known to be broken on 64-bit SGI machines running IRIX 6.2.
 
 1) It needs to be compiled with the native cc, not gcc.
 
-2) Even if compiled with the native cc, the gensub and gnu regex tests fail.
+2) Even if compiled with the native cc, the -32 option must be used.
+   If not, the gensub and gnu regex tests fail.
 
 I don't have access to an IRIX 6.x machine, so I am not able to track
 down the problem. If any kind soul is able to run gawk from a debugger
diff --git a/README_d/README.sunos4 b/README_d/README.sunos4
index e1ae900d..ea9a1952 100644
--- a/README_d/README.sunos4
+++ b/README_d/README.sunos4
@@ -6,3 +6,19 @@ generate under SunOS 4.1.x for io.c.
 
 If you send me email about this without having read this file, I will
 fuss at you!
+
+Arnold Robbins
+arnold@gnu.ai.mit.edu
+
+Tue Jan 30 07:01:39 EST 1996
+
+The manyfiles test fails under SunOS 4.1.4.  There appears to be some
+bug in libc (shared and static) for SunOS 4.1.4.  I got a working gawk
+binary by linking in /usr/5lib/libc.a statically.
+
+
+,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,
+     Jim Farrell      | phone 610-940-6020       | Platinum technology
+Systems Administrator | vmail 800-526-9096 x7512 | 620 W. Germantown Pike
+  jwf@platinum.com    | fax   610-940-6021       | Plymouth Meeting,Pa,19462
+'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'`^`'~*-,._.,-*~'
diff --git a/README_d/README.ultrix b/README_d/README.ultrix
index 9c56c250..4943409c 100644
--- a/README_d/README.ultrix
+++ b/README_d/README.ultrix
@@ -18,3 +18,10 @@ these paragraphs to it:
  does the job.  Without the switch gawk will compile and run correctly,
  but you will get complaints about lost optimisations in builtin.c,
  awk.tab.c and regex.c.
+
+From: Arnold Robbins <arnold@math.utah.edu>
+Date: Sun Sep  8 07:05:07 EDT 1996
+
+On Decstations using Ultrix 4.3, the tweakfld test case will fail. It
+appears that routines in the math library return very small but non-zero
+numbers in cases where most other systems return zero.
diff --git a/README_d/README.yacc b/README_d/README.yacc
index 9c5de13a..aa8ee8ef 100644
--- a/README_d/README.yacc
+++ b/README_d/README.yacc
@@ -5,3 +5,6 @@ of the parse stack. This only shows up when gawk is dealing with deeply
 nested control structures, such as those in `awf'.
 
 The problem goes away if you use either bison or Berkeley yacc.
+
+Arnold Robbins
+arnold@gnu.ai.mit.edu