Man Linux: Main Page and Category List

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)