mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-30 12:04:07 +00:00
126 lines
4.3 KiB
Plaintext
126 lines
4.3 KiB
Plaintext
README:
|
|
|
|
This is GNU Awk 2.15. It should be upwardly compatible with the System
|
|
V Release 4 awk. It is almost completely compliant with POSIX 1003.2.
|
|
|
|
This release adds new features -- see NEWS for details.
|
|
|
|
See the installation instructions, below.
|
|
|
|
Known problems are given in the PROBLEMS file. Work to be done is
|
|
described briefly in the FUTURES file. Verified ports are listed in
|
|
the PORTS file. Changes in this version are summarized in the NEWS file.
|
|
Please read the LIMITATIONS and ACKNOWLEDGMENT files.
|
|
|
|
Read the file POSIX 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, you must use texinfo.tex 2.53
|
|
or later. Otherwise footnotes look unacceptable.
|
|
|
|
If you wish to remake the Info files, you should use makeinfo. The 2.15
|
|
version of makeinfo works with no errors.
|
|
|
|
The man page is up to date.
|
|
|
|
INSTALLATION:
|
|
|
|
Check whether there is a system-specific README file for your system.
|
|
|
|
A quick overview of the installation process is in the file INSTALL.
|
|
|
|
Makefile.in may need some tailoring. The only changes necessary should
|
|
be to change installation targets or to change compiler flags.
|
|
The changes to make in Makefile.in are commented and should be obvious.
|
|
|
|
All other changes should be made in a config file. Samples for
|
|
various systems are included in the config directory. Starting with
|
|
2.11, our intent has been to make the code conform to standards (ANSI,
|
|
POSIX, SVID, in that order) whenever possible, and to not penalize
|
|
standard conforming systems. We have included substitute versions of
|
|
routines not universally available. Simply add the appropriate define
|
|
for the missing feature(s) on your system.
|
|
|
|
If you have neither bison nor yacc, use the awktab.c file here. It was
|
|
generated with bison, and should have no AT&T code in it. (Note that
|
|
modifying awk.y without bison or yacc will be difficult, at best. You might
|
|
want to get a copy of bison from the FSF too.)
|
|
|
|
If no config file is included for your system, start by copying one
|
|
for a similar system. One way of determining the defines needed is to
|
|
try to load gawk with nothing defined and see what routines are
|
|
unresolved by the loader. This should give you a good idea of how to
|
|
proceed.
|
|
|
|
The next release will use the FSF autoconfig program, so we are no longer
|
|
soliciting new config files.
|
|
|
|
If you have an MS-DOS or OS/2 system, use the stuff in the pc directory.
|
|
For an Atari there is an atari directory and similarly one for VMS.
|
|
|
|
Chapter 16 of The GAWK Manual discusses configuration in detail.
|
|
(However, it does not discuss OS/2 configuration, see README.pc for
|
|
the details. The manual is being massively revised for 2.16.)
|
|
|
|
After successful compilation, do 'make test' to run a small test
|
|
suite. There should be no output from the 'cmp' invocations except in
|
|
the cases where there are small differences in floating point values.
|
|
If there are other differences, please investigate and report the
|
|
problem.
|
|
|
|
PRINTING THE MANUAL
|
|
|
|
The 'support' directory contains texinfo.tex 2.115, which will be necessary
|
|
for printing the manual, and the texindex.c program from the texinfo
|
|
distribution which is also necessary. See the makefile for the steps needed
|
|
to get a DVI file from the manual.
|
|
|
|
CAVEATS
|
|
|
|
The existence of a patchlevel.h file does *N*O*T* imply a commitment on
|
|
our part to issue bug fixes or patches. It is there in case we should
|
|
decide to do so.
|
|
|
|
BUG REPORTS AND FIXES (Un*x systems):
|
|
|
|
Please coordinate changes through David Trueman and/or Arnold Robbins.
|
|
|
|
David Trueman
|
|
Department of Mathematics, Statistics and Computing Science,
|
|
Dalhousie University, Halifax, Nova Scotia, Canada
|
|
|
|
UUCP: {uunet utai watmath}!dalcs!david
|
|
INTERNET: david@cs.dal.ca
|
|
|
|
Arnold Robbins
|
|
1736 Reindeer Drive
|
|
Atlanta, GA, 30329-3528, USA
|
|
|
|
INTERNET: arnold@skeeve.atl.ga.us
|
|
UUCP: { gatech, emory, emoryu1 }!skeeve!arnold
|
|
|
|
BUG REPORTS AND FIXES (non-Unix ports):
|
|
|
|
MS-DOS:
|
|
Scott Deifik
|
|
AMGEN Inc.
|
|
Amgen Center, Bldg.17-Dept.393
|
|
Thousand Oaks, CA 91320-1789
|
|
Tel-805-499-5725 ext.4677
|
|
Fax-805-498-0358
|
|
scottd@amgen.com
|
|
|
|
VMS:
|
|
Pat Rankin
|
|
rankin@eql.caltech.edu (e-mail only)
|
|
|
|
Atari ST:
|
|
Michal Jaegermann
|
|
michal@gortel.phys.ualberta.ca (e-mail only)
|
|
|
|
OS/2:
|
|
Kai Uwe Rommel
|
|
rommel@ars.muc.de (e-mail only)
|
|
Darrel Hankerson
|
|
hankedr@mail.auburn.edu (e-mail only)
|