]>
Commit | Line | Data |
---|---|---|
efa0465c JB |
1 | --- automake-1.11.3/doc/automake.texi.orig 2012-02-01 11:40:23.000000000 +0100 |
2 | +++ automake-1.11.3/doc/automake.texi 2012-02-02 17:12:44.575874589 +0100 | |
3 | @@ -38,15 +38,11 @@ | |
4 | @end quotation | |
5 | @end copying | |
6 | ||
90b9a4ac | 7 | -@dircategory Software development |
02574d4c | 8 | +@dircategory Programming tools: |
9 | @direntry | |
7fc67891 | 10 | -* Automake: (automake). Making GNU standards-compliant Makefiles. |
02574d4c | 11 | -@end direntry |
12 | - | |
13 | -@dircategory Individual utilities | |
14 | -@direntry | |
efa0465c JB |
15 | -* aclocal-invocation: (automake)aclocal Invocation. Generating aclocal.m4. |
16 | -* automake-invocation: (automake)automake Invocation. Generating Makefile.in. | |
17 | +* Automake: (automake). Making GNU standards-compliant Makefiles | |
18 | +* aclocal-invocation: (automake)aclocal. Generating aclocal.m4 | |
19 | +* automake-invocation: (automake)automake. Generating Makefile.in | |
02574d4c | 20 | @end direntry |
21 | ||
1e718d93 | 22 | @titlepage |
efa0465c | 23 | @@ -99,7 +95,7 @@ |
7fc67891 JB |
24 | * Autotools Introduction:: An Introduction to the Autotools |
25 | * Generalities:: General ideas | |
26 | * Examples:: Some example packages | |
efa0465c | 27 | -* automake Invocation:: Creating a Makefile.in |
7fc67891 | 28 | +* automake:: Creating a Makefile.in |
09dffca2 | 29 | * configure:: Scanning configure.ac, using aclocal |
7fc67891 JB |
30 | * Directories:: Declaring subdirectories |
31 | * Programs:: Building programs and libraries | |
efa0465c | 32 | @@ -178,7 +174,7 @@ |
63096833 JB |
33 | |
34 | * Requirements:: Configuration requirements | |
35 | * Optional:: Other things Automake recognizes | |
efa0465c | 36 | -* aclocal Invocation:: Auto-generating aclocal.m4 |
63096833 | 37 | +* aclocal:: Auto-generating aclocal.m4 |
63096833 | 38 | * Macros:: Autoconf macros supplied with Automake |
7fc67891 JB |
39 | |
40 | Auto-generating aclocal.m4 | |
efa0465c JB |
41 | @@ -1673,7 +1669,7 @@ |
42 | When starting a new project, we suggest you start with such a simple | |
43 | @file{configure.ac}, and gradually add the other tests it requires. | |
44 | The command @command{autoscan} can also suggest a few of the tests | |
45 | -your package may need (@pxref{autoscan Invocation, , Using | |
46 | +your package may need (@pxref{autoscan, , Using | |
47 | @command{autoscan} to Create @file{configure.ac}, autoconf, The | |
48 | Autoconf Manual}). | |
49 | ||
50 | @@ -2506,7 +2502,7 @@ | |
51 | would be chosen by automake; they would be @file{false-true.o} and | |
09dffca2 | 52 | @file{true-true.o}. (The name of the object files rarely matters.) |
7fc67891 | 53 | |
efa0465c | 54 | -@node automake Invocation |
7fc67891 JB |
55 | +@node automake |
56 | @chapter Creating a @file{Makefile.in} | |
efa0465c JB |
57 | @c This node used to be named "Invoking automake". This @anchor |
58 | @c allows old links to still work. | |
59 | @@ -2756,7 +2752,7 @@ | |
02574d4c | 60 | @menu |
61 | * Requirements:: Configuration requirements | |
62 | * Optional:: Other things Automake recognizes | |
efa0465c | 63 | -* aclocal Invocation:: Auto-generating aclocal.m4 |
02574d4c | 64 | +* aclocal:: Auto-generating aclocal.m4 |
65 | * Macros:: Autoconf macros supplied with Automake | |
7fc67891 JB |
66 | @end menu |
67 | ||
efa0465c | 68 | @@ -3127,11 +3123,11 @@ |
a810cf6e | 69 | @code{m4_include} is seldom used by @file{configure.ac} authors, but |
1e718d93 | 70 | can appear in @file{aclocal.m4} when @command{aclocal} detects that |
efa0465c JB |
71 | some required macros come from files local to your package (as opposed to |
72 | -macros installed in a system-wide directory, @pxref{aclocal Invocation}). | |
73 | +macros installed in a system-wide directory, @pxref{aclocal}). | |
02574d4c | 74 | |
a810cf6e | 75 | @end ftable |
02574d4c | 76 | |
efa0465c | 77 | -@node aclocal Invocation |
1e718d93 | 78 | +@node aclocal |
02574d4c | 79 | @section Auto-generating aclocal.m4 |
efa0465c JB |
80 | @c This node used to be named "Invoking automake". This @anchor |
81 | @c allows old links to still work. | |
82 | @@ -3321,7 +3317,7 @@ | |
7fc67891 JB |
83 | |
84 | @vindex WARNINGS | |
85 | The environment variable @env{WARNINGS} is honored in the same | |
efa0465c | 86 | -way as it is for @command{automake} (@pxref{automake Invocation}). |
7fc67891 JB |
87 | +way as it is for @command{automake} (@pxref{automake}). |
88 | ||
89 | @end table | |
90 | ||
efa0465c | 91 | @@ -3629,12 +3625,12 @@ |
63096833 JB |
92 | |
93 | @code{ACLOCAL_AMFLAGS} contains options to pass to @command{aclocal} | |
ddc0c50e | 94 | when @file{aclocal.m4} is to be rebuilt by @command{make}. This line is |
63096833 JB |
95 | -also used by @command{autoreconf} (@pxref{autoreconf Invocation, , |
96 | +also used by @command{autoreconf} (@pxref{autoreconf, , | |
97 | Using @command{autoreconf} to Update @file{configure} Scripts, | |
98 | autoconf, The Autoconf Manual}) to run @command{aclocal} with suitable | |
99 | -options, or by @command{autopoint} (@pxref{autopoint Invocation, , | |
100 | +options, or by @command{autopoint} (@pxref{autopoint, , | |
101 | Invoking the @command{autopoint} Program, gettext, GNU gettext tools}) | |
102 | -and @command{gettextize} (@pxref{gettextize Invocation, , Invoking the | |
103 | +and @command{gettextize} (@pxref{gettextize, , Invoking the | |
104 | @command{gettextize} Program, gettext, GNU gettext tools}) to locate | |
105 | the place where Gettext's macros should be installed. So even if you | |
106 | do not really care about the rebuild rules, you should define | |
efa0465c JB |
107 | @@ -4092,7 +4088,7 @@ |
108 | Although using some of the following macros was required in past | |
109 | releases, you should not use any of them in new code. Running | |
110 | @command{autoupdate} should adjust your @file{configure.ac} | |
111 | -automatically (@pxref{autoupdate Invocation, , Using | |
112 | +automatically (@pxref{autoupdate, , Using | |
113 | @command{autoupdate} to Modernize @file{configure.ac}, autoconf, The | |
114 | Autoconf Manual}). | |
115 | ||
116 | @@ -5506,7 +5502,7 @@ | |
7fc67891 JB |
117 | passed to the tool invoked by @command{libtool} (hence the use of |
118 | @samp{@var{library}_LDFLAGS} for libtool linking flags). Generic | |
09dffca2 | 119 | options include @option{--tag=@var{tag}} and @option{--silent} |
7fc67891 JB |
120 | -(@pxref{Invoking libtool, , Invoking @command{libtool}, libtool, The |
121 | +(@pxref{libtool, , Invoking @command{libtool}, libtool, The | |
122 | Libtool Manual} for more options) should appear before the mode | |
123 | selection on the command line; in @file{Makefile.am}s they should | |
124 | be listed in the @samp{@var{library}_LIBTOOLFLAGS} variable. | |
efa0465c JB |
125 | @@ -5580,7 +5576,7 @@ |
126 | Since Automake 1.6, it has been decided that running | |
127 | @command{libtoolize} was none of Automake's business. Instead, that | |
128 | functionality has been moved into the @command{autoreconf} command | |
129 | -(@pxref{autoreconf Invocation, , Using @command{autoreconf}, autoconf, | |
130 | +(@pxref{autoreconf, , Using @command{autoreconf}, autoconf, | |
131 | The Autoconf Manual}). If you do not want to remember what to run and | |
132 | when, just learn the @command{autoreconf} command. Hopefully, | |
133 | replacing existing @file{bootstrap.sh} or @file{autogen.sh} scripts by | |
134 | @@ -9589,7 +9585,7 @@ | |
7fc67891 JB |
135 | @cindex Option, @option{-W@var{category}} |
136 | @cindex Option, @option{--warnings=@var{category}} | |
137 | These options behave exactly like their command-line counterpart | |
efa0465c | 138 | -(@pxref{automake Invocation}). This allows you to enable or disable some |
7fc67891 JB |
139 | +(@pxref{automake}). This allows you to enable or disable some |
140 | warning categories on a per-file basis. You can also setup some warnings | |
141 | for your entire project; for instance, try @samp{AM_INIT_AUTOMAKE([-Wall])} | |
142 | in your @file{configure.ac}. | |
efa0465c JB |
143 | @@ -10204,7 +10200,7 @@ |
144 | that is not required by POSIX 2008 but is widely supported in | |
145 | practice. The @option{silent-rules} option thus turns off warnings | |
146 | about recursive variable expansion, which are in turn enabled by | |
147 | -@option{-Wportability} (@pxref{automake Invocation}). On the rare | |
148 | +@option{-Wportability} (@pxref{automake}). On the rare | |
149 | @command{make} implementations that do not support nested variable | |
150 | expansion, whether rules are silent is always determined at configure | |
151 | time, and cannot be overridden at make time. Future versions of POSIX | |
152 | @@ -10431,7 +10427,7 @@ | |
7fc67891 JB |
153 | settings of Automake, or replace some of its rules. Overriding |
154 | Automake rules is often inadvisable, particularly in the topmost | |
155 | directory of a package with subdirectories. The @option{-Woverride} | |
efa0465c | 156 | -option (@pxref{automake Invocation}) comes in handy to catch overridden |
b46b2103 | 157 | +option (@pxref{automake}) comes in handy to catch overridden |
7fc67891 JB |
158 | definitions. |
159 | ||
b46b2103 | 160 | Note that Automake does not make any distinction between rules with |
efa0465c | 161 | @@ -10879,7 +10875,7 @@ |
7fc67891 JB |
162 | @end example |
163 | ||
164 | The use of @option{--force-missing} ensures that auxiliary tools will be | |
efa0465c | 165 | -overridden by new versions (@pxref{automake Invocation}). |
7fc67891 JB |
166 | +overridden by new versions (@pxref{automake}). |
167 | ||
168 | It is important to regenerate all these files each time Automake is | |
169 | upgraded, even between bug fixes releases. For instance, it is not |