]>
Commit | Line | Data |
---|---|---|
7fc67891 JB |
1 | --- automake-1.10/doc/automake.texi.orig 2006-10-15 19:41:24.000000000 +0200 |
2 | +++ automake-1.10/doc/automake.texi 2006-10-26 23:02:36.354332500 +0200 | |
b46b2103 | 3 | @@ -38,15 +38,11 @@ |
7fc67891 JB |
4 | @c info Automake points to the Automake package's documentation |
5 | @c info automake points to the automake script's documentation | |
6 | @c (Autoconf has a similar setup.) | |
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 | |
90b9a4ac | 15 | -* aclocal: (automake)Invoking aclocal. Generating aclocal.m4. |
7fc67891 JB |
16 | -* automake: (automake)Invoking Automake. Generating Makefile.in. |
17 | +* Automake: (automake). Making GNU standards-compliant Makefiles | |
2cb2dad2 | 18 | +* aclocal: (automake)aclocal. Generating aclocal.m4 |
7fc67891 | 19 | +* automake: (automake)automake. Generating Makefile.in |
02574d4c | 20 | @end direntry |
21 | ||
1e718d93 | 22 | @titlepage |
b46b2103 | 23 | @@ -97,7 +93,7 @@ |
7fc67891 JB |
24 | * Autotools Introduction:: An Introduction to the Autotools |
25 | * Generalities:: General ideas | |
26 | * Examples:: Some example packages | |
27 | -* Invoking Automake:: Creating a Makefile.in | |
28 | +* automake:: Creating a Makefile.in | |
29 | * configure:: Scanning configure.ac or configure.in | |
30 | * Directories:: Declaring subdirectories | |
31 | * Programs:: Building programs and libraries | |
b46b2103 | 32 | @@ -174,7 +170,7 @@ |
63096833 JB |
33 | |
34 | * Requirements:: Configuration requirements | |
35 | * Optional:: Other things Automake recognizes | |
36 | -* Invoking aclocal:: Auto-generating aclocal.m4 | |
37 | +* aclocal:: Auto-generating aclocal.m4 | |
63096833 | 38 | * Macros:: Autoconf macros supplied with Automake |
7fc67891 JB |
39 | |
40 | Auto-generating aclocal.m4 | |
b46b2103 | 41 | @@ -2418,7 +2414,7 @@ |
7fc67891 JB |
42 | (The name of the object files rarely matters.) |
43 | ||
44 | ||
45 | -@node Invoking Automake | |
46 | +@node automake | |
47 | @chapter Creating a @file{Makefile.in} | |
48 | ||
49 | @cindex Multiple @file{configure.ac} files | |
b46b2103 | 50 | @@ -2652,7 +2648,7 @@ |
02574d4c | 51 | @menu |
52 | * Requirements:: Configuration requirements | |
53 | * Optional:: Other things Automake recognizes | |
54 | -* Invoking aclocal:: Auto-generating aclocal.m4 | |
55 | +* aclocal:: Auto-generating aclocal.m4 | |
56 | * Macros:: Autoconf macros supplied with Automake | |
7fc67891 JB |
57 | @end menu |
58 | ||
b46b2103 | 59 | @@ -3020,13 +3016,12 @@ |
a810cf6e | 60 | @code{m4_include} is seldom used by @file{configure.ac} authors, but |
1e718d93 | 61 | can appear in @file{aclocal.m4} when @command{aclocal} detects that |
a810cf6e JB |
62 | some required macros come from files local to your package (as opposed |
63 | -to macros installed in a system-wide directory, @pxref{Invoking | |
64 | -aclocal}). | |
65 | +to macros installed in a system-wide directory, @pxref{aclocal}). | |
02574d4c | 66 | |
a810cf6e | 67 | @end ftable |
02574d4c | 68 | |
69 | ||
1e718d93 JB |
70 | -@node Invoking aclocal |
71 | +@node aclocal | |
02574d4c | 72 | @section Auto-generating aclocal.m4 |
73 | ||
a810cf6e | 74 | @cindex Invoking @command{aclocal} |
b46b2103 | 75 | @@ -3194,7 +3189,7 @@ |
7fc67891 JB |
76 | |
77 | @vindex WARNINGS | |
78 | The environment variable @env{WARNINGS} is honored in the same | |
79 | -way as it is for @command{automake} (@pxref{Invoking Automake}). | |
80 | +way as it is for @command{automake} (@pxref{automake}). | |
81 | ||
82 | @end table | |
83 | ||
b46b2103 | 84 | @@ -3468,12 +3463,12 @@ |
63096833 JB |
85 | |
86 | @code{ACLOCAL_AMFLAGS} contains options to pass to @command{aclocal} | |
ddc0c50e | 87 | when @file{aclocal.m4} is to be rebuilt by @command{make}. This line is |
63096833 JB |
88 | -also used by @command{autoreconf} (@pxref{autoreconf Invocation, , |
89 | +also used by @command{autoreconf} (@pxref{autoreconf, , | |
90 | Using @command{autoreconf} to Update @file{configure} Scripts, | |
91 | autoconf, The Autoconf Manual}) to run @command{aclocal} with suitable | |
92 | -options, or by @command{autopoint} (@pxref{autopoint Invocation, , | |
93 | +options, or by @command{autopoint} (@pxref{autopoint, , | |
94 | Invoking the @command{autopoint} Program, gettext, GNU gettext tools}) | |
95 | -and @command{gettextize} (@pxref{gettextize Invocation, , Invoking the | |
96 | +and @command{gettextize} (@pxref{gettextize, , Invoking the | |
97 | @command{gettextize} Program, gettext, GNU gettext tools}) to locate | |
98 | the place where Gettext's macros should be installed. So even if you | |
99 | do not really care about the rebuild rules, you should define | |
b46b2103 | 100 | @@ -5314,7 +5309,7 @@ |
7fc67891 JB |
101 | passed to the tool invoked by @command{libtool} (hence the use of |
102 | @samp{@var{library}_LDFLAGS} for libtool linking flags). Generic | |
103 | options include @option{--tag=@var{TAG}} and @option{--silent} | |
104 | -(@pxref{Invoking libtool, , Invoking @command{libtool}, libtool, The | |
105 | +(@pxref{libtool, , Invoking @command{libtool}, libtool, The | |
106 | Libtool Manual} for more options) should appear before the mode | |
107 | selection on the command line; in @file{Makefile.am}s they should | |
108 | be listed in the @samp{@var{library}_LIBTOOLFLAGS} variable. | |
b46b2103 AM |
109 | @@ -9151,7 +9146,7 @@ |
110 | @command{make} implementations that do not support it. The | |
111 | @option{silent-rules} option turns off warnings about recursive variable | |
112 | expansion, which are in turn enabled by @option{-Wportability} | |
113 | -(@pxref{Invoking Automake}). | |
114 | +(@pxref{automake}). | |
115 | ||
116 | @vindex @code{AM_V_GEN} | |
117 | @vindex @code{AM_V_at} | |
118 | @@ -9292,7 +9287,7 @@ | |
7fc67891 JB |
119 | @cindex Option, @option{-W@var{category}} |
120 | @cindex Option, @option{--warnings=@var{category}} | |
121 | These options behave exactly like their command-line counterpart | |
122 | -(@pxref{Invoking Automake}). This allows you to enable or disable some | |
123 | +(@pxref{automake}). This allows you to enable or disable some | |
124 | warning categories on a per-file basis. You can also setup some warnings | |
125 | for your entire project; for instance, try @samp{AM_INIT_AUTOMAKE([-Wall])} | |
126 | in your @file{configure.ac}. | |
b46b2103 | 127 | @@ -9840,7 +9835,7 @@ |
7fc67891 JB |
128 | settings of Automake, or replace some of its rules. Overriding |
129 | Automake rules is often inadvisable, particularly in the topmost | |
130 | directory of a package with subdirectories. The @option{-Woverride} | |
b46b2103 AM |
131 | -option (@pxref{Invoking Automake}) comes in handy to catch overridden |
132 | +option (@pxref{automake}) comes in handy to catch overridden | |
7fc67891 JB |
133 | definitions. |
134 | ||
b46b2103 AM |
135 | Note that Automake does not make any distinction between rules with |
136 | @@ -10283,7 +10278,7 @@ | |
7fc67891 JB |
137 | @end example |
138 | ||
139 | The use of @option{--force-missing} ensures that auxiliary tools will be | |
140 | -overridden by new versions (@pxref{Invoking Automake}). | |
141 | +overridden by new versions (@pxref{automake}). | |
142 | ||
143 | It is important to regenerate all these files each time Automake is | |
144 | upgraded, even between bug fixes releases. For instance, it is not |