~vcs-imports/gawk/master

   Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,

   2005, 2006, 2007, 2009, 2010 Free Software Foundation, Inc.

   Copying and distribution of this file, with or without modification,

   are permitted in any medium without royalty provided the copyright

   notice and this notice are preserved.

Changes from 3.1.7 to 3.1.8

---------------------------

1. The zero flag no longer applies to %c and %s; apparently the standards

   changed at some point.

2. Updated to latest infrastructure: Autoconf 2.65, Automake 1.11.1,

   libtool 2.2.6b, Bison 2.4.2.

3. Failure to open a socket is no longer a fatal error.

4. dfa.h and dfa.c are now more-or-less in sync with GNU grep, for the first

   time in many years.

5. Gawk no longer includes its own copy of libsigsegv but it will use it if

   installed on the build system. The --disable-libsigsegv configure option

   is now gone.

6. The ' flag (%'d) is now just ignored on systems that can't support it.

7. Lots of bug fixes, see the ChangeLog.

Changes from 3.1.6 to 3.1.7

---------------------------

1. Gawk now has support for z/OS (IBM S/390 architecture).

2. Gawk now handles multibyte strings better in [s]printf with field

   widths and such.

3. Gawk now uses libsigsegv to print a message before core dumping. This

   handles infinite recursion of an awk function a little better.

   Use of the library can be disabled at configure time with the

   --disable-libsigsegv option for unusual systems.

4. The handling of BINMODE is now somewhat more sane.

5. A getline from a directory is no longer fatal; instead it returns -1.

6. Per POSIX, special variable names (like FS) cannot be used as function

   parameter names.

7. The new -O / --optimize option enables simple constant folding on

   the parse tree during parsing.  We hope that with time the number

   of optimizations will increase.

8. Updated to the latest autotools: Autoconf 2.63, Automake 1.11,

   Libtool 2.2.6a, and Gettext 0.17. Also latest Bison: 2.4.1.

9. Some improvement in testing for isinf / isnan in builtin.c.

10. Improved the handling of `a = a b c' to be more general.

11. Locale handling for %'d should now work on certain non-Unix /

    non-Linux systems.

12. Lots of bugs fixed, see the ChangeLog for the details.

Changes from 3.1.5 to 3.1.6

---------------------------

1. `gawk 'program' /non/existant/file' no longer core dumps.

2. Too many people the world over have complained about gawk's use of the

   locale's decimal point for parsing input data instead of the traditional

   period.  So, even though gawk was being nicely standards-compliant, in

   a Triumph For The Users, gawk now only uses the locale's decimal point

   if --posix is supplied or if POSIXLY_CORRECT is set.  It is the sincere

   hope that this change will eliminate this FAQ from being asked.

3. `gawk -v BINMODE=1 ...' works again.

4. Internal file names like `/dev/user' now work again. (Note that these

   file names are obsolete and will go away eventually.)

5. Problems with wide strings in non "C" locales have been straightened

   out everywhere.  (At least, we think so.)

6. Use of `ansi2knr' is no longer supported. Please use an ANSI C compiler.

7. Updated to Autoconf 2.61, Automake 1.10, and Gettext 0.16.1.

8. The getopt* and regex* files were synchronized with current GLIBC CVS.

   See the ChangeLog for the versions and minor edits made.

9. There are additional --lint-old warnings.

10. Gawk now uses getaddrinfo(3) to look up names and IP addresses. This

    allows the use of an IPv6 format address and paves the way for

    eventual addition of `/inet6/...' and `/inet4/...' hostnames.

11. We believe gawk to now be valgrind clean. At least when run against

    the test suite.

12. A number of issues dealing with the formatting and printing of very

    large numbers in integer formats have been dealt with and fixed.

13. Gawk now converts "+inf", "-inf", "+nan" and "-nan" into the corresponding

    magic IEEE floating point values. Only those strings (case independent)

    work.  With --posix, gawk calls the system strtod directly. You asked

    for it, you got it, you deal with it.

14. Defining YYDEBUG enables the -D command line option.

15. Gawk should now work out of the box on Tandem NSK/OSS systems.

16. Lint messages rationalized: many more of the messages are now printed

    only once, instead of every time they are encountered.

17. The strftime() function now accepts an optional third argument, which

    if non-zero or non-null, indicates that the time should be formatted

    as UTC instead of as local time.

18. The precedence of concatenation and `| getline' (in something like

    "echo " "date" | getline stuff) has been reverted to the earlier

    behavior and now once again matches Unix awk.

19. New configure time flag --disable-directories-fatal which causes

    gawk to silently skip directories on the command line.  This behavior

    is also enabled for --traditional, since it's what Unix awk does.

20. A new option, --use-lc-numeric, forces use of the locale's decimal

    point without the rest of the draconian restrictions imposed by

    --posix. This softens somewhat the stance taken in item #2.

21. Everything relevant has been updated to the GPL 3.

22. Array growth should be faster now, at no cost in space.

23. Lots more tests.

24. One new translation.

25. Various bugs fixed, see the ChangeLog for details.

Changes from 3.1.4 to 3.1.5

---------------------------

1. The random() suite has been updated to a current FreeBSD version, which

   works on systems with > 32-bit ints.

2. A new option, `--exec' has been added. It's like -f but ends option

   processing.  It also disables `x=y' variable assignments, but not -v.

   It's needed mainly for CGI scripts, so that source code can't be

   passed in as part of the URL.

3. dfa.[ch] have been synced with GNU grep development.  This also fixes

   multiple regex matching problems in multibyte locales.

4. Updated to Automake 1.9.5.

5. Updated to Bison 2.0.

6. The getopt* and regex* files were synchronized with current GLIBC CVS.

   See the ChangeLog for the versions and minor edits made.

7. `configure --disable-nls' now disables just gawk's own translations.

   Gawk continues to work with the locale's numeric formatting.  This

   includes a bug fix in handling the printf ' flag (e.g., %'d).

8. Gawk is now multibyte aware.  This means that index(), length(),

   substr() and match() all work in terms of characters, not bytes.

9. Gawk is now smarter about parsing numeric constants in corner cases.

11. Not closing open redirections no longer causes gawk to exit non-zero.

10. The VMS port has been updated.

11. Changes from Andrew Schorr at the xmlgawk project to provide for

    open hooks from extensions are now included.  This will let the

    xmlgawk extension work in the standard gawk.

12. Updated to gettext 0.14.4. Gawk no longer includes its own copy

    of the gettext `intl' library, following current GNU practice to

    rely on there being an external version thereof.

13. A regexp of the form `//' will now generate a warning that it

    is not a C++ comment from --lint (awk.y).

14. The ^ and ^= operators with an integer exponent now use Exponentiation

    by Squaring. This simultaneously fixes a problem with ^= and a negative

    integer exponent.

15. length(array) now returns the number of elements in the array.  This is

    is a non-standard extension that will fail in POSIX mode.

16. Carriage return characters are now ignored in program source code.

17. Four new translations added.

18. Various minor bugs fixed. See the ChangeLog for the details.

Changes from 3.1.3 to 3.1.4

---------------------------

1. Gawk now supports the POSIX %F format, falling back to %f if the local

   system printf doesn't handle it.

2. Gawk now supports the ' flag in printf. E.g., %'d in a locale with thousands

   separators includes the thousands separator in the value, e.g. 12,345.

   This has one problem; the ' flag is next to impossible to use on the

   command line, without major quoting games.  Oh well, TANSTAAFL.

3. The dfa code has been reinstated; the performance degradation was

   just too awful.  Sigh.  (For fun, use `export GAWK_NO_DFA=1' to

   see the difference.)

4. The special case `x = x y' is now recognized in the grammar, and gawk

   now uses `realloc' to append the new value to the end of the existing

   one.  This can speed up the common case of appending onto a string.

5. The dfa code was upgraded with most of the fixes from grep 2.5.1, and

   the regex code was upgraded with GLIBC as mid-January 2004.  The regex

   code is faster than it was, but still not as fast as the dfa code, so

   the dfa code stays in.  The getopt code was also synced to current GLIBC.

6. Support code upgraded to Automake 1.8.5, Autoconf 2.59, and gettext 0.14.1.

7. When --posix is in effect, sub/gsub now follow the 2001 POSIX behavior.

   Yippee.  This is even documented in the manual.

8. Gawk will now recover children that have died (input pipelines, two-way

   pipes), upon detecting EOF from them, thus avoiding filling

   up the process table.  Open file descriptors are not recovered

   (unfortunately), since that could break awk semantics.  See the

   ChangeLog and the source code for the details.

9. Handling of numbers like `0,1' in non-American locales ought to

   work correctly now.

10. IGNORECASE is now locale-aware for characters with values above 128.

    The dfa matcher is now used for IGNORECASE matches too.

11. Dynamic function loading is better. The documentation has been improved

    and some new APIs for use by dynamic functions have been added.

12. Gawk now has a fighting chance of working on older systems,

    a la SunOS 4.1.x.

13. Issues with multibyte support on HP-UX are now resolved. `configure' now

    disables such support there, since it's not up to what gawk needs.

14. There are now even more tests in the test suite.

15. Various bugs fixed; see ChangeLog for the details.

Changes from 3.1.2 to 3.1.3

---------------------------

1. Gawk now follows POSIX in handling of local numeric formats for

   input, output and number/string conversions.

2. Multibyte detection improved.  See README_d/README.multibyte for more

   info about multibyte locales.

3. Handling of `close' made more POSIX-compliant for POSIXLY_CORRECT,

   see the documentation.

4. The record reading code was redone, again.  This time it's much

   better. Really!

5. For RS = "\n" and RS = "", gawk now only sets RT when it has changed.

   This provides considerable performance improvement.

6. `match' now sets all the subscripts in the third argument array

   correctly, even if not all subexpressions matched.

7. Updated to Automake 1.7.5.  configure.in renamed configure.ac.

8. C-style switch statements are available, but must be enabled at

   compile time via `configure --enable-switch'.  For 3.2 they'll be

   enabled by default. Thanks to Michael Benzinger for the initial

   code.

9. %c now always prints no more than one character, whatever

   precision is provided.

10. strtonum(<number>) now works again.

11. Gawk is now much better about scalar/array typing of global

    uninitiailzed variables passed as parameters. Once the parameter

    is then used one way or the other, the global var's type is

    adjusted accordingly.  Thanks to Stepan Kasal for the original

    (considerable) changes.

12. Dynamic function loading under Windows32 should now be possible. See

    README_d/README.pcdynamic. Thanks to Patrick T.J. McPhee for the changes.

13. Updated to gettext 0.12.1.

14. Gawk now follows historical practice and POSIX for the return

    value of `rand': It's now  0 <= N < 1.

Changes from 3.1.1 to 3.1.2

---------------------------

1. Loops of the form:

	for (iggy in foo)

		next

   no longer leak memory.

2. gawk -v FIELDWIDTHS="..." now sets PROCINFO["FS"] correctly.

3. All builtin operations and functions should now fully evaluate their

   arguments so that side effects take place correctly.

4. Fixed a logic bug in gsub/gensub for matches to null strings that occurred

   later in the string after a nonnull match.

5. getgroups code now works on Ultrix again.

6. Completely new version of the full GNU regex engine now in place.

7. Argument parsing and variable assignment has been cleaned up.

8. An I/O bug on HP-UX has been documented and worked around. See

   README_d/README.hpux.

9. awklib/grcat should now compile correctly.

10. Updated to automake 1.7.3, autoconf 2.57 and gettext 0.11.5 ; thanks to

    Paul Eggert for the initial automake and autoconf work.

11. As a result of #6, removed the use of the dfa code from GNU grep.

12. It is now possible to use ptys for |& two-way pipes instead of

    pipes.  The basic plumbing for this was provided by Paolo Bonzini.

    To make this happen:

    	command = "unix command etc"

	PROCINFO[command, "pty"] = 1

	print ... |& command

	command |& getline stuff

    In other words, set the element in PROCINFO *before* opening the

    two-way pipe, and then gawk will use ptys instead of pipes.

    On systems without ptys or where all the ptys are in use, gawk

    will fall back to using plain pipes.

13. Fixed a regex matching across buffer boundaries bug, with a

    heuristic.  See io.c:rsre_get_a_record.

14. Profiling no longer dumps core if there are extension functions in place.

15. Grammar and scanner cleaned up, courtesy of Stepen Kasal, to hopefully

    once and for all fix the `/=' operator vs. `/=.../' regex ambiguity.

    Lots of other grammar simplifications applied, as well.

16. BINMODE should work now on more Windows ports.

17. Updated to bison 1.875.  Includes fix to bisonfix.sed script.

18. The NODE structure is now 20% (8 bytes) smaller (on x86, anyway), which

    should help conserve memory.

19. Builds not in the source directory should work again.

20. Arrays now use 2 NODE's per element instead of three. Combined with

    #18, (on the x86) this reduces the overhead from 120 bytes per element

    to just 64 bytes: almost a 50% improvement.

21. Programs that make heavy use of changing IGNORECASE should now be

    much faster, particularly if using a regular expression for FS or RS.

    IGNORECASE now correctly affects RS regex record splitting, as well.

22. IGNORECASE no longer affects single-character field splitting (FS = "c"),

    or single-character record splitting (RS = "c").

    This cleans up some weird behavior, and makes gawk better match the

    documentation, which says it only affects regex-based field splitting

    and record splitting.

    The documentation on this was improved, too.

23. The framework in test/ has been simplified, making it much easier to

    add new tests while keeping the size of Makefile.am reasonable. Thanks

    for this to Stepan Kasal.

24. --lint=invalid causes lint warnings only about stuff that's actually

    invalid.  This needs additional work.

25. More translations.

26. The `get_a_record' routine has been revamped (currently by splitting it

    into three variants).  This should improve long-term maintainability.

27. `match' now adds more entries to 3rd array arg:

	match("the big dog", /([a-z]+) ([a-z]+) ([a-z]+)/, data)

    fills in variables:

    	data[1, "start"], data[1, "length"], and so on.

28. New `asorti' function with same interface as `asort', but sorts indices

    instead of values.  

29. Documentation updated to FDL 1.2.

30. New `configure' option --disable-lint at compile time disables lint

    checking.  With GCC dead-code-elimination, cuts almost 200K off the

    executable size on GNU/Linux x86.  Presumably speeds up runtime.

    Using this will cause some of the tests in the test suite to fail.

    This option may be removed at a later date.

31. Various minor cleanups, see the ChangeLog for details.

Changes from 3.1.0 to 3.1.1

---------------------------

1. Six new translations.

2. Having more than 4 different values for OFMT and/or CONVFMT now works.

3. The handling of dynamic regexes is now more more sane, esp. w.r.t.

   the profiling code.  The profiling code has been fixed in several

   places.

4. The return value of index("", "") is now 1.

5. Gawk should no longer close fd 0 in child processes.

6. Fixed test for strtod semantics and regenerated configure.

7. Gawk can now be built with byacc; an accidental bison dependency was

   removed.

8. `yyerror' will no longer dump core on long source lines.

9. Gawk now correctly queries getgroups(2) to figure out how many groups

   the process has.

10. New configure option to force use of included strftime, e.g. on

    Solaris systems. See `./configure --help' for the details. Replaced

    the included strftime.c with the one from textutils.

11. OS/2 port has been updated.

12. Multi-byte character support has been added, courtesy of IBM Japan.

13. The `for (iggy in foo) delete foo[iggy]' -> `delete foo' optimisation

    now works.

14. Upgraded to gettext 0.11.2 and automake 1.5.

15. Full gettext compatibility (new dcngettext function).

16. The O'Reilly copyedits and indexing changes for the documentation have

    been folded into the texinfo version of the manuals.

17. A humongously long value for the AWKPATH environment variable will no

    longer dump core.

18. Configuration / Installation issues have been straightened out in

    Makefile.am.

Changes from 3.0.6 to 3.1.0

---------------------------

1. A new PROCINFO array provides info about the process. The non-I/O /dev/xxx

   files are now obsolete, and their use always generates a warning.

2. A new `mktime' builtin function was added for creating time stamps. The

   `mktime' function written in awk was removed from the user's guide.

3. New `--gen-po' option creates GNU gettext .po files for strings marked

   with a leading underscore.

4. Gawk now completely interprets special file names internally, ignoring the

   existence of real /dev/stdin, /dev/stdout files, etc.

5. The mmap code was removed. It was a worthwhile experiment that just

   didn't work out.

6. The BINMODE variable is new; on non-UNIX systems it affects how gawk

   opens files for text vs. binary.

7. The atari port is now unsupported.

8. Gawk no longer supports `next file' as two words.

9. On systems that support it, gawk now sets the `close on exec' flag on all

   files and pipes it opens. This makes sure that child processes run via

   `system' or pipes have plenty of file descriptors available.

10. New ports: Tandem and BeOS.  The Tandem port is unsupported.

11. If `--posix' is in effect, newlines are not allowed after ?:.

12. Weird OFMT/CONVFMT formats no longer cause fatal errors.

13. Diagnostics about array parameters now include the parameter's name,

    not just its number.

14. configure should now automatically add -D_SYSV3 for ISC Unix.

    (This seems to have made it into the gawk 3.0.x line long ago.)

15. It is now possible to open a two-way pipe via the `|&' operator.

    See the discussion in the manual about putting `sort' into such a pipeline,

    though.  (NOTE!  This is borrowed from ksh: it is not the same as

    the same operator in csh!)

16. The `close' function now takes an optional second string argument

    that allows closing one or the other end of the two-way pipe to

    a co-process.  This is needed to use `sort' in a co-process, see

    the doc.

17. If TCP/IP is available, special file names beginning with `/inet'

    can be used with `|&' for IPC. Thanks to Juergen Kahrs for the initial

    code.

18. With `--enable-portals' on the configure command line, gawk will also

    treat file names that start with `/p/' as a 4.4 BSD type portal file,

    i.e., a two-way pipe for `|&'.

19. Unrecognized escapes, such as "\q" now always generate a warning.

20. The LINT variable is new; it provides dynamic control over the --lint

    option.

21. Lint warnings can be made fatal by using --lint=fatal or `LINT = "fatal"'.

    Use this if you're really serious about portable code.

22. Due to an enhanced sed script, there is no longer any need to worry

    about finding or using alloca.  alloca.c is thus now gone.

23. A number of lint warnings have been added.  Most notably, gawk will

    detect if a variable is used before assigned to.  Warnings for

    when a string that isn't a number gets converted to a number are

    in the code but disabled; they seem to be too picky in practice.

    Also, gawk will now warn about function parameter names that shadow

    global variable names.

24. It is now possible to dynamically add builtin functions on systems

    that support dlopen. This facility is not (yet) as portable or well

    integrated as it might be.  *** WARNING *** THIS FEATURE WILL EVOLVE!

25. There are *many* new tests in the test suite.

26. Profiling has been added!  A separate version of gawk, named pgawk, is

    built and generates a run-time execution profile.  The --profile option

    can be used to change the default output file.   In regular gawk, this

    option pretty-prints the parse tree.

27. Gawk has been internationalized, using GNU gettext.  Translations for

    future distributions are most welcome.  Simultaneously, gawk was switched

    over to using automake.  You need Automake 1.4a (from the CVS archive)

    if you want to muck with the Makefile.am files.

28. New `asort' function for sorting arrays.  See the doc for details.

29. The match function takes an optional array third argument to hold

    the text matched by parenthesized sub-expressions.

30. The bit op functions and octal and hex source code constants are on by

    default, no longer a configure-time option.  Recognition of non-decimal

    data is now enabled at runtime with --non-decimal-data command line option.

31. Internationalization features available at the awk level: new TEXTDOMAIN

    variable and `bindtextdomain' and `dcgettext' functions. printf formats

    may contain the "%2$3.5d" kind of notation for use in translations.  See

    the texinfo manual for details.

32. The return value from `close' has been rationalized.  Most notably,

    closing something that wasn't open returns -1 but remains non-fatal.

33. The array effeciency change from 3.0.5 was reverted; the semantics were

    not right.  Additionally, index values of previously stored elements

    can no longer change dynamically.

34. The new option --dump-variables dumps a list of all global variables and

    their final types and values to a file you give, or to `awkvars.out'.

35. Gawk now uses a recent version of random.c courtesy of the FreeBSD

    project.

36. The gawk source code now uses ANSI C function definitions (new style),

    with ansi2knr to translate code for old compilers.

37. `for (iggy in foo)' loops should be more robust now in the face of

    adding/deleting elements in the middle; they loop over just the elements

    that are present in the array when the loop starts.

Changes from 3.0.5 to 3.0.6

---------------------------

This is a bug fix release only, pending further development on 3.1.0.

Bugs fixed and changes made:

1. Subscripting an array with a variable that is just a number no

   longer magically converts the variable into a string.

2. Similarly, running a `for (iggy in foo)' loop where `foo' is a

   function parameter now works correctly.

3. Similarly, `i = ""; v[i] = a; if (i in v) ...' now works again.