ref: 1dbb193077af7ba6ff7fb70a4dd465480764382e
dir: /utils/awk/README/
/**************************************************************** Copyright (C) Lucent Technologies 1997 All Rights Reserved Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that the copyright notice and this permission notice and warranty disclaimer appear in supporting documentation, and that the name Lucent Technologies or any of its entities not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ****************************************************************/ This is the version of awk described in "The AWK Programming Language", by Al Aho, Brian Kernighan, and Peter Weinberger (Addison-Wesley, 1988, ISBN 0-201-07981-X). Changes, mostly bug fixes and occasional enhancements, are listed in FIXES. If you distribute this code further, please please please distribute FIXES with it. If you find errors, please report them to bwk@bell-labs.com. Thanks. The program itself is created by make which should produce a sequence of messages roughly like this: yacc -d awkgram.y conflicts: 43 shift/reduce, 85 reduce/reduce mv y.tab.c ytab.c mv y.tab.h ytab.h cc -O -c ytab.c cc -O -c b.c cc -O -c main.c cc -O -c parse.c cc -O maketab.c -o maketab ./maketab >proctab.c cc -O -c proctab.c cc -O -c tran.c cc -O -c lib.c cc -O -c run.c cc -O -c lex.c cc -O ytab.o b.o main.o parse.o proctab.o tran.o lib.o run.o lex.o -lm This produces an executable a.out; you will eventually want to move this to some place like /usr/bin/awk. If your system is does not have yacc or bison (the GNU equivalent), you must compile the pieces manually. We have included yacc output in ytab.c and ytab.h, and backup copies in case you overwrite them. We have also included a copy of proctab.c so you do not need to run maketab. NOTE: This version uses ANSI C, as you should also. We have compiled this without any changes using gcc -Wall and/or local C compilers on a variety of systems, but new systems or compilers may raise some new complaint; reports of difficulties are welcome. This also compiles with Visual C++ on Windows 95 and Windows NT, *if* you provide versions of popen and pclose. The file missing95.c contains versions that can be used to get started with, though the underlying support has mysterious properties, the symptom of which can be truncated pipe output. Beware. This is also said to compile on Macintosh systems, using the file "buildmac" provided by Dan Allen (danallen@microsoft.com), to whom many thanks. Dan also provided buildwin.bat, a simple script for compiling on NT if you prefer. The version of malloc that comes with some systems is sometimes astonishly slow. If awk seems slow, you might try fixing that.