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)