freebsd-dev/contrib/awk
David E. O'Brien 9c23373c4e Tighten up the random seeding a little bit more. getpid() alone only
affect only lower bits of seed which would resulte in the same seed for
sequences of fast-started awk's resulting the same random sequence.

Submitted by:	ache
2001-11-03 02:14:10 +00:00
..
awklib Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
doc Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
extension Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
po Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
posix Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
README_d Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
test Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
acconfig.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
ACKNOWLEDGMENT Virgin import of GNU awk 3.0.3 1997-10-14 18:17:11 +00:00
aclocal.m4 Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
alloca.c Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
array.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
AUTHORS Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
awk.h Well spell it "gnuregex.h". 2001-11-02 21:20:18 +00:00
awk.y Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
awkgram.y I'd put down $10 says the author did a last minute tweak to awkgram.y (which 2001-11-02 23:41:29 +00:00
awktab.c Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
builtin.c Tighten up the random seeding a little bit more. getpid() alone only 2001-11-03 02:14:10 +00:00
ChangeLog Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
configh.in Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
configure Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
configure.in Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
COPYING Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
custom.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
dfa.c Merge revision 1.2 (unspam l10n ranges check) into Gawk 3.1.0. 2001-11-02 21:34:12 +00:00
dfa.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
eval_p.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
eval.c We use the stock 3.1.0 file (other than needing $FreeBSD$). 2001-11-02 21:37:05 +00:00
ext.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
field.c We use the stock 3.1.0 file now. 2001-11-02 21:39:18 +00:00
fixvers Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
FREEBSD-upgrade Describe the process used for the gawk-3.0.6 update in 2000-08-15 14:42:50 +00:00
FUTURES Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
gawkmisc.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
getopt1.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
getopt.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
getopt.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
INSTALL Virgin import of GNU awk 3.0.3 1997-10-14 18:17:11 +00:00
install-sh Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
io.c We use the stock 3.1.0 file. 2001-11-02 21:44:42 +00:00
LIMITATIONS Virgin import of GNU awk 3.0.3 1997-10-14 18:17:11 +00:00
main.c We use the stock version of this file now, but since someone foolishly 2001-11-02 21:57:00 +00:00
Makefile.am Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
Makefile.in Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
mkinstalldirs Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
msg.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
NEWS Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
node.c We use the stock version of this file now, but since someone foolishly 2001-11-02 21:57:00 +00:00
patchlev.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
patchlevel.h Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
PORTS Update vendor branch to gawk-3.0.6. 2000-08-15 10:02:07 +00:00
POSIX.STD Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
PROBLEMS Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
profile_p.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
profile.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
protos.h Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
re.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
README Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
regex.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
replace.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
stamp-h.in Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
version.c Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00
version.in Update vendor branch to gawk-3.1.0. 2001-11-02 21:06:08 +00:00

README:

This is GNU Awk 3.1.0. It is upwardly compatible with the Bell Labs
research version of awk.  It is almost completely compliant with the
1993 POSIX 1003.2 standard for awk. (See the note below about POSIX.)

There are lots of new features -- see NEWS and ChangeLog for details.

Work to be done is described briefly in the FUTURES file.  Changes in this
version are summarized in the NEWS file. Please read the LIMITATIONS file.

Read the file POSIX.STD for a discussion of how the standard says
comparisons should be done vs. how they really should be done and how
gawk does them.

To format the documentation with TeX, use at least version 2000-10-27.17
of texinfo.tex. There is a usable copy of texinfo.tex in the doc directory.

INSTALLATION:

Check whether there is a system-specific README file for your system under
the `README_d' directory.  If there's something there that you should
have read and didn't, and you bug me about it, I'm going to yell at you.

See the file INSTALL for installation instructions.

If you have neither bison nor yacc, use the awkgram.c file here.  It was
generated with bison, and has no proprietary code in it.  (Note that
modifying awkgram.y without bison or yacc will be difficult, at best.
You might want to get a copy of bison from the FSF too.)

If you have a Win32, MS-DOS or OS/2 system, use the stuff in the `pc'
directory.  Similarly, there is a separate directory for VMS.

Ports for the Atari and Tandem are supplied, but they are unsupported.
Thus, their code appears in the `unsupported' directory.

Appendix B of ``GAWK: Effective Awk Programming'' discusses configuration
in detail. The configuration process is based on GNU Autoconf and
Automake.

After successful compilation, do `make check' to run the test suite.
There should be no output from the `cmp' invocations except in the
cases where there are small differences in floating point values, and
possibly in the case of strftime. Several of the tests ignore errors
on purpose; those are not a problem.  If there are other differences,
please investigate and report the problem.

PRINTING THE MANUAL

The `doc' directory contains a recent version of texinfo.tex, which will
be necessary for printing the manual.  Use `make dvi' to get a DVI file
from the manual. In the `doc' directory, use `make postscript' to get
PostScript versions of the manual, the man page, and the reference card.

BUG REPORTS AND FIXES (Un*x systems):

Please coordinate changes through Arnold Robbins. In particular, see
the section in the manual on reporting bugs. Note that comp.lang.awk
is about the worst place to post a gawk bug report. Please, use the
mechanisms outlined in the manual.

Email should be sent to bug-gawk@gnu.org.  This address sends mail to
Arnold Robbins and the general GNU utilities bug list.  The advantage
to using this address is that bug reports are archived at GNU Central.

Arnold Robbins

BUG REPORTS AND FIXES, non-Unix systems:

Amiga:
	Fred Fish
	fnf@ninemoons.com

Alpha/Linux:
	Michal Jaegermann
	michal@gortel.phys.ualberta.ca

BeOS:
	Martin Brown
	mc@whoever.com

MS-DOS:
	Scott Deifik
	scottd@amgen.com

	Darrel Hankerson
	hankedr@mail.auburn.edu

MS-Windows:
	Juan Grigera
	juan@biophnet.unlp.edu.ar

OS/2:
	Kai Uwe Rommel
	rommel@ars.de

Tandem:
	Stephen Davies
	scldad@sdc.com.au

VMS:
	Pat Rankin
	rankin@eql.caltech.edu