Imported Upstream version 1.4.16
[platform/upstream/m4.git] / NEWS
1 GNU M4 NEWS - User visible changes.
2
3 * Noteworthy changes in release 1.4.16 (2011-03-01) [stable]
4
5 ** Fix regressions in the `index' builtin.  On glibc platforms, this
6    avoids false positives from a strstr bug in glibc 2.9 through 2.12;
7    on many other platforms, it fixes two separate regressions, a false
8    positive introduced in 1.4.11 and a false negative in 1.4.15.
9
10 ** A number of portability improvements inherited from gnulib.
11
12
13 * Noteworthy changes in release 1.4.15 (2010-08-31) [stable]
14
15 ** Fix regression introduced in 1.4.9b where the `format' builtin could
16    crash on an invalid format string.
17
18 ** Fix compilation against newer glibc, and on AIX 7.1BETA.
19
20 ** A number of portability improvements inherited from gnulib.
21
22
23 * Noteworthy changes in Version 1.4.14 (2010-02-24) [stable]
24   Released by Eric Blake, based on git version 1.4.13.*
25
26 ** Fix regression introduced in 1.4.12 where executing with stdout closed
27    could crash m4 on exit on some platforms.
28
29 ** Fix regressions introduced in 1.4.13 in the `esyscmd' builtin, where
30    closed file descriptors could interfere with child execution, and where
31    a child status of 127 made m4 print a spurious message to stderr.
32
33 ** Fix a security hole in 'make dist', present since at least M4 1.4, that
34    could affect anybody attempting to redistribute modified sources (see
35    Automake CVE-2009-4029).
36
37 ** A number of portability improvements inherited from gnulib.
38
39 * Noteworthy changes in Version 1.4.13 (2009-04-01) [stable]
40   Released by Eric Blake, based on git version 1.4.12.*
41
42 ** The manual is now distributed under the terms of FDL 1.3.
43
44 ** The `divert' and `undivert' builtins have been made more efficient
45    when using temporary files for large diversions.
46
47 ** The `translit' builtin has been made more efficient when the second
48    argument is short.
49
50 ** The input engine has been optimized for faster processing.
51
52 ** The command line option `--debugfile', introduced in 1.4.7, now
53    treats its argument as optional, in order to allow setting the debug
54    output back to stderr when used without an argument; and order is now
55    significant with respect to command line files.  You must therefore use
56    `m4 --debugfile=trace file', not `m4 file --debugfile trace'.  This
57    change does not affect the deprecated `-o'/`--error-output' option.
58
59 ** The `syscmd' and `esyscmd' builtins can be configured to use an
60    alternate shell, via the new `configure' option `--with-syscmd-shell'.
61
62 ** A number of portability improvements inherited from gnulib.
63
64 * Noteworthy changes in Version 1.4.12 (2008-10-10) [stable]
65   Released by Eric Blake, based on git version 1.4.11.*
66
67 ** Fix regression introduced in 1.4.4b where using `traceon' could delete
68    a macro.  This was most noticeable with `traceon(`traceon')', but
69    would also happen in cases such as `foo(traceon(`foo'))'.
70
71 ** Fix regression introduced in 1.4.7 where `m4 -N9' died with an assertion
72    failure.
73
74 ** Fix regression introduced in 1.4.11 where `defn' died with an assertion
75    failure on a traced but undefined macro.
76
77 ** New `-g'/`--gnu' command-line option overrides `-G'/`--traditional'.
78    For now, the environment variable POSIXLY_CORRECT has no effect on M4
79    behavior; but a future release of M4 will behave as though --traditional
80    is implied if POSIXLY_CORRECT is set (this future change is necessary,
81    because in the current release, there is no way to disable GNU
82    extensions that conflict with POSIX without the use of a non-POSIX
83    command-line argument).  Clients of M4 that want to use GNU extensions,
84    even when POSIXLY_CORRECT is set, should start using the -g command-line
85    argument, even though it is currently a no-op if -G did not appear
86    earlier in the command line, so that the client will not break in the
87    face of an upgraded m4 and a POSIXLY_CORRECT execution environment.
88
89 ** The `-L'/`--nesting-limit' command-line option now defaults to 0 for
90    unlimited on platforms that can detect and deal with stack overflow.  On
91    systems that lack alternate stack support, such as Cygwin, and on
92    systems that do not obey the POSIX semantics for distinguishing stack
93    overflow from other exceptions, such as Linux, you can optionally
94    install the libsigsegv library (version 2.6 or newer recommended) to
95    enhance m4's ability to accurately report stack overflow:
96    http://www.gnu.org/software/libsigsegv/
97
98 ** A number of portability improvements inherited from gnulib.
99
100 * Noteworthy changes in Version 1.4.11 (2008-04-02) [stable]
101   Released by Eric Blake, based on git version 1.4.10a
102
103 ** Security fixes for the -F option, for bugs present since -F was
104    introduced in 1.3: Avoid core dump with 'm4 -F file -t undefined', and
105    avoid arbitrary code execution with certain file names.
106
107 ** Fix regression introduced in 1.4.9b in the `divert' builtin when more
108    than 512 kibibytes are saved in diversions on platforms like NetBSD
109    or darwin where fopen(name,"a+") seeks to the end of the file.
110
111 ** The output of the `maketemp' and `mkstemp' builtins is now quoted if a
112    file was created.  This is a minor security fix, because it was possible
113    (although rather unlikely) that an unquoted string could match an
114    existing macro name, such that use of the `mkstemp' output would trigger
115    inadvertent macro expansion and operate on the wrong file name.
116
117 ** Enhance the `defn' builtin to support concatenation of multiple text
118    arguments, as required by POSIX.  However, at this time, it is not
119    possible to concatenate a builtin macro with anything else; a warning is
120    now issued if this is attempted, although a future version of M4 may
121    lift this restriction to match other implementations.
122
123 ** Enhance the `format' builtin to parse all C99 floating point numbers,
124    even on platforms where strtod(3) is buggy, although the replacement
125    function does have the known issue of rounding errors when parsing
126    some decimal floating point values.  This fixes testsuite failures
127    introduced in 1.4.9b.
128
129 ** Enhance the `index' builtin to guarantee linear behavior, in spite of
130    the surprisingly large number of systems with a brain-dead quadratic
131    strstr(3).
132
133 ** A number of portability improvements inherited from gnulib.
134
135 * Noteworthy changes in Version 1.4.10 (2007-07-09) [stable]
136   Released by Eric Blake, based on CVS version 1.4.9c
137
138 ** Upgrade from GPL version 2 to GPL version 3 or later.
139
140 ** A number of portability improvements inherited from gnulib.
141
142 ** Avoid undefined behavior introduced in 1.4.9b in the `format' builtin
143    when handling %c.  However, this area of code has never been documented,
144    and currently does not match the POSIX behavior of printf(1), so it may
145    have further changes in the next version.
146
147 * Noteworthy changes in Version 1.4.9b (2007-05-29) [beta]
148   Released by Eric Blake, based on CVS version 1.4.9a
149
150 ** Fix regression introduced in 1.4.9 in the `eval' builtin when performing
151    division.
152
153 ** Fix regression introduced in 1.4.8 in the `-F' option that made it
154    impossible to freeze more than 512 kibibytes of diverted text.
155
156 ** The synclines option `-s' no longer generates sync lines in the middle of
157    multiline comments or quoted strings.
158
159 ** Work around a number of corner-case POSIX compliance bugs in various
160    broken stdio libraries.  In particular, the `syscmd' builtin behaves
161    more predictably when stdin is seekable.
162
163 ** The `format' builtin now understands formats such as %a, %A, and %'hhd,
164    and works around a number of platform printf bugs.  Furthermore, the
165    sequence format(%*.*d,-1,-1,1) no longer outputs random data.  However,
166    some non-compliant platforms such as mingw still have known bugs in
167    strtod that may cause testsuite failures.
168
169 ** The testsuite is improved to also run gnulib portability tests for the
170    features that M4 imports from gnulib.
171
172 * Noteworthy changes in Version 1.4.9 (2007-03-23) [stable]
173   Released by Eric Blake, based on CVS version 1.4.8c
174
175 ** Minor documentation and portability cleanups.
176
177 * Noteworthy changes in Version 1.4.8b (2007-02-24) [beta]
178   Released by Eric Blake, based on CVS version 1.4.8a
179
180 ** Fix a regression introduced in 1.4.8 that made m4 unable to process
181    files larger than 2GiB on some platforms.
182
183 ** Fix a regression introduced in 1.4.8 that made m4 dump core when
184    invoked as 'm4 -- file'.
185
186 ** The `eval' builtin now follows C precedence rules.  Additionally, the
187    short-circuit operators correctly short-circuit division by zero.  The
188    previously undocumented alias of '=' meaning '==' in eval now triggers a
189    deprecation warning, so that a future version of M4 can implement a form
190    of variable assignment as an extension.
191
192 ** The `include' builtin now affects exit status on failure, as required by
193    POSIX.  Use `sinclude' if you need a successful exit status.
194
195 ** The `-E'/`--fatal-warnings' command-line option now has two levels.  When
196    specified only once, warnings affect exit status, but execution
197    continues, so that you can see all warnings instead of fixing them one
198    at a time.  To achieve 1.4.8 behavior, where the first warning
199    immediately exits, specify -E twice on the command line.
200
201 ** A new `--warn-macro-sequence' command-line option allows detection of
202    sequences in `define' and `pushdef' definitions that match an optional
203    regular expression.  The default regular expression is
204    `\$\({[^}]*}\|[0-9][0-9]+\)', corresponding to the sequences that might
205    not behave correctly when upgrading to the eventual M4 2.0.  By default,
206    M4 2.0 will follow the POSIX requirement that a macro definition
207    containing `$11' must expand to the first argument concatenated with 1,
208    rather than the eleventh argument; and will take advantage of the POSIX
209    wording that allows implementations to treat `${11}' as the eleventh
210    argument instead of literal text.  Be aware that Autoconf 2.61 will not
211    work with this option enabled with the default regular expression; but
212    Autoconf 2.62 will be compatible with this option.
213
214 ** Improved portability to platforms such as BSD/OS and AIX.
215
216 * Noteworthy changes in Version 1.4.8 (2006-11-20) [stable]
217   Released by Eric Blake, based on CVS version 1.4.7a
218
219 ** The `divert' macro and `-H'/`--hashsize' command line option no longer
220    cause a core dump when handed extra large values.  Also, `divert' now
221    uses memory proportional to the number of diversions in use, rather than
222    to the maximum diversion number encountered, so that large diversion
223    numbers are less likely to exhaust system memory; and is no longer
224    limited by the maximum number of file descriptors.
225
226 ** The `--help' and `--version' command line options now consistently
227    override all earlier options.  For example, `m4 --debugfile=trace
228    --help' now no longer accidentally creates an empty file `trace'.
229
230 ** The `-L'/`--nesting-limit' command line option can now be set to 0
231    to remove the default limit of 1024.  However, it is still possible that
232    heavily nested input can cause abrupt program termination due to stack
233    overflow.
234
235 ** Problems encountered when writing to standard error, such as with the
236    `errprint' macro, now always cause a non-zero exit status.
237
238 ** Warnings and errors issued during macro expansion are now consistently
239    reported at the line where the macro name was detected, rather than
240    where the close parenthesis resides.  Text wrapped by `m4wrap' now
241    remembers the location that was in effect when m4wrap was invoked,
242    rather than changing to line 0 and the empty string for a file.  The
243    macros `__line__' and `__file__' now work correctly even as the last
244    token in an included file.
245
246 ** The `builtin' and `indir' macros now transparently handle builtin
247    tokens generated by `defn'.
248
249 ** When diversions created by the `divert' macro collect enough text that
250    M4 must use temporary files, the environment variable $TMPDIR is now
251    consulted, and a better effort is made to clean up those files in the
252    event of a fatal signal.
253
254 ** The `mkstemp' builtin is added with the same GNU semantics as `maketemp',
255    based on the recommendation of POSIX to deprecate the POSIX semantics of
256    `maketemp' as inherently insecure.  In GNU mode (no -G supplied on the
257    command line), `maketemp' silently retains the secure GNU semantics, but
258    a future release of M4 will change this to emit a warning.  In
259    traditional mode (m4 -G), `maketemp' now uses the POSIX-mandated
260    insecure semantics, and issues a warning that you should convert your
261    script to use `mkstemp' instead.  Additionally, `mkstemp' and `maketemp'
262    are now well-defined even if the template argument does not end in six
263    `X' characters.
264
265 ** The manual has been improved, including a new section on a composite
266    macro `foreach'.
267
268 ** The `changecom' and `changequote' macros now treat an empty second
269    argument the same as if it were missing, rather than using the empty
270    string and making it impossible to end a comment or quote.
271
272 ** The `translit' macro now operates in linear instead of quadratic time,
273    and is now eight-bit clean.
274
275 ** The `-D', `-U', `-s', and `-t' command line options now take effect
276    after any files encountered earlier on the command line, rather than up
277    front, as is done in traditional implementations and required by POSIX.
278
279 * Noteworthy changes in Version 1.4.7 (2006-09-25) [stable]
280   Released by Eric Blake, based on CVS version 1.4.6a
281
282 ** Fix regression from 1.4.5 in handling a file that ends in a macro
283    expansion without arguments instead of a newline.
284
285 ** The define and pushdef macros now warn when the first argument is not
286    a string, rather than silently doing nothing.
287
288 ** Standard input can now be read more than once, as in 'm4 - file -', and
289    is not closed until all wrapped text is handled.  This makes a
290    difference when stdin is not a regular file, and also fixes bugs when
291    using the syscmd or esyscmd macros from wrapped text.
292
293 ** When standard input is a seekable file, the m4exit, syscmd, and esyscmd
294    macros now restore the current position to the next unread byte rather
295    than discarding an arbitrary amount of buffered data.
296
297 ** SysV command-line compatibility is no longer a goal of GNU M4; the
298    focus will be instead on POSIX compatibility.  This release continues to
299    support previous usage, but adds warnings in areas which will allow a
300    future version of GNU M4 to use its own extensions without being tied to
301    the SysV command line interface.
302
303 ** The no-op compatibility command line options -B, -N, -S, -T, and
304    --diversions may be withdrawn or assigned new meanings in future
305    releases, so they now issue a warning if used.
306
307 ** A new command line option -i replaces the compatibility -e as the
308    short spelling of --interactive, for consistency with other GNU tools; a
309    warning is issued if the old spelling is used, and it may be assigned
310    new meaning in future releases.
311
312 ** A new command line option --debugfile replaces the options -o and
313    --error-output as the preferred spelling.  The old options were
314    misleading in their names and inconsistent with other GNU tools; they
315    are still silently accepted, but no longer documented in --help, and may
316    be assigned new meanings in future releases.
317
318 * Noteworthy changes in Version 1.4.6 (2006-08-25) [stable]
319   Released by Eric Blake, based on CVS version 1.4.5a
320
321 ** Fix buffer overruns in regexp and patsubst macros when handed a trailing
322    backslash in the replacement text, or when handling \n substitutions
323    beyond the number of \(\) groups.
324
325 ** Fix memory leak in regexp, patsubst, and changeword macros.
326
327 ** The format macro now understands %F, %g, and %G.
328
329 ** When loading frozen files, m4 now exits with status 63 if version
330    mismatch is detected.
331
332 ** Fix bugs that occurred when invoked with stdout or stderr closed,
333    and detect write failures to stdout or to the target of the debugfile
334    macro.  In particular, the syscmd and esyscmd macros can no longer
335    interfere with the debug stream or diversions.
336
337 ** The m4exit macro now converts values outside the range 0-255 to 1.
338
339 ** It is now an error if a command-line input file ends in the middle of a
340    comment, matching the behavior of mid-string and mid-argument
341    collection.
342
343 ** The dnl macro now warns if end of file is encountered instead of a
344    newline.
345
346 ** The error message when end of file is encountered now uses the file and
347    line where the dangling construct started, rather than `NONE:0:'.
348
349 ** The debugmode and __file__ macros, and the -s/--synclines option, now
350    show what directory a file was found in when the -I/--include option or
351    M4PATH variable had an effect.
352
353 ** The changequote and changecom macros now work with 8-bit characters, and
354    quotes and comments that begin with `(' are properly recognized
355    following a word.
356
357 ** The new macro __program__ is added, which allows the input file to issue
358    an error message that resembles messages from m4.  Warning and error
359    messages have been reformatted to comply with GNU Coding Standards.
360
361 ** The errprint, m4wrap, and shift macros are now recognized only with
362    arguments.
363
364 ** The index, substr, translit, regexp, and patsubst macros now produce
365    output when given only one argument, but still warn about a missing
366    second argument.
367
368 ** The patsubst macro now reliably finds zero-length matches at the end
369    of a string.
370
371 * Noteworthy changes in Version 1.4.5 (2006-07-15) [stable]
372   Released by Eric Blake, based on CVS version 1.4.4c
373
374 ** Fix sysval on BeOS, OS/2, and other systems that store exit status
375    in the low-order byte.  Additionally, on Unix platforms, if syscmd was
376    terminated by a signal, sysval now displays the signal number shifted
377    left by eight bits, to match traditional m4 implementations.
378
379 ** The maketemp macro is no longer subject to platform limitations (such as
380    26 or 32 max files from a given template).
381
382 ** Frozen files now require that the first directive be V (version), to
383    better diagnose version mismatch.  Additionally, if the F directive
384    (builtin function) names an unknown builtin that existed in the m4 that
385    froze the file but not in the current m4 (for example, changeword), the
386    warning is deferred until an attempt is made to actually use the
387    builtin.  This allows downgrading from beta m4-1.4o to stable m4-1.4.5
388    without breaking autoconf.
389
390 ** The format and indir macros are now recognized only with arguments.
391
392 ** The eval macro no longer crashes on x86 architectures when dividing the
393    minimum integer by -1.
394
395 ** On systems with ecvt and fcvt, format no longer truncates trailing
396    zeroes on integers printed with %.0f.  On systems without these
397    functions, format is no longer subject to a buffer overflow that
398    permitted arbitrary code execution.
399
400 ** On native Windows builds, the macro __windows__ is provided instead of
401    __unix__.  Likewise, on OS/2 builds, the macro __os2__ is provided.
402    This allows input files to determine when syscmd might behave
403    differently.
404
405 ** Fix bug in 1.4.3 patch to use \n line-endings that did not work for
406    cygwin.
407
408 ** When given the empty string or 0, undivert is now documented as a no-op
409    rather than closing stdout, warning about a non-existent file, or trying
410    to read a directory as a file.
411
412 ** Many documentation improvements.  Also, the manual is now distributed
413    under FDL 1.2, rather than a stricter verbatim-only license.
414
415 ** Raise the -L (--nesting-limit) command line option limit from 250 to
416    1024.
417
418 ** The decr, incr, divert, m4exit, and substr macros treat an empty number
419    as 0, issue a warning, and expand as normal; rather than issuing an
420    error and expanding to the empty string.
421
422 ** The eval macro now treats an empty radix argument as 10, handles radix 1,
423    and treats the width argument as number of digits excluding the sign,
424    for compatibility with other m4 implementations.
425
426 ** The ifdef, divert, m4exit, substr, and translit macros now correctly
427    ignore extra arguments.
428
429 ** The popdef and undefine macros now correctly accept multiple arguments.
430
431 ** Although changeword is on its last leg, if enabled, it now reverts to the
432    default (faster) regexp when passed the empty string.
433
434 ** The regexp and substr macros now warn and ignore a trailing backslash in
435    the replacement, and warn on \n for n larger than the number of
436    sub-expressions in the regexp.
437
438 * Noteworthy changes in Version 1.4.4b (2006-06-17) [beta]
439   Released by Eric Blake, based on CVS version 1.4.4a
440
441 ** Fix a recursive push_string crashing bug, which affected changequote of
442    three or more characters on some compilers.
443
444 ** Use automake to fix build portability issues.
445
446 ** Fix a recursive m4wrap crashing bug.
447
448 ** Fix a 1 in 2**32 hash crashing bug.
449
450 ** Tracing a macro by name is now persistent, even if the macro is
451    subsequently undefined or redefined.  The traceon and traceoff macros no
452    longer warn about undefined symbols.  This solves a crash when using
453    indir on an undefined macro traced with the -t option, as well as an
454    incorrect result of ifdef.  Furthermore, tracing is no longer
455    transferred with builtins, solving the bug of "m4 -tm4_eval" failing to
456    give trace output on the input
457    "define(`m4_eval',defn(`eval'))m4_eval(1)".
458
459 ** Fix a crash when a macro is undefined while collecting its arguments, by
460    always using the definition that was in effect before argument
461    collection.  This behavior matches the C pre-processor, and means that
462    the sequence "define(`f',`1')f(define(`f',`2'))f" is now documented to
463    result in "12", rather than the previously undocumented "22".
464
465 ** Update the regex engine to fix several bugs.
466
467 ** Fix a potential crash on machines where char is signed.
468
469 * Noteworthy changes in Version 1.4.4 (Oct 2005) [stable]
470   Released by Gary V. Vaughan
471
472 ** ./configure --infodir=/usr/share/info now works correctly.
473
474 ** When any file named on the command line is missing exit with status 1.
475
476 * Noteworthy changes in Version 1.4.3 (Mar 2005) [stable]
477   Released by Gary V. Vaughan
478
479 ** DESTDIR installs now work correctly.
480
481 ** Don't segfault with uncompilable regexps to changeword().
482
483 ** Always use \n line-endings for frozen files (fixes a Windows bug).
484
485 ** Portability fix for systems lacking mkstemp(3).
486
487 ** Approximately 20% speed up in the common case of usage with autoconf.
488
489 ** Supported on QNX 6.3.
490
491 * Noteworthy changes in Version 1.4.2 (Aug 2004) [stable]
492   Released by Paul Eggert
493
494 ** No user visible changes; portability bug fixes only.
495
496 * Noteworthy changes in Version 1.4.1 (Jun 2004) [stable]
497   Released by Paul Eggert
498
499 ** maketemp now creates an empty file with the given name, instead of merely
500    returning the name of a nonexistent file.  This closes a security hole.
501
502 * Noteworthy changes in Version 1.4 (Oct 1994) [stable]
503   Released by Franc,ois Pinard
504
505 ** (No user visible changes)
506
507 \f
508 Version 1.3 - September 1994, by Franc,ois Pinard
509
510 * Diversions are created as needed.  Option `-N' is still accepted, but
511 otherwise ignored.  Users should use only negative diversion numbers,
512 instead of high positive numbers, for diverting to nowhere.
513
514 * Diversions should also work faster.  No temporary files will be needed
515 at all if all diversions taken altogether do not use more than 512K.
516
517 * Frozen state files may be produced with the `--freeze-state' (-F)
518 option and later brought back through the `--reload-state' (-R) option.
519 \f
520 Version 1.2 - July 1994, by Franc,ois Pinard
521
522 * In patsubst(STRING, REGEXP, REPLACEMENT), \& in REPLACEMENT has been
523 changed to represent this part of STRING matched by the whole REGEXP,
524 instead of the whole STRING as before.  \0 does the same, but emits a
525 diagnostic saying it will disappear in some subsequent release.
526
527 * eval(EXPR) emits a diagnostic if EXPR has suffixed crumb.  The same for
528 other numeric conversions in incr(), decr(), divert(), etc.
529
530 * `--fatal-warnings' (-E) stops execution at first warning.
531
532 * `--nesting-limit=LEVEL' (-L LEVEL) sets a limit to macro nesting.
533 It is initially fixed at 250.
534
535 * `--word-regexp=REGEXP' (-W REGEXP) modifies macro name syntax, like
536 does the new `changeword(REGEXP)' macro.  This feature is experimental,
537 tell me your opinions about it.  You do need --enable-changeword at
538 configure time to get these things.  Do *not* depend on them yet.
539
540 * Trace output format is scannable by GNU Emacs' next-error function.
541
542 * Stack overflow is detected and diagnosed on some capable systems.
543
544 * Various bugs have been corrected, m4 should be more portable.  See the
545 ChangeLog for details.
546 \f
547 Version 1.1 - November 1993, by Franc,ois Pinard
548
549 Changes which might affect existing GNU m4 scripts:
550
551 * Option `-V' has been removed, use `--version' instead.  `--version'
552 writes on standard output instead of standard error, and inhibits any
553 script execution.
554
555 * `--no-gnu-extensions' has been renamed `--traditional'.
556
557 * In `eval', `^' used to indicate exponentiation, use `**' instead.
558
559 * The automatic undiversion which takes place at end of all input is
560 forced into the main output stream.
561
562 Changes which are unlikely to affect existing scripts:
563
564 * `--help' prints an usage summary on standard output.  Script execution
565 is then inhibited.
566
567 * `--prefix-builtins' (-P) prefixes all builtin macros by `m4_'.
568
569 * Most builtin macros for which arguments are mandatory, called without
570 any arguments, are no more recognized as builtin macros: they are
571 consequently copied verbatim to the output stream.
572
573 * `define' and `pushdef' are usable with only one argument, they give
574 this argument an empty definition.
575
576 * `eval' new operators for binary representation handling: `^' for
577 exclusive-or, `~' for the bitwise negation, `<<' and `>>' for shifts.
578
579 * `eval' recognizes the notation 0bDIGITS for binary numbers and the
580 notation 0rRADIX:DIGITS for numbers in any radix from 1 to 36.
581 \f
582 Version 1.0.3 - December 1992, by Franc,ois Pinard
583
584 Changes for the user:
585
586 * `dnl' outputs a diagnostic if immediately followed by `('.  Usually,
587 `dnl' is followed by newline or whitespace.
588
589 * `ifelse' accepts without complaining the common idiom of having only
590 one argument.  This is useful for introducing long comments.
591
592 * `eval' always expresses values as signed, whatever the radix.
593
594 * M4OPTS environment variable is no longer obeyed.
595
596 * `--no-warnings' option is renamed `--silent'.
597
598 * Debug lines use a new format more compatible with GNU standards.
599
600 * Various bugs have been corrected.  See the ChangeLog for details.
601
602 Changes for the installer:
603
604 * GNU m4 now uses an Autoconf-generated configure script, and should be
605 more easily portable in many ways.  (Cray is not supported yet).
606
607 * `make check' has been made more portable, expect no errors.
608
609 Changes for the programmer:
610
611 * Sources have been fully reindented to comply with GNU standards, and
612 cleaned up in many ways.
613
614 * Sources have been protoized.  Non-ANSI compilers are automatically
615 detected, then sources are unprotoized on the fly before compilation.
616
617 * GNU m4 uses newer versions of obstack, regex, getopt, etc.
618 \f
619 Version 1.0 - October 1991, by Rene' Seindal
620
621 * Uses GNU configure, taken from the gdb distribution.
622
623 * Uses GNU getopt(), with long option names.
624
625 * The -Q/+quiet option is added, which suppresses warnings about missing
626 or superflous arguments to built-in macros.
627
628 * Added default options via the M4OPTS environment variable.
629
630 * Several minor bugs have been fixed.
631 \f
632 Version 0.99 - July 1991, by Rene' Seindal
633
634 * The builtins `incr' and `decr' are now implemented without use of
635 `eval'.
636
637 * The builtin `indir' is added, to allow for indirect macro calls
638 (allows use of "illegal" macro names).
639
640 * The debugging and tracing facilities has been enhanced considerably.
641 See the manual for details.
642
643 * The -tMACRO option is added, marks MACRO for tracing as soon as it
644 is defined.
645
646 * Builtins are traced after renaming iff they were before.
647
648 * Named files can now be undiverted.
649
650 * The -Nnum option can be used to increase the number of divertions
651 available.
652
653 * Calling changecom without arguments now disables all comment handling.
654
655 * A bug in `dnl' is fixed.
656
657 * A bug in the multi-character quoting code is fixed.
658
659 * Several typos in the manual has been corrected.  More probably persist.
660 \f
661 Version 0.75 - November 1990, by Rene' Seindal
662
663 * Implemented search path for include files (-I option and M4PATH
664 environment variable).
665
666 * Implemented builtin `format' for printf-like formatting.
667
668 * Implemented builtin `regexp' for searching for regular expressions.
669
670 * Implemented builtin `patsubst' for substitution with regular
671 expressions.
672
673 * Implemented builtin `esyscmd', which expands to a shell commands output.
674
675 * Implemented `__file__' and `__line__' for use in error messages.
676
677 * Implemented character ranges in `translit'.
678
679 * Implemented control over debugging output.
680
681 * Implemented multi-character quotes.
682
683 * Implemented multi-character comment delimiters.
684
685 * Changed predefined macro `gnu' to `__gnu__'.
686
687 * Changed predefined macro `unix' to `__unix__', when the -G option is
688 not used.  With -G, `unix' is still defined.
689
690 * Added program name to error messages.
691
692 * Fixed two missing null bytes bugs.
693 \f
694 Version 0.50 - January 1990, by Rene' Seindal
695
696 * Initial beta release.
697
698 ========================================================================
699
700 Local Variables:
701 mode: outline
702 fill-column: 75
703 End:
704
705 Copyright (C) 1992-1994, 2004-2011 Free Software Foundation, Inc.
706
707 Permission is granted to copy, distribute and/or modify this document
708 under the terms of the GNU Free Documentation License, Version 1.3 or
709 any later version published by the Free Software Foundation; with no
710 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
711 Texts.  A copy of the license is included in the ``GNU Free
712 Documentation License'' file as part of this distribution.