NAME

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

SYNOPSIS

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

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.

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

       --build-dir=DIR
              Tell  Automake where the build directory is.  This option is used when including dependencies into
              a Makefile.in generated by make dist; it should not be used otherwise.

       -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.

       --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

       --include-deps
              Include  all automatically generated dependency information in the generated Makefile.in.  This is
              generally done when making a distribution.

       --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.

       --srcdir-name=DIR
              Tell  Automake the name of the source directory associated with the current build.  This option is
              used when including dependencies into a Makefile.in generated by makedist; it should not  be  used
              otherwise.

       -v

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

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

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.

                                                    Automake                                         AUTOMAKE(1)