User:Maffblaster/Drafts/automake

From Gentoo Wiki
Jump to: navigation, search

automake is GNUs autobuild system. It is used to generate Makefile.in files from Makefile.am files.

Installation

USE flags

USE flags for sys-devel/automake Used to generate Makefile.in from Makefile.am

test Enable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently)

Emerge

root #emerge --ask sys-devel/automake

Configuration

Environment variables

Files

  • /etc/global_file_example - Global (system wide) configuration file.
  • ~/.local_file_example - Local (per user) configuration file.

Usage

Invocation

user $automake --help
Usage: /usr/bin/automake-1.15 [OPTION]... [Makefile]...

Generate Makefile.in for configure from Makefile.am.

Operation modes:

     --help               print this help, then exit
     --version            print version number, then exit
 -v, --verbose            verbosely list files processed
     --no-force           only update Makefile.in's that are out of date
 -W, --warnings=CATEGORY  report the warnings falling in CATEGORY

Dependency tracking:

 -i, --ignore-deps      disable dependency tracking code
     --include-deps     enable dependency tracking code

Flavors:

     --foreign          set strictness to foreign
     --gnits            set strictness to gnits
     --gnu              set strictness to gnu

Library files:

 -a, --add-missing      add missing standard files to package
     --libdir=DIR       set directory storing library files
     --print-libdir     print directory storing library files
 -c, --copy             with -a, copy missing files (default is symlink)
 -f, --force-missing    force update of standard files

Warning categories include:

 gnu                GNU coding standards (default in gnu and gnits modes)
 obsolete           obsolete features or constructions
 override           user redefinitions of Automake rules or variables
 portability        portability issues (default in gnu and gnits modes)
 extra-portability  extra portability issues related to obscure tools
 syntax             dubious syntactic constructs (default)
 unsupported        unsupported or incomplete features (default)
 all                all the warnings
 no-CATEGORY        turn off warnings in CATEGORY
 none               turn off all the warnings
 error              treat warnings as errors

Files automatically distributed if found (always):

 ABOUT-GNU           INSTALL             config.rpath        ltconfig
 ABOUT-NLS           NEWS                config.sub          ltmain.sh
 AUTHORS             README              depcomp             mdate-sh
 BACKLOG             THANKS              install-sh          missing
 COPYING             TODO                libversion.in       mkinstalldirs
 COPYING.DOC         ar-lib              ltcf-c.sh           py-compile
 COPYING.LESSER      compile             ltcf-cxx.sh         texinfo.tex
 COPYING.LIB         config.guess        ltcf-gcj.sh         ylwrap
 ChangeLog

Files automatically distributed if found (under certain conditions):

 acconfig.h          config.h.bot        configure           configure.in
 aclocal.m4          config.h.top        configure.ac        stamp-vti

Report bugs to <bug-automake@gnu.org>. GNU Automake home page: <http://www.gnu.org/software/automake/>.

General help using GNU software: <http://www.gnu.org/gethelp/>.

Troubleshooting

Issue 1

Removal

Unmerge

Warning
Inappropriately removing this package has the potential to break various parts of the system that depend on it. Remove this package with caution.
root #emerge --ask --depclean --verbose sys-devel/automake

See also

  • Build automation - This meta article provides a general overview of the build systems available in Gentoo.
  • SCons - A flexible, Python-based build system.

External resources

References

(Optional section. Remove this section if references are not used. This section is used to cite factual information. This information is found outside the Gentoo Wiki and used to back up truth claims. The actual references themselves still be littered throughout the main article.)