README

   1 GNU `m4' is an implementation of the traditional Unix macro
   2 processor.  It is mostly SVR4 compatible, although it has some
   3 extensions (for example, handling more than 9 positional parameters
   4 to macros).  `m4' also has built-in functions for including files,
   5 running shell commands, doing arithmetic, etc.  Autoconf needs GNU
   6 `m4' for generating `configure' scripts, but not for running them.
   7
   8 GNU `m4' was originally written by Rene' Seindal, from Denmark.
   9 This release is considered stable.
  10
  11 If GNU `m4' is meant to serve GNU `autoconf', beware that `m4'
  12 should be fully installed *prior to* configuring `autoconf' itself.
  13 Likewise, if you intend on hacking GNU `m4' from git, the bootstrap
  14 process requires that you first install a released copy of GNU `m4'.
  15
  16 If you are just trying to build `m4' from a released tarball, you
  17 should not normally need to run `./bootstrap' or `autoreconf'; just go
  18 ahead and start with `./configure'.  If you are trying to build `m4'
  19 from git or CVS, more information can be found in the file HACKING,
  20 only found in a version control checkout.
  21
  22 In the subdirectory `examples' you will find various m4 files, ranging
  23 from trivial test files to rather advanced macros.  If you intend to
  24 use m4 seriously, you might find useful material down there.
  25
  26 See file `BACKLOG' for a summary of pending mail and articles.
  27 See file `COPYING' for copying conditions.  Note that M4 is distributed
  28 under the GNU Public License version 3 or later.  Some files in the
  29 distribution are copied from the gnulib project, and hence bear the
  30 designation version 2 or later because they are unmodified from gnulib;
  31 however, if you modify these files using M4 rather than gnulib as the
  32 source, you must update the license to be GPLv3 or later.
  33 See file `INSTALL' for compilation and installation instructions.
  34 See file `NEWS' for a list of major changes in the current release.
  35 See file `THANKS' for a list of contributors.
  36
  37 By using `./configure --enable-changeword', you get an experimental
  38 feature which allows for changing the syntax of what is a "word" in
  39 `m4'.  This feature will not be present in m4 2.0, but will be
  40 replaced by other new features which provide similar capability, so
  41 do not count on it.
  42
  43 Send bug reports to `bug-m4@gnu.org'.  A bug report is an adequate
  44 description of the problem: your input, what you expected, what you got,
  45 and why this is wrong.  Diffs are welcome, but they only describe a
  46 solution, from which the problem might be uneasy to infer.
  47
  48 ========================================================================
  49
  50 Copyright (C) 2000, 2005, 2006, 2007 Free Software Foundation, Inc.
  51
  52 Permission is granted to copy, distribute and/or modify this document
  53 under the terms of the GNU Free Documentation License, Version 1.2 or
  54 any later version published by the Free Software Foundation; with no
  55 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
  56 Texts.  A copy of the license is included in the ``GNU Free
  57 Documentation License'' file as part of this distribution.