NEWS

   1 GNU M4 NEWS - User visible changes.
   2 Copyright (C) 1992, 1993, 1994, 2004, 2005, 2006 Free Software
   3 Foundation, Inc.
   4
   5 Version 1.4.5 - ?? 2006, by ???  (CVS version 1.4.4c)
   6
   7 * Fix sysval on BeOS, OS/2, and other systems that store exit status
   8   in the low-order byte.  Additionally, on Unix platforms, if syscmd was
   9   terminated by a signal, sysval now displays the signal number shifted
  10   left by eight bits, to match traditional m4 implementations.
  11 * The maketemp macro is no longer subject to platform limitations (such as
  12   26 or 32 max files from a given template).
  13 * Frozen files now require that the first directive be V (version), to
  14   better diagnose version mismatch.  Additionally, if the F directive
  15   (builtin function) names an unknown builtin that existed in the m4 that
  16   froze the file but not in the current m4 (for example, changeword), the
  17   warning is deferred until an attempt is made to actually use the
  18   builtin.  This allows downgrading from beta m4-1.4o to stable m4-1.4.5
  19   without breaking autoconf.
  20 * The format and indir macros are now recognized only with arguments.
  21 * The eval macro no longer crashes on x86 architectures when dividing the
  22   minimum integer by -1.
  23 * On systems with ecvt and fcvt, format no longer truncates trailing
  24   zeroes on integers printed with %.0f.  On systems without these
  25   functions, format is no longer subject to a buffer overflow that
  26   permitted arbitrary code execution.
  27 * On native Windows builds, the macro __windows__ is provided instead of
  28   __unix__.  Likewise, on OS/2 builds, the macro __os2__ is provided.  This
  29   allows input files to determine when syscmd might behave differently.
  30 * Fix bug in 1.4.3 patch to use \n line-endings that did not work for
  31   cygwin.
  32 * When given the empty string or 0, undivert is now documented as a no-op
  33   rather than closing stdout, warning about a non-existent file, or trying
  34   to read a directory as a file.
  35 * Many documentation improvements.  Also, the manual is now distributed
  36   under FDL 1.2, rather than a stricter verbatim-only license.
  37 * Raise the -L (--nesting-limit) command line option limit from 250 to
  38   1024.
  39 * The decr, incr, divert, m4exit, and substr macros treat an empty number
  40   as 0, issue a warning, and expand as normal; rather than issuing an error
  41   and expanding to the empty string.
  42 * The eval macro now treats an empty radix argument as 10, handles radix 1,
  43   and treats the width argument as number of digits excluding the sign,
  44   for compatibility with other m4 implementations.
  45 * The ifdef, divert, m4exit, substr, and translit macros now correctly
  46   ignore extra arguments.
  47 * The popdef and undefine macros now correctly accept multiple arguments.
  48
  49 Version 1.4.4b - 17 June 2006, by Eric Blake  (CVS version 1.4.4a)
  50
  51 * Fix a recursive push_string crashing bug, which affected changequote of
  52   three or more characters on some compilers.
  53 * Use automake to fix build portability issues.
  54 * Fix a recursive m4wrap crashing bug.
  55 * Fix a 1 in 2**32 hash crashing bug.
  56 * Tracing a macro by name is now persistent, even if the macro is
  57   subsequently undefined or redefined.  The traceon and traceoff macros no
  58   longer warn about undefined symbols.  This solves a crash when using
  59   indir on an undefined macro traced with the -t option, as well as an
  60   incorrect result of ifdef.  Furthermore, tracing is no longer transferred
  61   with builtins, solving the bug of "m4 -tm4_eval" failing to give trace
  62   output on the input "define(`m4_eval',defn(`eval'))m4_eval(1)".
  63 * Fix a crash when a macro is undefined while collecting its arguments, by
  64   always using the definition that was in effect before argument
  65   collection.  This behavior matches the C pre-processor, and means that
  66   the sequence "define(`f',`1')f(define(`f',`2'))f" is now documented to
  67   result in "12", rather than the previously undocumented "22".
  68 * Update the regex engine to fix several bugs.
  69 * Fix a potential crash on machines where char is signed.
  70
  71 Version 1.4.4 - October 2005, by Gary V. Vaughan
  72
  73 * ./configure --infodir=/usr/share/info now works correctly.
  74 * When any file named on the command line is missing exit with status 1.
  75
  76 Version 1.4.3 - March 2005, by Gary V. Vaughan
  77
  78 * DESTDIR installs now work correctly.
  79 * Don't segfault with uncompilable regexps to changeword().
  80 * Always use \n line-endings for frozen files (fixes a Windows bug).
  81 * Portability fix for systems lacking mkstemp(3).
  82 * Approximately 20% speed up in the common case of usage with autoconf.
  83 * Supported on QNX 6.3.
  84
  85 Version 1.4.2 - August 2004, by Paul Eggert
  86
  87 * No user visible changes; portability bug fixes only.
  88
  89 Version 1.4.1 - June 2004, by Paul Eggert
  90
  91 * maketemp now creates an empty file with the given name, instead of merely
  92   returning the name of a nonexistent file.  This closes a security hole.
  93
  94 Version 1.4 - October 1994, by Franc,ois Pinard
  95
  96 (No user visible changes)
  97 \f
  98 Version 1.3 - September 1994, by Franc,ois Pinard
  99
 100 * Diversions are created as needed.  Option `-N' is still accepted, but
 101 otherwise ignored.  Users should use only negative diversion numbers,
 102 instead of high positive numbers, for diverting to nowhere.
 103
 104 * Diversions should also work faster.  No temporary files will be needed
 105 at all if all diversions taken altogether do not use more than 512K.
 106
 107 * Frozen state files may be produced with the `--freeze-state' (-F)
 108 option and later brought back through the `--reload-state' (-R) option.
 109 \f
 110 Version 1.2 - July 1994, by Franc,ois Pinard
 111
 112 * In patsubst(STRING, REGEXP, REPLACEMENT), \& in REPLACEMENT has been
 113 changed to represent this part of STRING matched by the whole REGEXP,
 114 instead of the whole STRING as before.  \0 does the same, but emits a
 115 diagnostic saying it will disappear in some subsequent release.
 116
 117 * eval(EXPR) emits a diagnostic if EXPR has suffixed crumb.  The same for
 118 other numeric conversions in incr(), decr(), divert(), etc.
 119
 120 * `--fatal-warnings' (-E) stops execution at first warning.
 121
 122 * `--nesting-limit=LEVEL' (-L LEVEL) sets a limit to macro nesting.
 123 It is initially fixed at 250.
 124
 125 * `--word-regexp=REGEXP' (-W REGEXP) modifies macro name syntax, like
 126 does the new `changeword(REGEXP)' macro.  This feature is experimental,
 127 tell me your opinions about it.  You do need --enable-changeword at
 128 configure time to get these things.  Do *not* depend on them yet.
 129
 130 * Trace output format is scannable by GNU Emacs' next-error function.
 131
 132 * Stack overflow is detected and diagnosed on some capable systems.
 133
 134 * Various bugs have been corrected, m4 should be more portable.  See the
 135 ChangeLog for details.
 136 \f
 137 Version 1.1 - November 1993, by Franc,ois Pinard
 138
 139 Changes which might affect existing GNU m4 scripts:
 140
 141 * Option `-V' has been removed, use `--version' instead.  `--version'
 142 writes on standard output instead of standard error, and inhibits any
 143 script execution.
 144
 145 * `--no-gnu-extensions' has been renamed `--traditional'.
 146
 147 * In `eval', `^' used to indicate exponentiation, use `**' instead.
 148
 149 * The automatic undiversion which takes place at end of all input is
 150 forced into the main output stream.
 151
 152 Changes which are unlikely to affect existing scripts:
 153
 154 * `--help' prints an usage summary on standard output.  Script execution
 155 is then inhibited.
 156
 157 * `--prefix-builtins' (-P) prefixes all builtin macros by `m4_'.
 158
 159 * Most builtin macros for which arguments are mandatory, called without
 160 any arguments, are no more recognized as builtin macros: they are
 161 consequently copied verbatim to the output stream.
 162
 163 * `define' and `pushdef' are usable with only one argument, they give
 164 this argument an empty definition.
 165
 166 * `eval' new operators for binary representation handling: `^' for
 167 exclusive-or, `~' for the bitwise negation, `<<' and `>>' for shifts.
 168
 169 * `eval' recognizes the notation 0bDIGITS for binary numbers and the
 170 notation 0rRADIX:DIGITS for numbers in any radix from 1 to 36.
 171 \f
 172 Version 1.0.3 - December 1992, by Franc,ois Pinard
 173
 174 Changes for the user:
 175
 176 * `dnl' outputs a diagnostic if immediately followed by `('.  Usually,
 177 `dnl' is followed by newline or whitespace.
 178
 179 * `ifelse' accepts without complaining the common idiom of having only
 180 one argument.  This is useful for introducing long comments.
 181
 182 * `eval' always expresses values as signed, whatever the radix.
 183
 184 * M4OPTS environment variable is no longer obeyed.
 185
 186 * `--no-warnings' option is renamed `--silent'.
 187
 188 * Debug lines use a new format more compatible with GNU standards.
 189
 190 * Various bugs have been corrected.  See the ChangeLog for details.
 191
 192 Changes for the installer:
 193
 194 * GNU m4 now uses an Autoconf-generated configure script, and should be
 195 more easily portable in many ways.  (Cray is not supported yet).
 196
 197 * `make check' has been made more portable, expect no errors.
 198
 199 Changes for the programmer:
 200
 201 * Sources have been fully reindented to comply with GNU standards, and
 202 cleaned up in many ways.
 203
 204 * Sources have been protoized.  Non-ANSI compilers are automatically
 205 detected, then sources are unprotoized on the fly before compilation.
 206
 207 * GNU m4 uses newer versions of obstack, regex, getopt, etc.
 208 \f
 209 Version 1.0 - October 1991, by Rene' Seindal
 210
 211 * Uses GNU configure, taken from the gdb distribution.
 212
 213 * Uses GNU getopt(), with long option names.
 214
 215 * The -Q/+quiet option is added, which suppresses warnings about missing
 216 or superflous arguments to built-in macros.
 217
 218 * Added default options via the M4OPTS environment variable.
 219
 220 * Several minor bugs have been fixed.
 221 \f
 222 Version 0.99 - July 1991, by Rene' Seindal
 223
 224 * The builtins `incr' and `decr' are now implemented without use of
 225 `eval'.
 226
 227 * The builtin `indir' is added, to allow for indirect macro calls
 228 (allows use of "illegal" macro names).
 229
 230 * The debugging and tracing facilities has been enhanced considerably.
 231 See the manual for details.
 232
 233 * The -tMACRO option is added, marks MACRO for tracing as soon as it
 234 is defined.
 235
 236 * Builtins are traced after renaming iff they were before.
 237
 238 * Named files can now be undiverted.
 239
 240 * The -Nnum option can be used to increase the number of divertions
 241 available.
 242
 243 * Calling changecom without arguments now disables all comment handling.
 244
 245 * A bug in `dnl' is fixed.
 246
 247 * A bug in the multi-character quoting code is fixed.
 248
 249 * Several typos in the manual has been corrected.  More probably persist.
 250 \f
 251 Version 0.75 - November 1990, by Rene' Seindal
 252
 253 * Implemented search path for include files (-I option and M4PATH
 254 environment variable).
 255
 256 * Implemented builtin `format' for printf-like formatting.
 257
 258 * Implemented builtin `regexp' for searching for regular expressions.
 259
 260 * Implemented builtin `patsubst' for substitution with regular
 261 expressions.
 262
 263 * Implemented builtin `esyscmd', which expands to a shell commands output.
 264
 265 * Implemented `__file__' and `__line__' for use in error messages.
 266
 267 * Implemented character ranges in `translit'.
 268
 269 * Implemented control over debugging output.
 270
 271 * Implemented multi-character quotes.
 272
 273 * Implemented multi-character comment delimiters.
 274
 275 * Changed predefined macro `gnu' to `__gnu__'.
 276
 277 * Changed predefined macro `unix' to `__unix__', when the -G option is
 278 not used.  With -G, `unix' is still defined.
 279
 280 * Added program name to error messages.
 281
 282 * Fixed two missing null bytes bugs.
 283 \f
 284 Version 0.50 - January 1990, by Rene' Seindal
 285
 286 * Initial beta release.
 287 \f
 288 Local Variables:
 289 fill-column: 75
 290 End: