📄 autobook_36.html
字号:
<HTML><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><!-- Created on September, 12 2004 by texi2html 1.64 --><!-- Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author) Karl Berry <karl@freefriends.org> Olaf Bachmann <obachman@mathematik.uni-kl.de> and many others.Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>Send bugs and suggestions to <texi2html@mathematik.uni-kl.de> --><HEAD><TITLE>Autoconf, Automake, and Libtool: General Automake principles</TITLE><META NAME="description" CONTENT="Autoconf, Automake, and Libtool: General Automake principles"><META NAME="keywords" CONTENT="Autoconf, Automake, and Libtool: General Automake principles"><META NAME="resource-type" CONTENT="document"><META NAME="distribution" CONTENT="global"><META NAME="Generator" CONTENT="texi2html 1.64"><script language="Javascript"><!-- // Check the browser version. function checkVersion() { if (navigator.appVersion.charAt(0)>=3) return true; if (navigator.appVersion.charAt(0)>=4) return true; else return false; } if (checkVersion()) { homeon = new Image(); homeon.src = "homeon.png"; homeoff = new Image(); homeoff.src = "home.png"; tocon = new Image(); tocon.src = "tocon.png"; tocoff = new Image(); tocoff.src = "toc.png"; indexon = new Image(); indexon.src = "indexon.png"; indexoff = new Image(); indexoff.src = "index.png"; helpon = new Image(); helpon.src = "helpon.png"; helpoff = new Image(); helpoff.src = "help.png"; backon = new Image(); backon.src = "backon.png"; backoff = new Image(); backoff.src = "back.png"; forwardon = new Image(); forwardon.src = "forwardon.png"; forwardoff = new Image(); forwardoff.src = "forward.png"; prevon = new Image(); prevon.src = "prevon.png"; prevoff = new Image(); prevoff.src = "prev.png"; nexton = new Image(); nexton.src = "nexton.png"; nextoff = new Image(); nextoff.src = "next.png"; upon = new Image(); upon.src = "upon.png"; upoff = new Image(); upoff.src = "up.png"; } function img_act(imgName) { if (checkVersion()) { imgOn = eval(imgName + "on.src"); document [imgName].src = imgOn; } } function img_inact(imgName) { if (checkVersion()) { imgOff = eval(imgName + "off.src"); document [imgName].src = imgOff; } }// --></SCRIPT></HEAD><BODY LANG="EN" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#6688AA" VLINK="#336688" ALINK="#808080"><A NAME="SEC36"></A><TABLE BORDER=0 CELLPADDING=0 CELLSPACING=10><TR VALIGN="TOP"><TD ALIGN="MIDDLE" WIDTH=50 BGCOLOR="#e6e6e6"><TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_35.html#SEC35" onMouseover="img_act('prev')" onMouseout="img_inact('prev')"><IMG SRC="prev.png" BORDER="0" ALT="Back: Introducing GNU Automake" ALIGN="MIDDLE" NAME="prev"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_37.html#SEC37" onMouseover="img_act('next')" onMouseout="img_inact('next')"><IMG SRC="next.png" BORDER="0" ALT="Forward: Introduction to Primaries" ALIGN="MIDDLE" NAME="next"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"> <TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_35.html#SEC35" onMouseover="img_act('back')" onMouseout="img_inact('back')"><IMG SRC="back.png" BORDER="0" ALT="FastBack: Introducing GNU Automake" ALIGN="MIDDLE" NAME="back"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_35.html#SEC35" onMouseover="img_act('up')" onMouseout="img_inact('up')"><IMG SRC="up.png" BORDER="0" ALT="Up: Introducing GNU Automake" ALIGN="MIDDLE" NAME="up"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_43.html#SEC43" onMouseover="img_act('forward')" onMouseout="img_inact('forward')"><IMG SRC="forward.png" BORDER="0" ALT="FastForward: Bootstrapping" ALIGN="MIDDLE" NAME="forward"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook.html#SEC_Top" onMouseover="img_act('home')" onMouseout="img_inact('home')"><IMG SRC="home.png" BORDER="0" ALT="Top: Autoconf, Automake, and Libtool" ALIGN="MIDDLE" NAME="home"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_toc.html#SEC_Contents" onMouseover="img_act('toc')" onMouseout="img_inact('toc')"><IMG SRC="toc.png" BORDER="0" ALT="Contents: Table of Contents" ALIGN="MIDDLE" NAME="toc"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_285.html#SEC285" onMouseover="img_act('index')" onMouseout="img_inact('index')"><IMG SRC="index.png" BORDER="0" ALT="Index: Index" ALIGN="MIDDLE" NAME="index"></A></TD></TR><TR VALIGN="TOP" ALIGN="LEFT"><TD VALIGN="MIDDLE" ALIGN="LEFT"><A HREF="autobook_abt.html#SEC_About" onMouseover="img_act('help')" onMouseout="img_inact('help')"><IMG SRC="help.png" BORDER="0" ALT="About: About this document" ALIGN="MIDDLE" NAME="help"></A></TD></TR></TABLE></TD><TD ALIGN="LEFT"><H2> 7.1 General Automake principles </H2><!--docid::SEC36::--><P>Automake at its simplest turns a file called <TT>`Makefile.am'</TT> into aGNU-compliant <TT>`Makefile.in'</TT> for use with <TT>`configure'</TT>. Each<TT>`Makefile.am'</TT> is written according to <CODE>make</CODE> syntax; Automakerecognizes special macro and target names and generates code based onthese.</P><P>There are a few Automake rules which differ slightly from <CODE>make</CODE>rules:</P><P><UL><LI>Ordinary <CODE>make</CODE> comments are passed through to the output, butcomments beginning with <SAMP>`##'</SAMP> are Automake comments and are notpassed through.<P><LI>Automake supports <CODE>include</CODE> directives. These directives are notpassed through to the <TT>`Makefile.in'</TT>, but instead are processed by<CODE>automake</CODE> -- files included this way are treated as if theywere textually included in <TT>`Makefile.am'</TT> at that point. This canbe used to add boilerplate to each <TT>`Makefile.am'</TT> in a project via acentrally-maintained file. The filename to include can start with<SAMP>`$(top_srcdir)'</SAMP> to indicate that it should be found relative to thetop-most directory of the project; if it is a relative path or if itstarts with <SAMP>`$(srcdir)'</SAMP> then it is relative to the currentdirectory. For example, here is how you would reference boilerplatecode from the file <TT>`config/Make-rules'</TT> (where <TT>`config'</TT> is atop-level directory in the project):<P><TABLE width=100%><tr><td> </td><td class=example bgcolor=#6688aa><br><pre>include $(top_srcdir)/config/Make-rules</pre></td></tr></table></P><P><LI>Automake supports conditionals which are not passed directly through to<TT>`Makefile.in'</TT>. This feature is discussed in <A HREF="autobook_178.html#SEC178">19. Advanced GNU Automake Usage</A>.<P><LI>Automake supports macro assignment using <SAMP>`+='</SAMP>; these assignmentsare translated by Automake into ordinary <SAMP>`='</SAMP> assignments in<TT>`Makefile.in'</TT>.</UL><P>All macros and targets, including those which Automake does notrecognize, are passed through to the generated <TT>`Makefile.in'</TT> --this is a powerful extension mechanism. Sometimes Automake will definemacros or targets internally. If these are also defined in<TT>`Makefile.am'</TT> then the definition in <TT>`Makefile.am'</TT> takesprecedence. This feature provides an easy way to tailor specific partsof the output in small ways.</P><P>Note, however, that it is a mistake to override parts of the generatedcode that aren't documented (and thus `exported' by Automake).Overrides like this stand a good chance of not working with futureAutomake releases.</P><P>Automake also scans <TT>`configure.in'</TT>. Sometimes it uses theinformation it discovers to generate extra code, and sometimes toprovide extra error checking. Automake also turns every <CODE>AC_SUBST</CODE>into a <TT>`Makefile'</TT> variable. This is convenient in more ways thanone: not only does it mean that you can refer to these macros in<TT>`Makefile.am'</TT> without extra work, but, since Automake scans<TT>`configure.in'</TT> before it reads any <TT>`Makefile.am'</TT>, it alsomeans that special variables and overrides Automake recognizes can bedefined once in <TT>`configure.in'</TT>.</P><P><A NAME="Introduction to Primaries"></A></TR></TABLE><BR> <FONT SIZE="-1">This document was generatedby <I>Gary V. Vaughan</I> on <I>September, 12 2004</I>using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html"><I>texi2html</I></A></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -