]>
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 | |
3 | @@ -35,15 +35,11 @@ | |
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 |
7fc67891 JB |
23 | @@ -94,7 +90,7 @@ |
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 | |
32 | @@ -170,7 +166,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 | |
41 | @@ -2297,7 +2293,7 @@ | |
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 | |
50 | @@ -2520,7 +2516,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 | ||
59 | @@ -2854,13 +2850,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} |
7fc67891 JB |
75 | @@ -3028,7 +3023,7 @@ |
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 | ||
84 | @@ -3302,12 +3297,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 | |
7fc67891 JB |
100 | @@ -5128,7 +5123,7 @@ |
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. | |
109 | @@ -8587,7 +8582,7 @@ | |
110 | @cindex Option, @option{-W@var{category}} | |
111 | @cindex Option, @option{--warnings=@var{category}} | |
112 | These options behave exactly like their command-line counterpart | |
113 | -(@pxref{Invoking Automake}). This allows you to enable or disable some | |
114 | +(@pxref{automake}). This allows you to enable or disable some | |
115 | warning categories on a per-file basis. You can also setup some warnings | |
116 | for your entire project; for instance, try @samp{AM_INIT_AUTOMAKE([-Wall])} | |
117 | in your @file{configure.ac}. | |
118 | @@ -9080,7 +9075,7 @@ | |
119 | settings of Automake, or replace some of its rules. Overriding | |
120 | Automake rules is often inadvisable, particularly in the topmost | |
121 | directory of a package with subdirectories. The @option{-Woverride} | |
122 | -option (@pxref{Invoking Automake}) comes handy to catch overridden | |
123 | +option (@pxref{automake}) comes handy to catch overridden | |
124 | definitions. | |
125 | ||
126 | Note that Automake does not make any difference between rules with | |
127 | @@ -9518,7 +9513,7 @@ | |
128 | @end example | |
129 | ||
130 | The use of @option{--force-missing} ensures that auxiliary tools will be | |
131 | -overridden by new versions (@pxref{Invoking Automake}). | |
132 | +overridden by new versions (@pxref{automake}). | |
133 | ||
134 | It is important to regenerate all these files each time Automake is | |
135 | upgraded, even between bug fixes releases. For instance, it is not |