Return to README CVS log

Up to [local] / src / usr.bin / awk

Annotation of src/usr.bin/awk/README, Revision 1.2

1.2     ! kstailey    1: /*     $OpenBSD$       */
1.1       tholo       2: /****************************************************************
1.2     ! kstailey    3: Copyright (C) Lucent Technologies 1997
1.1       tholo       4: All Rights Reserved
                      5:
                      6: Permission to use, copy, modify, and distribute this software and
                      7: its documentation for any purpose and without fee is hereby
                      8: granted, provided that the above copyright notice appear in all
                      9: copies and that both that the copyright notice and this
                     10: permission notice and warranty disclaimer appear in supporting
1.2     ! kstailey   11: documentation, and that the name Lucent Technologies or any of
        !            12: its entities not be used in advertising or publicity pertaining
        !            13: to distribution of the software without specific, written prior
        !            14: permission.
        !            15:
        !            16: LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
        !            17: INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
        !            18: IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY
        !            19: SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
        !            20: WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
        !            21: IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
        !            22: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
        !            23: THIS SOFTWARE.
1.1       tholo      24: ****************************************************************/
                     25:
                     26: This is the version of awk described in "The AWK Programming Language",
1.2     ! kstailey   27: by Al Aho, Brian Kernighan, and Peter Weinberger
1.1       tholo      28: (Addison-Wesley, 1988, ISBN 0-201-07981-X).
1.2     ! kstailey   29:
1.1       tholo      30: Changes, mostly bug fixes and occasional enhancements, are listed
                     31: in FIXES.  If you distribute this code further, please please please
                     32: distribute FIXES with it.  If you find errors, please report them
                     33: to bwk@bell-labs.com.  Thanks.
                     34:
                     35: The program itself is created by
                     36:        make
1.2     ! kstailey   37: which should produce a sequence of messages roughly like this:
1.1       tholo      38:
1.2     ! kstailey   39:        yacc -d awkgram.y
1.1       tholo      40:
1.2     ! kstailey   41: conflicts: 42 shift/reduce, 83 reduce/reduce
        !            42:        mv y.tab.c ytab.c
        !            43:        mv y.tab.h ytab.h
        !            44:        cc -O -c ytab.c
        !            45:        cc -O -c b.c
        !            46:        cc -O -c main.c
        !            47:        cc -O -c parse.c
        !            48:        cc -O maketab.c -o maketab
        !            49:        ./maketab >proctab.c
        !            50:        cc -O -c proctab.c
        !            51:        cc -O -c tran.c
        !            52:        cc -O -c lib.c
        !            53:        cc -O -c run.c
        !            54:        cc -O -c lex.c
        !            55:        cc -O ytab.o b.o main.o parse.o proctab.o tran.o lib.o run.o lex.o -lm
1.1       tholo      56:
                     57: This produces an executable a.out;  you will eventually
                     58: want to move this to some place like /usr/bin/awk.
                     59:
1.2     ! kstailey   60: If your system is does not have yacc or bison (the GNU
        !            61: equivalent), you must compile the pieces manually.  We have
        !            62: included yacc output in ytab.c and ytab.h, and backup copies in
        !            63: case you overwrite them.
        !            64:
        !            65: NOTE: This version uses ANSI C, as you should also.  We have
        !            66: compiled this without any changes using gcc -Wall and/or local C
        !            67: compilers on a variety of systems, but new systems or compilers
        !            68: may raise some new complaint; reports of difficulties are
        !            69: welcome.
        !            70:
        !            71: This also compiles with Visual C++ 4.1 on Windows 95 and
        !            72: presumably Windows NT, *if* you provide versions of popen and
        !            73: pclose.  The file missing95.c contains do-nothing versions that
        !            74: can be used to get started with.  It is too much trouble to
        !            75: figure out how to make these work for real.
1.1       tholo      76:
1.2     ! kstailey   77: The version of malloc that comes with some systems is sometimes
        !            78: astonishly slow.  If awk seems slow, you might try fixing that.
1.1       tholo      79: