NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

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

       --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 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 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    [Toc]    [Back]

       aclocal(1), and the Texinfo documentation for automake

AUTHORS    [Toc]    [Back]

       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)