unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

AUTOMAKE(1)                 General Commands Manual                AUTOMAKE(1)



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 automati-
       cally  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  Make-
       file.in  in some subdirectory.  This is necessary because automake must
       scan configure.in, and because automake uses the knowledge that a Make-
       file.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 situ-
              ations; 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 auto-
              matically  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 strict-
              ness.

       --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 rea-
              sons only and probably should not be used.

       --no-force
              Ordinarily automake creates all Makefile.ins mentioned  in  con-
              figure.in.   This  option  causes  it to only update those Make-
              file.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  correspond-
              ing 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 warn-
              ings 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 <pfaffbenATpilot.edu>  for  the  Debian
       GNU/Linux automake package.



                                  28 Jan 2002                      AUTOMAKE(1)