summaryrefslogtreecommitdiffstats
path: root/contrib/awk/README
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/awk/README')
-rw-r--r--contrib/awk/README94
1 files changed, 94 insertions, 0 deletions
diff --git a/contrib/awk/README b/contrib/awk/README
new file mode 100644
index 0000000..890b16d
--- /dev/null
+++ b/contrib/awk/README
@@ -0,0 +1,94 @@
+README:
+
+This is GNU Awk 3.0.3. It should be 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.)
+
+Patches 1 through 3 just fix bugs -- see NEWS and ChangeLog for details.
+
+See the file INSTALL for installation instructions.
+
+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, use at least version 2.151 of
+texinfo.tex. There is a usable copy of texinfo.tex in the doc directory.
+
+The Info file now comes with the distribution.
+
+The man page is up to date.
+
+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.
+
+If you have neither bison nor yacc, use the awktab.c file here. It was
+generated with bison, and has no proprietary 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 you have an MS-DOS or OS/2 system, use the stuff in the `pc' directory.
+Similarly, there are separate directories for Ataris, Amigas, and VMS.
+
+Appendix B of The GNU Awk User's Guide discusses configuration in detail. The
+configuration process is now based on Autoconf, so the whole business
+should be considerably simpler than it was in gawk 2.X.Y.
+
+After successful compilation, do 'make check' 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,
+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 a PostScript
+version of the manual.
+
+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.
+
+Arnold Robbins
+INTERNET: arnold@gnu.ai.mit.edu
+
+BUG REPORTS AND FIXES (non-Unix ports):
+
+MS-DOS:
+ Scott Deifik
+ scottd@amgen.com
+
+ Darrel Hankerson
+ hankedr@mail.auburn.edu
+
+VMS:
+ Pat Rankin
+ rankin@eql.caltech.edu
+
+Atari ST:
+ Michal Jaegermann
+ michal@gortel.phys.ualberta.ca
+
+OS/2:
+ Kai Uwe Rommel
+ rommel@ars.de
+
+Amiga:
+ Fred Fish
+ fnf@ninemoons.com
OpenPOWER on IntegriCloud