NAME

       automake - automatically create Makefile.in's from Makefile.am's

SYNOPSIS

       automake  [  -a  |  --add-missing  ] [ --amdir=DIR ] [ --build-dir=DIR ] [ -c | --copy ] [
       --cygnus ] [ -f | --force-missing ] [ --foreign ] [ --gnits ] [ --gnu ] [ --help ] [ -i  |
       --ignore-deps  ]  [  --include-deps  ]  [  --no-force  ] [ -o DIR ] [ --output-dir=DIR ] [
       --srcdir-name=DIR ] [ -v | --verbose ] [ --version ] [ --Werror | --Wno-error ]

DESCRIPTION

       To create all the Makefile.ins for a package, run the automake program in  the  top  level
       directory,   with  no  arguments.   automake  will  automatically  find  each  appropriate
       Makefile.am (by scanning configure.in) and generate the corresponding  Makefile.in.   Note
       that  automake has a rather simplistic view of what constitutes a package; it assumes that
       a package  has  only  one  configure.in,  at  the  top.   If  your  package  has  multiple
       configure.ins, then you must run automake in each directory holding a configure.in.

       You  can  optionally  give  automake  an argument; .am is appended to the argument and the
       result is used as the name of the input file.  This feature  is  generally  only  used  to
       automatically  rebuild  an out-of-date Makefile.in.  Note that automake must always be run
       from the topmost directory of a project, even if being used to regenerate the  Makefile.in
       in  some  subdirectory.   This  is  necessary because automake must scan configure.in, and
       because automake uses the knowledge that a Makefile.in is in a subdirectory to change  its
       behavior in some cases.

       automake accepts the following options:

       -a

       --add-missing
              Automake requires certain common files to exist in certain situations; for instance
              config.guess is required  if  configure.in  runs  AC_CANONICAL_HOST.   Automake  is
              distributed with several of these files; this option will cause the missing ones to
              be automatically added to the package, whenever possible.  In general  if  Automake
              tells  you  a  file is missing, try using this option. By default Automake tries to
              make a symbolic link pointing to its own copy of the  missing  file;  this  can  be
              changed with --copy.

       --libdir=DIR
              Look  for  Automake  data  files  in  directory  DIR instead of in the installation
              directory.  This is typically used for debugging.

       -c

       --copy When used with --add-missing, causes installed files to be copied.  The default  is
              to make a symbolic link.

       --cygnus
              Causes  the  generated Makefile.ins to follow Cygnus rules, instead of GNU or Gnits
              rules.

       -f

       --force-missing
              When used with --add-missing, causes standard files to  be  rebuilt  even  if  they
              already  exist in the source tree.  This involves removing the file from the source
              tree before creating the new symlink (or, with --copy, copying the new file).

       --foreign
              Set the global strictness to foreign.

       --gnits
              Set the global strictness to gnits.

       --gnu  Set the global strictness to gnu.  This is the default strictness.

       --help Print a summary of the command line options and exit.

       -i

       --ignore-deps
              This disables the dependency tracking feature.

       --include-deps
              This enables the dependency tracking feature. This feature is enabled  by  default.
              This  option  is  provided  for  historical reasons only and probably should not be
              used.

       --no-force
              Ordinarily automake creates  all  Makefile.ins  mentioned  in  configure.in.   This
              option  causes  it  to  only  update  those Makefile.ins which are out of date with
              respect to one of their dependents.

       -o DIR

       --output-dir=DIR
              Put the generated Makefile.in in the directory DIR.  Ordinarily each Makefile.in is
              created  in  the  directory  of the corresponding Makefile.am.  This option is used
              when making distributions.

       -v

       --verbose
              Cause Automake to print information about which files are being read or created.

       --version
              Print the version number of Automake and exit.

       --Werror

       --Wno-error
              --Werror will cause all warnings issued by automake to become errors. Errors affect
              the  exit  status  of  automake,  while warnings do not.  --Wno-error, the default,
              causes warning to be treated as warnings only.

SEE ALSO

       aclocal(1), and the Texinfo documentation for automake

AUTHORS

       Automake was written primarily by David Mackenzie and Tom Tromey.  This manpage written by
       Ben Pfaff <pfaffben@pilot.msu.edu> for the Debian GNU/Linux automake package.

                                           28 Jan 2002                                AUTOMAKE(1)