home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / gnuawk.zip / README < prev    next >
Text File  |  1997-05-01  |  3KB  |  95 lines
  1. README:
  2.  
  3. This is GNU Awk 3.0.3. It should be upwardly compatible with the Bell
  4. Labs research version of awk.  It is almost completely compliant with
  5. the 1993 POSIX 1003.2 standard for awk. (See the note below about POSIX.)
  6.  
  7. Patches 1 through 3 just fix bugs -- see NEWS and ChangeLog for details.
  8.  
  9. See the file INSTALL for installation instructions.
  10.  
  11. Known problems are given in the PROBLEMS file.  Work to be done is
  12. described briefly in the FUTURES file.  Verified ports are listed in
  13. the PORTS file.  Changes in this version are summarized in the NEWS file.
  14. Please read the LIMITATIONS and ACKNOWLEDGMENT files.
  15.  
  16. Read the file POSIX for a discussion of how the standard says comparisons
  17. should be done vs. how they really should be done and how gawk does them.
  18.   
  19. To format the documentation with TeX, use at least version 2.151 of
  20. texinfo.tex. There is a usable copy of texinfo.tex in the doc directory.
  21.  
  22. The Info file now comes with the distribution.
  23.  
  24. The man page is up to date.
  25.  
  26. INSTALLATION:
  27.  
  28. Check whether there is a system-specific README file for your system
  29. under the `README_d' directory.  If there's something there that you
  30. should have read and didn't, and you bug me about it, I'm going to yell
  31. at you.
  32.  
  33. See the file INSTALL.
  34.  
  35. If you have neither bison nor yacc, use the awktab.c file here.  It was
  36. generated with bison, and has no proprietary code in it.  (Note that modifying
  37. awk.y without bison or yacc will be difficult, at best.  You might want
  38. to get a copy of bison from the FSF too.)
  39.   
  40. If you have an MS-DOS or OS/2 system, use the stuff in the `pc' directory.
  41. Similarly, there are separate directories for Ataris, Amigas, and VMS.
  42.  
  43. Appendix B of The GNU Awk User's Guide discusses configuration in detail. The
  44. configuration process is now based on Autoconf, so the whole business
  45. should be considerably simpler than it was in gawk 2.X.Y.
  46.  
  47. After successful compilation, do 'make check' to run a small test
  48. suite.  There should be no output from the 'cmp' invocations except in
  49. the cases where there are small differences in floating point values,
  50. and possibly in the case of strftime. Several of the tests ignore
  51. errors on purpose; those are not a problem.  If there are other
  52. differences, please investigate and report the problem.
  53.  
  54. PRINTING THE MANUAL
  55.  
  56. The 'doc' directory contains a recent version of texinfo.tex, which will be
  57. necessary for printing the manual.  Use `make dvi' to get a DVI file from
  58. the manual. In the `doc' directory, use `make postscript' to get a PostScript
  59. version of the manual.
  60.  
  61. BUG REPORTS AND FIXES (Un*x systems):
  62.  
  63. Please coordinate changes through Arnold Robbins. In particular, see
  64. the section in the manual on reporting bugs. Note that comp.lang.awk is
  65. about the worst place to post a gawk bug report. Please, use the mechanisms
  66. outlined in the manual.
  67.  
  68. Arnold Robbins
  69. INTERNET:    arnold@gnu.ai.mit.edu
  70.  
  71. BUG REPORTS AND FIXES (non-Unix ports):
  72.  
  73. MS-DOS:
  74.     Scott Deifik
  75.     scottd@amgen.com
  76.  
  77.     Darrel Hankerson
  78.     hankedr@mail.auburn.edu
  79.  
  80. VMS:
  81.     Pat Rankin
  82.     rankin@eql.caltech.edu
  83.  
  84. Atari ST:
  85.     Michal Jaegermann
  86.     michal@gortel.phys.ualberta.ca
  87.  
  88. OS/2:
  89.     Kai Uwe Rommel
  90.     rommel@ars.de
  91.  
  92. Amiga:
  93.     Fred Fish
  94.     fnf@ninemoons.com
  95.